From 96241f63d2a28449d36f7a4d2cf502d0786caf8d Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 9 Jul 2015 10:36:33 +0300 Subject: [PATCH 001/687] #100 Added test case for demonstrating the thread safety issues of a naive lazy loaded Singleton implementation. --- .../LazyLoadedSingletonThreadSafetyTest.java | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java new file mode 100644 index 000000000..f40d8a319 --- /dev/null +++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java @@ -0,0 +1,70 @@ +package com.iluwatar.singleton; + +import org.junit.Test; + +/** + * + * This test case demonstrates thread safety issues of lazy loaded Singleton implementation. + * + * Out of the box you should see the test output something like the following: + * + * Thread=Thread-4 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e + * Thread=Thread-2 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e + * Thread=Thread-0 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e + * Thread=Thread-0 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e + * Thread=Thread-3 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e + * Thread=Thread-1 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@60f330b0 + * Thread=Thread-2 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e + * + * By changing the method signature of LazyLoadedIvoryTower#getInstance from + * public static LazyLoadedIvoryTower getInstance() + * into + * public synchronized static LazyLoadedIvoryTower getInstance() + * you should see the test output change to something like the following: + * + * Thread=Thread-4 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 + * Thread=Thread-4 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 + * Thread=Thread-0 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 + * Thread=Thread-3 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 + * Thread=Thread-2 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 + * Thread=Thread-1 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 + * + */ +public class LazyLoadedSingletonThreadSafetyTest { + + private static final int NUM_THREADS = 5; + + @Test + public void test() { + SingletonThread runnable = new SingletonThread(); + for (int j=0; j Date: Mon, 13 Jul 2015 15:19:16 +0300 Subject: [PATCH 004/687] #91 Added skeleton for naked-objects example using Apache Isis SimpleApp archetype --- .gitignore | 2 +- naked-objects/.gitattributes | 51 +++ naked-objects/.gitignore | 42 ++ naked-objects/dom/log4j.properties | 41 ++ naked-objects/dom/pom.xml | 194 +++++++++ .../src/main/java/META-INF/persistence.xml | 26 ++ .../dom/app/homepage/HomePageService.java | 51 +++ .../dom/app/homepage/HomePageViewModel.java | 50 +++ .../homepage/HomePageViewModel.layout.json | 43 ++ .../dom/app/homepage/HomePageViewModel.png | Bin 0 -> 456 bytes .../dom/modules/simple/SimpleObject.java | 149 +++++++ .../modules/simple/SimpleObject.layout.json | 56 +++ .../dom/modules/simple/SimpleObject.png | Bin 0 -> 653 bytes .../dom/modules/simple/SimpleObjects.java | 107 +++++ .../dom/modules/simple/SimpleObjectTest.java | 49 +++ .../dom/modules/simple/SimpleObjectsTest.java | 104 +++++ naked-objects/fixture/pom.xml | 38 ++ .../fixture/DomainAppFixturesService.java | 76 ++++ .../modules/simple/SimpleObjectCreate.java | 71 ++++ .../modules/simple/SimpleObjectsTearDown.java | 36 ++ .../scenarios/RecreateSimpleObjects.java | 92 ++++ naked-objects/integtests/.gitignore | 1 + naked-objects/integtests/logging.properties | 111 +++++ naked-objects/integtests/pom.xml | 128 ++++++ .../bootstrap/SimpleAppSystemInitializer.java | 54 +++ .../specglue/BootstrappingGlue.java | 41 ++ .../specglue/CatalogOfFixturesGlue.java | 31 ++ .../modules/simple/SimpleObjectGlue.java | 50 +++ .../domainapp/integtests/specs/RunSpecs.java | 39 ++ .../SimpleObjectSpec_listAllAndCreate.feature | 26 ++ .../integtests/tests/SimpleAppIntegTest.java | 39 ++ .../modules/simple/SimpleObjectIntegTest.java | 121 ++++++ .../simple/SimpleObjectsIntegTest.java | 143 +++++++ naked-objects/pom.xml | 400 ++++++++++++++++++ .../webapp/ide/eclipse/launch/.gitignore | 8 + .../webapp/ide/intellij/launch/README.txt | 2 + .../intellij/launch/SimpleApp_PROTOTYPE.xml | 28 ++ .../launch/SimpleApp__enhance_only_.xml | 22 + naked-objects/webapp/lib/.gitignore | 5 + naked-objects/webapp/pom.xml | 352 +++++++++++++++ .../domainapp/webapp/SimpleApplication.java | 153 +++++++ .../src/main/jettyconsole/isis-banner.pdn | Bin 0 -> 69658 bytes .../src/main/jettyconsole/isis-banner.png | Bin 0 -> 30776 bytes .../resources/domainapp/webapp/welcome.html | 35 ++ .../src/main/webapp/WEB-INF/isis.properties | 300 +++++++++++++ .../main/webapp/WEB-INF/logging.properties | 187 ++++++++ .../main/webapp/WEB-INF/persistor.properties | 128 ++++++ .../WEB-INF/persistor_datanucleus.properties | 93 ++++ .../webapp/src/main/webapp/WEB-INF/shiro.ini | 93 ++++ .../main/webapp/WEB-INF/translations-en.po | 213 ++++++++++ .../main/webapp/WEB-INF/translations-es.po | 208 +++++++++ .../main/webapp/WEB-INF/translations-nl.po | 208 +++++++++ .../src/main/webapp/WEB-INF/translations.po | 213 ++++++++++ .../WEB-INF/viewer_restfulobjects.properties | 66 +++ .../webapp/WEB-INF/viewer_wicket.properties | 91 ++++ .../webapp/src/main/webapp/WEB-INF/web.xml | 309 ++++++++++++++ .../main/webapp/about/images/isis-logo.png | Bin 0 -> 14160 bytes .../webapp/src/main/webapp/about/index.html | 102 +++++ .../src/main/webapp/css/application.css | 19 + .../src/main/webapp/images/spinning-icon.gif | Bin 0 -> 5266 bytes .../src/main/webapp/scripts/application.js | 3 + pom.xml | 10 +- 62 files changed, 5304 insertions(+), 6 deletions(-) create mode 100644 naked-objects/.gitattributes create mode 100644 naked-objects/.gitignore create mode 100644 naked-objects/dom/log4j.properties create mode 100644 naked-objects/dom/pom.xml create mode 100644 naked-objects/dom/src/main/java/META-INF/persistence.xml create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.layout.json create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.png create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.layout.json create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.png create mode 100644 naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java create mode 100644 naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java create mode 100644 naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java create mode 100644 naked-objects/fixture/pom.xml create mode 100644 naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java create mode 100644 naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java create mode 100644 naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java create mode 100644 naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java create mode 100644 naked-objects/integtests/.gitignore create mode 100644 naked-objects/integtests/logging.properties create mode 100644 naked-objects/integtests/pom.xml create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/specs/modules/simple/SimpleObjectSpec_listAllAndCreate.feature create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java create mode 100644 naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java create mode 100644 naked-objects/pom.xml create mode 100644 naked-objects/webapp/ide/eclipse/launch/.gitignore create mode 100644 naked-objects/webapp/ide/intellij/launch/README.txt create mode 100644 naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml create mode 100644 naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml create mode 100644 naked-objects/webapp/lib/.gitignore create mode 100644 naked-objects/webapp/pom.xml create mode 100644 naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java create mode 100644 naked-objects/webapp/src/main/jettyconsole/isis-banner.pdn create mode 100644 naked-objects/webapp/src/main/jettyconsole/isis-banner.png create mode 100644 naked-objects/webapp/src/main/resources/domainapp/webapp/welcome.html create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/logging.properties create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/shiro.ini create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/translations-en.po create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/translations-es.po create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/translations-nl.po create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/translations.po create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties create mode 100644 naked-objects/webapp/src/main/webapp/WEB-INF/web.xml create mode 100644 naked-objects/webapp/src/main/webapp/about/images/isis-logo.png create mode 100644 naked-objects/webapp/src/main/webapp/about/index.html create mode 100644 naked-objects/webapp/src/main/webapp/css/application.css create mode 100644 naked-objects/webapp/src/main/webapp/images/spinning-icon.gif create mode 100644 naked-objects/webapp/src/main/webapp/scripts/application.js diff --git a/.gitignore b/.gitignore index bd55eacaf..5d2cd77e1 100644 --- a/.gitignore +++ b/.gitignore @@ -11,4 +11,4 @@ target .idea *.iml *.swp - +datanucleus.log \ No newline at end of file diff --git a/naked-objects/.gitattributes b/naked-objects/.gitattributes new file mode 100644 index 000000000..b1eafb692 --- /dev/null +++ b/naked-objects/.gitattributes @@ -0,0 +1,51 @@ +# +# +# 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 + diff --git a/naked-objects/.gitignore b/naked-objects/.gitignore new file mode 100644 index 000000000..0558e54af --- /dev/null +++ b/naked-objects/.gitignore @@ -0,0 +1,42 @@ +*~ +*.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 diff --git a/naked-objects/dom/log4j.properties b/naked-objects/dom/log4j.properties new file mode 100644 index 000000000..ca165acc7 --- /dev/null +++ b/naked-objects/dom/log4j.properties @@ -0,0 +1,41 @@ +# 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. + +# LOG4J Configuration +# =================== + +# Basic logging goes to "datanucleus.log" +log4j.appender.A1=org.apache.log4j.FileAppender +log4j.appender.A1.File=datanucleus.log +log4j.appender.A1.layout=org.apache.log4j.PatternLayout +log4j.appender.A1.layout.ConversionPattern=%d{HH:mm:ss,SSS} (%t) %-5p [%c] - %m%n +#log4j.appender.A1.Threshold=INFO + +# Categories +# Each category can be set to a "level", and to direct to an appender + +# Default to DEBUG level for all DataNucleus categories +log4j.logger.DataNucleus = DEBUG, A1 + +log4j.category.com.mchange.v2.c3p0=INFO, A1 +log4j.category.com.mchange.v2.resourcepool=INFO, A1 +log4j.category.org.logicalcobwebs.proxool=INFO,A1 + + +# Hbase libs logging +log4j.category.org.apache.hadoop=INFO,A1 +log4j.category.org.apache.zookeeper=INFO,A1 \ No newline at end of file diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml new file mode 100644 index 000000000..8d3d866c6 --- /dev/null +++ b/naked-objects/dom/pom.xml @@ -0,0 +1,194 @@ + + + 4.0.0 + + + com.iluwatar + naked-objects + 1.0-SNAPSHOT + + + naked-objects-dom + Simple App 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.0-release + + + + + + + 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 + + + + + + + + + + diff --git a/naked-objects/dom/src/main/java/META-INF/persistence.xml b/naked-objects/dom/src/main/java/META-INF/persistence.xml new file mode 100644 index 000000000..8824aa1ac --- /dev/null +++ b/naked-objects/dom/src/main/java/META-INF/persistence.xml @@ -0,0 +1,26 @@ + + + + + + + diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java new file mode 100644 index 000000000..641c39ae7 --- /dev/null +++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java @@ -0,0 +1,51 @@ +/* + * 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; + +@DomainService( + nature = NatureOfService.VIEW_CONTRIBUTIONS_ONLY // trick to suppress the actions from the top-level menu +) +public class HomePageService { + + //region > homePage (action) + + @Action( + semantics = SemanticsOf.SAFE + ) + @HomePage + public HomePageViewModel homePage() { + return container.injectServicesInto(new HomePageViewModel()); + } + + //endregion + + //region > injected services + + @javax.inject.Inject + DomainObjectContainer container; + + //endregion +} diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java new file mode 100644 index 000000000..83015d057 --- /dev/null +++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java @@ -0,0 +1,50 @@ +/* + * 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; + +@ViewModel +public class HomePageViewModel { + + //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(); + } + //endregion + + //region > injected services + + @javax.inject.Inject + SimpleObjects simpleObjects; + + //endregion +} diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.layout.json b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.layout.json new file mode 100644 index 000000000..34f78e0c3 --- /dev/null +++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.layout.json @@ -0,0 +1,43 @@ +/** + * 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": {} +} \ No newline at end of file diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.png b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.png new file mode 100644 index 0000000000000000000000000000000000000000..cb03785f714e60f93499a4e9136339aab1b07a23 GIT binary patch literal 456 zcmV;(0XP1MP)Uv68@LBPf$L12Bj6Fx+;`w0%>S7_6hH-Efc;Qu4qPN4Zh@QV`Z4et z&l>{J6t{XQi0S}M@wcG9mvN#hKuTQiSVOj^AgTeB#O)QNAgTbA#I+DLw761Ee2iU$ zUEH@F070*G$UFQbqEAEAG0Sp!QKy(6(74L#*g;kt{wZwZt7(i`t zH-rGD5_dreKw)B$s%*F4@otyc=z3kswdh;`3X3gZD)EvND*-6Y^we6R8eLDWc(u7r z8_t29f;X`fn!7A@L9Wgj@RYfE8oq!^@5dnIJTZWZo;coYD@>yQ$VuCvN~N9w!L9*l zJ3ag*fQ2pg*nthe#({t1z}Os6qb0lG0l0Lup^jLkB;0k>xC8XXyp{uYe$&1%&`Rsykl*L6`8At^Ozg0000= 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 { + + + //region > identificatiom + public TranslatableString title() { + return TranslatableString.tr("Object: {name}", "name", getName()); + } + //endregion + + //region > name (property) + + private String name; + + @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) + + 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 + + +} diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.layout.json b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.layout.json new file mode 100644 index 000000000..3d5e23f7c --- /dev/null +++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.layout.json @@ -0,0 +1,56 @@ +/** + * 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": {} +} \ No newline at end of file diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.png b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.png new file mode 100644 index 0000000000000000000000000000000000000000..0bd6f575646cc5b68b3d86c59c61876f84351722 GIT binary patch literal 653 zcmV;80&@L{P)TeaDl*`3}}y6WnFwrAe! z*FQ5ik$<+yNc=5be-qtj41skKxl`Z`5xI|$7()QSH3j7}B$_Qsz(;SOAr+zoEc#DH zpVJgHs}LdJqd!psN6}h{5b)72De$X^gj8rHkVb#31b7dr&`KbU{zD1Oi%3X?J_1CH zv@0Tl+`9@$?k#%j0O<~n~zr^w+?>@8L3-7 zLx9a*227AQjp|H9N~4$2e4u+S4%l-Ffs{EBA|Z^)xiKHGU&qCiB$eQhLQ;y&l=LY8 z%pUG3i3n(E4d53J98$9sn8Eh1NMykQPP-r_L1o*ti>g67chbmhvs@cOf+DjbVgphV zF%SMMA`~g};>SvJfPx_%%jy{+k%E)+v~@cv@Z?ewtJ=dult9HtbtLjEc&-N0&3*Aq zQ~4@P{A{UqRNp9O=6^Lj;BF5aKdpH|SsPH3E!Ns@?8)Ei=G; n?H);Ya24xV-yDd5Hm&&vexQ+2Y+_lE00000NkvXXu0mjfQKuRg literal 0 HcmV?d00001 diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java new file mode 100644 index 000000000..0634dd16a --- /dev/null +++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java @@ -0,0 +1,107 @@ +/* + * 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; + +@DomainService(repositoryFor = SimpleObject.class) +@DomainServiceLayout(menuOrder = "10") +public class SimpleObjects { + + //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 + + //region > create (action) + public static class CreateDomainEvent extends ActionDomainEvent { + public CreateDomainEvent(final SimpleObjects source, final Identifier identifier, final Object... arguments) { + super(source, identifier, arguments); + } + } + + @Action( + domainEvent = CreateDomainEvent.class + ) + @MemberOrder(sequence = "3") + public SimpleObject create( + final @ParameterLayout(named="Name") String name) { + final SimpleObject obj = container.newTransientInstance(SimpleObject.class); + obj.setName(name); + container.persistIfNotAlready(obj); + return obj; + } + + //endregion + + //region > injected services + + @javax.inject.Inject + DomainObjectContainer container; + + //endregion +} diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java new file mode 100644 index 000000000..e29b3f246 --- /dev/null +++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java @@ -0,0 +1,49 @@ +/** + * 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 org.junit.Before; +import org.junit.Test; + +import static org.assertj.core.api.Assertions.assertThat; + +public class SimpleObjectTest { + + SimpleObject simpleObject; + + @Before + public void setUp() throws Exception { + simpleObject = new SimpleObject(); + } + + 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); + } + } + +} diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java new file mode 100644 index 000000000..a41d25ad9 --- /dev/null +++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java @@ -0,0 +1,104 @@ +/** + * 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 com.google.common.collect.Lists; + +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; + +import org.apache.isis.applib.DomainObjectContainer; +import org.apache.isis.core.unittestsupport.jmocking.JUnitRuleMockery2; +import org.apache.isis.core.unittestsupport.jmocking.JUnitRuleMockery2.Mode; + +import static org.assertj.core.api.Assertions.assertThat; + +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; + } + + 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"); + } + + } + + 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); + } + } +} diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml new file mode 100644 index 000000000..63ee62d1a --- /dev/null +++ b/naked-objects/fixture/pom.xml @@ -0,0 +1,38 @@ + + + 4.0.0 + + + com.iluwatar + naked-objects + 1.0-SNAPSHOT + + + naked-objects-fixture + Simple App Fixtures + + + + ${project.groupId} + naked-objects-dom + + + + diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java new file mode 100644 index 000000000..751bad316 --- /dev/null +++ b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java @@ -0,0 +1,76 @@ +/* + * 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 java.util.List; + +import org.apache.isis.applib.annotation.Action; +import org.apache.isis.applib.annotation.ActionLayout; +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.RestrictTo; +import org.apache.isis.applib.fixturescripts.FixtureResult; +import org.apache.isis.applib.fixturescripts.FixtureScript; +import org.apache.isis.applib.fixturescripts.FixtureScripts; + +import domainapp.fixture.scenarios.RecreateSimpleObjects; + +/** + * Enables fixtures to be installed from the application. + */ +@DomainService +@DomainServiceLayout( + named="Prototyping", + menuBar = DomainServiceLayout.MenuBar.SECONDARY, + menuOrder = "500" +) +public class DomainAppFixturesService extends FixtureScripts { + + public DomainAppFixturesService() { + super(DomainAppFixturesService.class.getPackage().getName(), MultipleExecutionStrategy.EXECUTE); + } + + @Override + public FixtureScript default0RunFixtureScript() { + return findFixtureScriptFor(RecreateSimpleObjects.class); + } + + @Override + public List choices0RunFixtureScript() { + return super.choices0RunFixtureScript(); + } + + + // ////////////////////////////////////// + + @Action( + restrictTo = RestrictTo.PROTOTYPING + ) + @ActionLayout( + cssClassFa="fa fa-refresh" + ) + @MemberOrder(sequence="20") + public Object recreateObjectsAndReturnFirst() { + final List run = findFixtureScriptFor(RecreateSimpleObjects.class).run(null); + return run.get(0).getObject(); + } + + +} diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java new file mode 100644 index 000000000..926217d09 --- /dev/null +++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java @@ -0,0 +1,71 @@ +/* + * 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; + +public class SimpleObjectCreate extends FixtureScript { + + //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; + } + //endregion + + + //region > simpleObject (output) + private SimpleObject simpleObject; + + /** + * The created simple object (output). + * @return + */ + public SimpleObject getSimpleObject() { + return simpleObject; + } + //endregion + + @Override + protected void execute(final ExecutionContext ec) { + + String name = checkParam("name", ec, String.class); + + this.simpleObject = wrap(simpleObjects).create(name); + + // also make available to UI + ec.addResult(this, simpleObject); + } + + @javax.inject.Inject + private SimpleObjects simpleObjects; + +} diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java new file mode 100644 index 000000000..8767b6fb8 --- /dev/null +++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java @@ -0,0 +1,36 @@ +/* + * 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; + +public class SimpleObjectsTearDown extends FixtureScript { + + @Override + protected void execute(ExecutionContext executionContext) { + isisJdoSupport.executeUpdate("delete from simple.\"SimpleObject\""); + } + + + @javax.inject.Inject + private IsisJdoSupport isisJdoSupport; + +} diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java b/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java new file mode 100644 index 000000000..072769e29 --- /dev/null +++ b/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java @@ -0,0 +1,92 @@ +/* + * 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; + +public class RecreateSimpleObjects extends FixtureScript { + + public final List NAMES = Collections.unmodifiableList(Arrays.asList( + "Foo", "Bar", "Baz", "Frodo", "Froyo", "Fizz", "Bip", "Bop", "Bang", "Boo")); + + public RecreateSimpleObjects() { + withDiscoverability(Discoverability.DISCOVERABLE); + } + + //region > number (optional input) + private Integer number; + + /** + * 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; + } + //endregion + + //region > simpleObjects (output) + private final List simpleObjects = Lists.newArrayList(); + + /** + * The simpleobjects created by this fixture (output). + */ + public List getSimpleObjects() { + return simpleObjects; + } + //endregion + + @Override + protected void execute(final ExecutionContext ec) { + + // defaults + final int number = defaultParam("number", ec, 3); + + // validate + if(number < 0 || number > 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 < number; i++) { + final SimpleObjectCreate fs = new SimpleObjectCreate().setName(NAMES.get(i)); + ec.executeChild(this, fs.getName(), fs); + simpleObjects.add(fs.getSimpleObject()); + } + } +} diff --git a/naked-objects/integtests/.gitignore b/naked-objects/integtests/.gitignore new file mode 100644 index 000000000..88dfbbca9 --- /dev/null +++ b/naked-objects/integtests/.gitignore @@ -0,0 +1 @@ +/translations.pot diff --git a/naked-objects/integtests/logging.properties b/naked-objects/integtests/logging.properties new file mode 100644 index 000000000..b55249569 --- /dev/null +++ b/naked-objects/integtests/logging.properties @@ -0,0 +1,111 @@ +# 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. + + +# +# Isis uses log4j is used to provide system logging +# +log4j.rootCategory=INFO, Console + +# The console appender +log4j.appender.Console=org.apache.log4j.ConsoleAppender +log4j.appender.Console.target=System.out +log4j.appender.Console.layout=org.apache.log4j.PatternLayout +log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} [%-20c{1} %-10t %-5p] %m%n + +log4j.appender.File=org.apache.log4j.RollingFileAppender +log4j.appender.File.file=isis.log +log4j.appender.File.append=false +log4j.appender.File.layout=org.apache.log4j.PatternLayout +log4j.appender.File.layout.ConversionPattern=%d [%-20c{1} %-10t %-5p] %m%n + +log4j.appender.translations-po=org.apache.log4j.FileAppender +log4j.appender.translations-po.File=./translations.pot +log4j.appender.translations-po.Append=false +log4j.appender.translations-po.layout=org.apache.log4j.PatternLayout +log4j.appender.translations-po.layout.ConversionPattern=%m%n + +! turn on the internal log4j debugging flag so we can see what it is doing +#log4j.debug=true + + +# DataNucleus +# the first two log the DML and DDL (if set to DEBUG) +log4j.logger.DataNucleus.Datastore.Native=WARN, Console +log4j.logger.DataNucleus.Datastore.Schema=DEBUG, Console +# the remainder can probably be left to WARN +log4j.logger.DataNucleus.Persistence=WARN, Console +log4j.logger.DataNucleus.Transaction=WARN, Console +log4j.logger.DataNucleus.Connection=WARN, Console +log4j.logger.DataNucleus.Query=WARN, Console +log4j.logger.DataNucleus.Cache=WARN, Console +log4j.logger.DataNucleus.MetaData=WARN, Console +log4j.logger.DataNucleus.Datastore=WARN, Console +log4j.logger.DataNucleus.Datastore.Persist=WARN, Console +log4j.logger.DataNucleus.Datastore.Retrieve=WARN, Console +log4j.logger.DataNucleus.General=WARN, Console +log4j.logger.DataNucleus.Lifecycle=WARN, Console +log4j.logger.DataNucleus.ValueGeneration=WARN, Console +log4j.logger.DataNucleus.Enhancer=WARN, Console +log4j.logger.DataNucleus.SchemaTool=ERROR, Console +log4j.logger.DataNucleus.JDO=WARN, Console +log4j.logger.DataNucleus.JPA=ERROR, Console +log4j.logger.DataNucleus.JCA=WARN, Console +log4j.logger.DataNucleus.IDE=ERROR, Console + +log4j.additivity.DataNucleus.Datastore.Native=false +log4j.additivity.DataNucleus.Datastore.Schema=false +log4j.additivity.DataNucleus.Datastore.Persistence=false +log4j.additivity.DataNucleus.Datastore.Transaction=false +log4j.additivity.DataNucleus.Datastore.Connection=false +log4j.additivity.DataNucleus.Datastore.Query=false +log4j.additivity.DataNucleus.Datastore.Cache=false +log4j.additivity.DataNucleus.Datastore.MetaData=false +log4j.additivity.DataNucleus.Datastore.Datastore=false +log4j.additivity.DataNucleus.Datastore.Datastore.Persist=false +log4j.additivity.DataNucleus.Datastore.Datastore.Retrieve=false +log4j.additivity.DataNucleus.Datastore.General=false +log4j.additivity.DataNucleus.Datastore.Lifecycle=false +log4j.additivity.DataNucleus.Datastore.ValueGeneration=false +log4j.additivity.DataNucleus.Datastore.Enhancer=false +log4j.additivity.DataNucleus.Datastore.SchemaTool=false +log4j.additivity.DataNucleus.Datastore.JDO=false +log4j.additivity.DataNucleus.Datastore.JPA=false +log4j.additivity.DataNucleus.Datastore.JCA=false +log4j.additivity.DataNucleus.Datastore.IDE=false + + + + +# if using log4jdbc-remix as JDBC driver +#log4j.logger.jdbc.sqlonly=DEBUG, sql, Console +#log4j.additivity.jdbc.sqlonly=false +#log4j.logger.jdbc.resultsettable=DEBUG, jdbc, Console +#log4j.additivity.jdbc.resultsettable=false + +#log4j.logger.jdbc.audit=WARN,jdbc, Console +#log4j.additivity.jdbc.audit=false +#log4j.logger.jdbc.resultset=WARN,jdbc +#log4j.additivity.jdbc.resultset=false +#log4j.logger.jdbc.sqltiming=WARN,sqltiming +#log4j.additivity.jdbc.sqltiming=false +#log4j.logger.jdbc.connection=FATAL,connection +#log4j.additivity.jdbc.connection=false + + +log4j.logger.org.apache.isis.core.runtime.services.i18n.po.PoWriter=INFO,translations-po +log4j.additivity.org.apache.isis.core.runtime.services.i18n.po.PotWriter=false diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml new file mode 100644 index 000000000..e627a017e --- /dev/null +++ b/naked-objects/integtests/pom.xml @@ -0,0 +1,128 @@ + + + 4.0.0 + + + com.iluwatar + naked-objects + 1.0-SNAPSHOT + + + naked-objects-integtests + Simple App Integration Tests + + + + + 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 + + + + + + + + + diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java b/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java new file mode 100644 index 000000000..28e9d3786 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java @@ -0,0 +1,54 @@ +/* + * 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; + +public class SimpleAppSystemInitializer { + + 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; + } + } +} diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java new file mode 100644 index 000000000..b175d4744 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java @@ -0,0 +1,41 @@ +/** +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; + +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); + } +} diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java new file mode 100644 index 000000000..a2d5c8985 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java @@ -0,0 +1,31 @@ +/** + * 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; + +public class CatalogOfFixturesGlue extends CukeGlueAbstract { + + @Before(value={"@integration", "@SimpleObjectsFixture"}, order=20000) + public void integrationFixtures() throws Throwable { + scenarioExecution().install(new RecreateSimpleObjects()); + } + +} diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java new file mode 100644 index 000000000..63d96bd53 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java @@ -0,0 +1,50 @@ +/** + * 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 java.util.List; +import java.util.UUID; + +import org.apache.isis.core.specsupport.specs.CukeGlueAbstract; + +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 static org.hamcrest.CoreMatchers.is; +import static org.junit.Assert.assertThat; + +public class SimpleObjectGlue extends CukeGlueAbstract { + + @Given("^there are.* (\\d+) simple objects$") + public void there_are_N_simple_objects(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 I_create_a_new_simple_object() throws Throwable { + service(SimpleObjects.class).create(UUID.randomUUID().toString()); + } + +} diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java new file mode 100644 index 000000000..910b5a826 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java @@ -0,0 +1,39 @@ +/** + * 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 +} diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/modules/simple/SimpleObjectSpec_listAllAndCreate.feature b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/modules/simple/SimpleObjectSpec_listAllAndCreate.feature new file mode 100644 index 000000000..346aa2562 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/modules/simple/SimpleObjectSpec_listAllAndCreate.feature @@ -0,0 +1,26 @@ +# +# 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 + + \ No newline at end of file diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java new file mode 100644 index 000000000..3ceef4e63 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/SimpleAppIntegTest.java @@ -0,0 +1,39 @@ +/* + * 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; + +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(); + } + +} diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java new file mode 100644 index 000000000..610136bb8 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectIntegTest.java @@ -0,0 +1,121 @@ +/* + * 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 javax.inject.Inject; + +import org.junit.Before; +import org.junit.Test; + +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 domainapp.dom.modules.simple.SimpleObject; +import domainapp.fixture.scenarios.RecreateSimpleObjects; +import domainapp.integtests.tests.SimpleAppIntegTest; +import static org.assertj.core.api.Assertions.assertThat; + +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); + } + + 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"); + } + } + + 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!"); + } + } + + + 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); + } + } +} \ No newline at end of file diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java new file mode 100644 index 000000000..fd3b0ff46 --- /dev/null +++ b/naked-objects/integtests/src/test/java/domainapp/integtests/tests/modules/simple/SimpleObjectsIntegTest.java @@ -0,0 +1,143 @@ +/* + * 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 java.sql.SQLIntegrityConstraintViolationException; +import java.util.List; + +import javax.inject.Inject; + +import com.google.common.base.Throwables; + +import org.hamcrest.Description; +import org.hamcrest.Matcher; +import org.hamcrest.TypeSafeMatcher; +import org.junit.Test; + +import org.apache.isis.applib.fixturescripts.FixtureScript; +import org.apache.isis.applib.fixturescripts.FixtureScripts; + +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 static org.assertj.core.api.Assertions.assertThat; + +public class SimpleObjectsIntegTest extends SimpleAppIntegTest { + + @Inject + FixtureScripts fixtureScripts; + @Inject + SimpleObjects simpleObjects; + + 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); + } + } + + 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()); + } + }; + } + } + +} \ No newline at end of file diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml new file mode 100644 index 000000000..700d487ee --- /dev/null +++ b/naked-objects/pom.xml @@ -0,0 +1,400 @@ + + + 4.0.0 + + java-design-patterns + com.iluwatar + 1.1.0 + + + com.iluwatar + naked-objects + 1.0-SNAPSHOT + + Simple App + + pom + + + 3.0.4 + + + + 1.9.0-SNAPSHOT + + 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 + + + + + + + + + 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.0-SNAPSHOT + + + ${project.groupId} + naked-objects-fixture + 1.0-SNAPSHOT + + + ${project.groupId} + naked-objects-webapp + 1.0-SNAPSHOT + + + + + + + + + m2e + + + m2e.version + + + + target-ide + + + + + + dom + fixture + integtests + webapp + + \ No newline at end of file diff --git a/naked-objects/webapp/ide/eclipse/launch/.gitignore b/naked-objects/webapp/ide/eclipse/launch/.gitignore new file mode 100644 index 000000000..3d9734548 --- /dev/null +++ b/naked-objects/webapp/ide/eclipse/launch/.gitignore @@ -0,0 +1,8 @@ +/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 diff --git a/naked-objects/webapp/ide/intellij/launch/README.txt b/naked-objects/webapp/ide/intellij/launch/README.txt new file mode 100644 index 000000000..5f8e5ab8a --- /dev/null +++ b/naked-objects/webapp/ide/intellij/launch/README.txt @@ -0,0 +1,2 @@ +Copy into workspace\.idea\runConfigurations directory, and adjust file paths for Maven tasks. + diff --git a/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml b/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml new file mode 100644 index 000000000..918ea3540 --- /dev/null +++ b/naked-objects/webapp/ide/intellij/launch/SimpleApp_PROTOTYPE.xml @@ -0,0 +1,28 @@ + + + + + \ No newline at end of file diff --git a/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml b/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml new file mode 100644 index 000000000..31993b500 --- /dev/null +++ b/naked-objects/webapp/ide/intellij/launch/SimpleApp__enhance_only_.xml @@ -0,0 +1,22 @@ + +s + + + \ No newline at end of file diff --git a/naked-objects/webapp/lib/.gitignore b/naked-objects/webapp/lib/.gitignore new file mode 100644 index 000000000..70eee7e4f --- /dev/null +++ b/naked-objects/webapp/lib/.gitignore @@ -0,0 +1,5 @@ +# +# explicitly ignoring Microsoft JDBC4 jar +# (cannot redistribute, licensing) +# +sqljdbc4.jar diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml new file mode 100644 index 000000000..1d2aa3222 --- /dev/null +++ b/naked-objects/webapp/pom.xml @@ -0,0 +1,352 @@ + + + 4.0.0 + + + com.iluwatar + naked-objects + 1.0-SNAPSHOT + + + naked-objects-webapp + Simple App 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java new file mode 100644 index 000000000..57d1e0ba1 --- /dev/null +++ b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java @@ -0,0 +1,153 @@ +/* + * 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 final static 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) { + } + WebRequest request = super.newWebRequest(servletRequest, filterPath); + return request; + } + + @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()); + final String aboutText = Joiner.on("\n").join(readLines); + return aboutText; + } catch (IOException e) { + return "This is a simple app"; + } + } + +} diff --git a/naked-objects/webapp/src/main/jettyconsole/isis-banner.pdn b/naked-objects/webapp/src/main/jettyconsole/isis-banner.pdn new file mode 100644 index 0000000000000000000000000000000000000000..37543c93c333124664a254bbd5bb13846195959a GIT binary patch literal 69658 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%0Ac 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 z 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 literal 0 HcmV?d00001 diff --git a/naked-objects/webapp/src/main/jettyconsole/isis-banner.png b/naked-objects/webapp/src/main/jettyconsole/isis-banner.png new file mode 100644 index 0000000000000000000000000000000000000000..cd9ecfe02a1f78352a0fb42d056430178a53ea3f GIT binary patch literal 30776 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 + +

+ 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. +

diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties new file mode 100644 index 000000000..929d1775a --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/isis.properties @@ -0,0 +1,300 @@ +# 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 diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/logging.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/logging.properties new file mode 100644 index 000000000..62fd8ea5e --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/logging.properties @@ -0,0 +1,187 @@ +# 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. + + +# +# Isis uses log4j is used to provide system logging +# +log4j.rootCategory=INFO, Console +#log4j.rootCategory=DEBUG, Console + + +# The console appender +log4j.appender.Console=org.apache.log4j.ConsoleAppender +log4j.appender.Console.target=System.out +log4j.appender.Console.layout=org.apache.log4j.PatternLayout +log4j.appender.Console.layout.ConversionPattern=%d{ABSOLUTE} [%-20c{1} %-10t %-5p] %m%n + + +# The stderr appender +log4j.appender.Stderr=org.apache.log4j.ConsoleAppender +log4j.appender.Stderr.target=System.err +log4j.appender.Stderr.layout=org.apache.log4j.PatternLayout +log4j.appender.Stderr.layout.ConversionPattern=%d{ABSOLUTE} [%-20c{1} %-10t %-5p] %m%n + + +# other appenders +log4j.appender.File=org.apache.log4j.RollingFileAppender +log4j.appender.File.file=isis.log +log4j.appender.File.append=false +log4j.appender.File.layout=org.apache.log4j.PatternLayout +log4j.appender.File.layout.ConversionPattern=%d [%-20c{1} %-10t %-5p] %m%n + +log4j.appender.sql=org.apache.log4j.FileAppender +log4j.appender.sql.File=./logs/sql.log +log4j.appender.sql.Append=false +log4j.appender.sql.layout=org.apache.log4j.PatternLayout +log4j.appender.sql.layout.ConversionPattern=-----> %d{yyyy-MM-dd HH:mm:ss.SSS} %m%n%n + +log4j.appender.sqltiming=org.apache.log4j.FileAppender +log4j.appender.sqltiming.File=./logs/sqltiming.log +log4j.appender.sqltiming.Append=false +log4j.appender.sqltiming.layout=org.apache.log4j.PatternLayout +log4j.appender.sqltiming.layout.ConversionPattern=-----> %d{yyyy-MM-dd HH:mm:ss.SSS} %m%n%n + +log4j.appender.jdbc=org.apache.log4j.FileAppender +log4j.appender.jdbc.File=./logs/jdbc.log +log4j.appender.jdbc.Append=false +log4j.appender.jdbc.layout=org.apache.log4j.PatternLayout +log4j.appender.jdbc.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSS} %m%n + +log4j.appender.connection=org.apache.log4j.FileAppender +log4j.appender.connection.File=./logs/connection.log +log4j.appender.connection.Append=false +log4j.appender.connection.layout=org.apache.log4j.PatternLayout +log4j.appender.connection.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSS} %m%n + + + + +! turn on the internal log4j debugging flag so we can see what it is doing +#log4j.debug=true + + +# DataNucleus +# the first two log the DML and DDL (if set to DEBUG) +log4j.logger.DataNucleus.Datastore.Native=WARN, Console +log4j.logger.DataNucleus.Datastore.Schema=DEBUG, Console +# the remainder can probably be left to WARN +log4j.logger.DataNucleus.Persistence=WARN, Console +log4j.logger.DataNucleus.Transaction=WARN, Console +log4j.logger.DataNucleus.Connection=WARN, Console +log4j.logger.DataNucleus.Query=WARN, Console +log4j.logger.DataNucleus.Cache=WARN, Console +log4j.logger.DataNucleus.MetaData=WARN, Console +log4j.logger.DataNucleus.Datastore=WARN, Console +log4j.logger.DataNucleus.Datastore.Persist=WARN, Console +log4j.logger.DataNucleus.Datastore.Retrieve=WARN, Console +log4j.logger.DataNucleus.General=WARN, Console +log4j.logger.DataNucleus.Lifecycle=WARN, Console +log4j.logger.DataNucleus.ValueGeneration=WARN, Console +log4j.logger.DataNucleus.Enhancer=WARN, Console +log4j.logger.DataNucleus.SchemaTool=ERROR, Console +log4j.logger.DataNucleus.JDO=WARN, Console +log4j.logger.DataNucleus.JPA=ERROR, Console +log4j.logger.DataNucleus.JCA=WARN, Console +log4j.logger.DataNucleus.IDE=ERROR, Console + +log4j.additivity.DataNucleus.Datastore.Native=false +log4j.additivity.DataNucleus.Datastore.Schema=false +log4j.additivity.DataNucleus.Datastore.Persistence=false +log4j.additivity.DataNucleus.Datastore.Transaction=false +log4j.additivity.DataNucleus.Datastore.Connection=false +log4j.additivity.DataNucleus.Datastore.Query=false +log4j.additivity.DataNucleus.Datastore.Cache=false +log4j.additivity.DataNucleus.Datastore.MetaData=false +log4j.additivity.DataNucleus.Datastore.Datastore=false +log4j.additivity.DataNucleus.Datastore.Datastore.Persist=false +log4j.additivity.DataNucleus.Datastore.Datastore.Retrieve=false +log4j.additivity.DataNucleus.Datastore.General=false +log4j.additivity.DataNucleus.Datastore.Lifecycle=false +log4j.additivity.DataNucleus.Datastore.ValueGeneration=false +log4j.additivity.DataNucleus.Datastore.Enhancer=false +log4j.additivity.DataNucleus.Datastore.SchemaTool=false +log4j.additivity.DataNucleus.Datastore.JDO=false +log4j.additivity.DataNucleus.Datastore.JPA=false +log4j.additivity.DataNucleus.Datastore.JCA=false +log4j.additivity.DataNucleus.Datastore.IDE=false + + +# if using log4jdbc-remix as JDBC driver +#log4j.logger.jdbc.sqlonly=DEBUG, sql, Console +#log4j.additivity.jdbc.sqlonly=false +#log4j.logger.jdbc.resultsettable=DEBUG, jdbc, Console +#log4j.additivity.jdbc.resultsettable=false + +#log4j.logger.jdbc.audit=WARN,jdbc, Console +#log4j.additivity.jdbc.audit=false +#log4j.logger.jdbc.resultset=WARN,jdbc +#log4j.additivity.jdbc.resultset=false +#log4j.logger.jdbc.sqltiming=WARN,sqltiming +#log4j.additivity.jdbc.sqltiming=false +#log4j.logger.jdbc.connection=FATAL,connection +#log4j.additivity.jdbc.connection=false + + + +# track Isis/JDO lifecycle integration + +#log4j.logger.org.apache.isis.runtimes.dflt.objectstores.jdo.datanucleus.persistence.FrameworkSynchronizer=DEBUG, Console +#log4j.additivity.org.apache.isis.runtimes.dflt.objectstores.jdo.datanucleus.persistence.FrameworkSynchronizer=false + +#log4j.logger.org.apache.isis.objectstore.jdo.datanucleus.persistence.IsisLifecycleListener=DEBUG,Console +#log4j.additivity.org.apache.isis.objectstore.jdo.datanucleus.persistence.IsisLifecycleListener=false + + + + +# track Isis/Wicket lifecycle integration + +#log4j.logger.org.apache.isis.viewer.wicket.viewer.integration.wicket.WebRequestCycleForIsis=DEBUG, Console +#log4j.additivity.org.apache.isis.viewer.wicket.viewer.integration.wicket.WebRequestCycleForIsis=false + +#log4j.logger.org.apache.isis.viewer.wicket.viewer.integration.isis.IsisContextForWicket=INFO,Console +#log4j.additivity.org.apache.isis.viewer.wicket.viewer.integration.isis.IsisContextForWicket=false + + + + +# quieten some of the noisier classes in Isis' bootstrapping +log4j.logger.org.apache.isis.core.metamodel.specloader.specimpl.FacetedMethodsBuilder=WARN,Console +log4j.additivity.org.apache.isis.core.metamodel.specloader.specimpl.FacetedMethodsBuilder=false + +log4j.logger.org.apache.isis.core.metamodel.specloader.ServiceInitializer=WARN,Console +log4j.additivity.org.apache.isis.core.metamodel.specloader.ServiceInitializer=false + +log4j.logger.org.apache.isis.core.runtime.services.ServicesInstallerFromConfiguration=WARN,Console +log4j.additivity.org.apache.isis.core.runtime.services.ServicesInstallerFromConfiguration=false + +log4j.logger.org.apache.isis.core.commons.config.IsisConfigurationDefault=WARN,Console +log4j.additivity.org.apache.isis.core.commons.config.IsisConfigurationDefault=false + +log4j.logger.org.apache.isis.core.runtime.installers.InstallerLookupDefault=WARN,Console +log4j.additivity.org.apache.isis.core.runtime.installers.InstallerLookupDefault=false + + +# quieten Shiro +log4j.logger.org.apache.shiro.realm.AuthorizingRealm=WARN,Console +log4j.additivity.log4j.logger.org.apache.shiro.realm.AuthorizingRealm=false + + +# Application-specific logging +log4j.logger.dom.simple.SimpleObject=DEBUG, Stderr +log4j.additivity.dom.simple.SimpleObject=false \ No newline at end of file diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties new file mode 100644 index 000000000..c73af73c7 --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor.properties @@ -0,0 +1,128 @@ +# 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 + diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties new file mode 100644 index 000000000..675ced3bf --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/persistor_datanucleus.properties @@ -0,0 +1,93 @@ +# 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 +# +# diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/shiro.ini b/naked-objects/webapp/src/main/webapp/WEB-INF/shiro.ini new file mode 100644 index 000000000..971ae697f --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/shiro.ini @@ -0,0 +1,93 @@ +# +# 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 = * diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/translations-en.po b/naked-objects/webapp/src/main/webapp/WEB-INF/translations-en.po new file mode 100644 index 000000000..47b82d11e --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/translations-en.po @@ -0,0 +1,213 @@ +############################################################################## +# +# .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 +############################################################################## + diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/translations-es.po b/naked-objects/webapp/src/main/webapp/WEB-INF/translations-es.po new file mode 100644 index 000000000..8b4c2d7bd --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/translations-es.po @@ -0,0 +1,208 @@ +############################################################################## +# +# .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 +############################################################################## + diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/translations-nl.po b/naked-objects/webapp/src/main/webapp/WEB-INF/translations-nl.po new file mode 100644 index 000000000..4e35a228f --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/translations-nl.po @@ -0,0 +1,208 @@ +############################################################################## +# +# .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 +############################################################################## + diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/translations.po b/naked-objects/webapp/src/main/webapp/WEB-INF/translations.po new file mode 100644 index 000000000..3644a2880 --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/translations.po @@ -0,0 +1,213 @@ +############################################################################## +# +# .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 +############################################################################## + diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties new file mode 100644 index 000000000..0a85fb681 --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_restfulobjects.properties @@ -0,0 +1,66 @@ +# 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 + +############################################################################### diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties new file mode 100644 index 000000000..ba9eaaffb --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/viewer_wicket.properties @@ -0,0 +1,91 @@ +# 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=false \ No newline at end of file diff --git a/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml b/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml new file mode 100644 index 000000000..bb6098f0b --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/WEB-INF/web.xml @@ -0,0 +1,309 @@ + + + + + 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/* + + + + + + + + + + diff --git a/naked-objects/webapp/src/main/webapp/about/images/isis-logo.png b/naked-objects/webapp/src/main/webapp/about/images/isis-logo.png new file mode 100644 index 0000000000000000000000000000000000000000..5284fe73242502a9dbefd1f79af51ba36c773ecf GIT binary patch literal 14160 zcma)jWmFtZ(C#koECkoZ3GNbXm*5cGEf82VxC8=(#ogT{XmAPc&JrXL9D=(Aw?HoM zz32Y^zEfwU=JfP*S5;ScSIrZlt}2gnSUmjAp%j&ypIa#@X zGIxam)Xi-j-MLg{wZWeJT!LJ@JUmyf1pt6hx1tPG+spLC58anYKK1!@_4n!OiT@|R zW}jxCtn6Ce1xt0j?PwR2k32$XDifmQDict8^du-8vi(tpN0fqxnVe@md!z~Y_|#o9 z%V1b_n2~EPKrvdpcJ?GUqh+G=bU6EX81n5oB>b;*(r!R1kQ3Putr6#r9hpL00B%P< z#g`9*j6ooLf3TlQMf3j$ikBC4zWaOq{`8H9PEsH``lQJ}7!9@Vs>3+&g#xnodVEM7 z1thM|$G2zlR;DdCdSCzb-|mZP5|u(~L;Zh+#1R2Wv}=Z6w%Xe-o=#{54ZNH$!)Q^# ziMjG&I-iW(ATI>o6LsF5F&aBtdBU{qeV9Z9v`alRT1(9U5-$nMjHaljs74y7rT~R# zs<>cp-6D@+L39Ch>A?VJ^!S>t2Wc*UU%Ktx1hjZ{#e7Hk|0#HwF94r0R#W{0nI`5DbQ8L*ioeSi(6rdeL*wqEp~oV`V( zr+`Q^1+-EB*HQ7Y0B6*AhT&VKydvwO$t$vq_Df>L#hycIV{P&$|5^rd@R2p3rVpLq8t{go}@u4fkb#LN?3Y`EK+?y(3lK20= z1;hy2y_^}MaEZhDqrd|Q7WnL~W6=1|!=SODib|?M3t6EnN#+TXiJXb-9gDny1V)ML zL~l}#+jgC{mTSbx&I1RLFp}k=#6z(Wh+vONg(ZTv`nJ(=BVkt}nMTyaJsE>f`u~aZ z7ZnC6!24g&TRt;a>Vr$6UItS%Zj~P>pf4=pIHvllR%d10W3d8B9%7|?Hg+{Hicl_e zRQtb*Z~;>RwjZwT`Fsue4ZzgXhme|}aGiO&LD%&19?K3owU@VC+% zYXjm2BltenVS=N~LM#pG$?HII?Dh&uq8XQteg>b*GCr((tX|#`G+Id2q67OF2SHTn+gt6@(@JyJi zS>m&k`ckhoR1f;0z{2rtey1-Enb}OGZ%=PG{Y${4M!r2tO3{FA=hdxQYn8j`9OCKGNu?MwPyzDD!1pH!kte$?5#Hpl7CLu_(#E_%?6$ zS(aN|Ro){`o>xCTwgSPzPQR0jL{IAG8Su;!SQ*k%(BbiXkYL^L4FnPlHKDSaqvU2{ zL6ejcCkwHZla#RJV-kC^#9=Qdkd!4{y+#_oO$R7Ph5r3TpH1|O=9ZJJEzo!aFyt73 z1nC<3?mw1-x04{(OWPKn8Q_?X_$(~RzU_JYGwgRhEs+Hx1o}I#v;ZysjG#up&OG(X zPYk#o5B@rh7*j|D((kB%TCGDY(SB`Ad;qLA2p36xU|#vS;HDIPm7B==wsbCKFzNHC zSPuR6$~tSSvwO3749Y_qDF6lOPHYMq;;cG;67h8zKN^{Aj5_jMoKoLGDzCk#fouwu z@+@}a(a9|e+vZU?Um0&5ioG4Oa%eQQgewUD==~|=Do^8GC=l6$FsfUpJQ zM^zVU)v7vhq%_YYv8dI-QeCMd8pSKxz(hl?1`S?`0#66KPNt*?()8(LnCLxO4JxD+ z@d4s64$gID$>*6>g@hkVJLaG1L|3mhM3+0^#>ZL;U3r?&u1u}>l2WbQQpgI{+!a~B zp|3zD8Y3d`b6?{ElnlhOh-J>mSKI*kJTbsX<%%!k%(uUklJ=40iv+g8!=w!(qH8>P=U)r_x}2S#>x<3=JT@W)zD z;}G|`aijM%apVALu;}s=@4c_O%e~9*8Q0IIEUiAbju0^61TRP>nZmRu=+z$c{@Dh% zUt5?ip4pE#Y(psl>(ZH86I1|y#ODnB*4&7cnqjU|;P(2@6F&EwOY(K#l!9R%5WF>q zB!dCY=g`GKJ`4}x@oQeI)IZ3K2H)@NldrUY^val<-rLavq(SBnX1{Oic8?Z6oo%S-$=81{Zr)t_ z7m7^zLvs3I$MJqG@Cz~X)8Qcxt>n=4-?}X^Dzd7>x2i}Z!+FN3bWZaL=H(HIC{qf* z)fWLE{P5^&c=&Kii2g`8Y{xlRG4LvrBIGtuM)9mSg{jpd@T0?Zc=qu_t?}_wy7A#< zi}B%8i?IOoMeV*eE*5^m<(0m-o*tt9Hb#(xjt#p2Gid?zRaYQ*MgPvM1(9>A_ad`O zGRXTHGCfC}r}>p#(g$_WFCqb8GL{nX8l8A-JOpbQZCvM1%ws|5w$R#z-=ioh_&o!% z-EMssACV(#Tg8wQ3J3tH4;qnRw-o6K;;P6^+Nh=ox_z-8Hf2KzCUh}zdeYCt@o{Uu z#*(LxEyhDE&;ev{D6up)<4lYWq>GyTwbXb`jQej5VDV)r1KdpdFZlotUVDvR3Y&tk z?&=DmncIhd=#u{^2O9jJUnQSy@_8{knmsb?W2&R<(@mW{?X-KZNe(VFoi|sTrONw1 z12?h$5sh>?o3Cu3l$kmPgugaAW4#+{82B4Yy+Mc*yvZQmMV}-LQj*8P)wY<)j#2G8Rs?*CLA{ta@ zapt^hcGkQ=$vPyA%J@o0jsd6&`*s6xFxvh1*rnmnjQatyH}-~-$G&&Y_rtDbW( zQYf{)?r!7M(orcOhz9LD5^s7pwann1P#IT6cb z^WeJqsZkj_eBCPTsk3D_4K?3Zy)uN zWF3?dKPTeAOr*f`W-J8h6E;O2N`e}MhJCy6V5ksPnr{=#4ENnu+{<}#eX&Aw46q8a zb}`#TuSa$IovoBpn9@o2TRIh+u*knab=s*%@NS0@i{Rr8XSnydf6JO=0bVr`Eefs> zi+J4Q`enUIlN-4^K%0O_U`pBqMZxOn2NG}h+JxIAf8L(9L7@|7;$^+1p|NdntU#C+mNmRaM88nsOWRyZKl;XK&BdJ_Mw0he?OsKL-+ zC20nUsCMUv4>Xz*6=qC?-PBj+BQ)annIE=WE9JU{-`$XcD+KTGKa7ty{8NufQ_I+- zouqiCJq94qr+0_Ngt13KuM)<_MvX)wn)iO$c)JmOIny=$?O+6ep34Kt;>Prlb9qLv zz>U&;tNJLQ0U5q35I^Nu(u9wPd*e#>b)#>ihhuIN1dQXJK&7EVNR#wO506bUBSV(S zE>EFmB@V9s8ovML@-Vgc%q2f1^5*2}o(A^$w{_k=#a26?HoKaS4~qtuO@-Gl9kj-o zLAQEZmQ_g>#03@0qmqA3)}srp+6PCBP0Shw=xxgPkjFfv91U>>QXWdk4a3{J%B%%^ z;U`=x^2Ws>a}MSf2lQJv-agcH1TmE}PNW-}OhtOnfQxsZL*7dATR*kH7JaRN&r_C? zmLwz1dR?h?mzfk|W0+)G(-q`0po}}!SsZp0fOPYmdOwVqy_4lb()#*geWQbh=u$D< z7mIXu9uQN5ZUq8vE9-+%5+=<;ya2)HAO^e-9v0*PS8mFq%K-9&4r?TZJzP?3l)m0* zQZ%j;>AtT8@2_#Vp7*Sn+MuVyVNg@XBZ-HQ7|I`uZDP~`j=>2U5<}xuiI<#lCi|eNld;69(bUY1!NUru zWo6YvBTjUJuHn=J!UwU=2cR|~#`NKqQ9&zi7A|@Zs|K^%7r~jX*OC5CTsRDX4W;GN zrTi&p*`$L!!4!4w5QxinvV$6)4Vr31I?RGto$Z9f`}%I8lBd+9$DLCI7Jc30^yRf^ za%p!KC994j!$r6cv$nNj9c}kz8oH3|ppInRPLrCxs;(j9Dg@i1+kd^}-OAg+O2eln z=Qi4%jO;(mBd2UvS7%O+OS-IG1!YP3_I?xieM3I0#)%oE+A#0)VFWW$lbIyuD4NIL)?G6p*NEqbTA5MVY^X6SX;nd^N^j?LL=to zF&pQYXZ3daLO$p36b-L`$UEm9R#uJfGMW#`>wva!=P*?Ytnx4=nV>a6l3FSy#4Wr0 z5Zj9Y#3Ok;f<;aFqa-WgmD&_Lo*$M%fguO&L*EHR^|vY-?`7oHpzs92fL9K0dYTC< z@`XW)>_D2*>xOXWoK(7$EMfM_=$a@A$J`C{cUEoCbE)B+0K@iay!(QXePrTt zw&&iiR;njlD6^&9gKS!4f%$bo5^ zlza)(tJWjT0@m;cG68EN&wS%3`+w%hrdC?GJSpMx92{DUJY+SRLZvR9Ez$vh@#Zr` z@(n$VY6kBvf0V^lE2M~pM+(fKM*hoKm5Ul!n)CMU=Ek1P>oOe5^wHAx%@;ca3VRf0 zOK|2|^oqo(&42BuiXQ6xu~~l`mH%t*U0z2Dlp2-l(AsAn;@g`2KK04(`rr$2yC0i& zWZ;(-ATAORXUDg-nwbIM^B$8(n>Csl8~c+W2$L;MbS2!=@e`}fU!gKoaKvNh5LRG@ z8wa7f4mL{H129(gv0fI`*=HF*ieWJc#>ZuG*0ZL+VIS>o@+%!5!ixmCI9|W|3Ul>q znX%JN^WJ&I?8C_{OIN>Iqre1UF^&3&XxuqEBb9ukm3PS@iI-shiWDyxpi1~_ zQY$Vauo7t}5$~xKyZ?xB=uCTo6ROHhiD*Jz-Da9mDQEQshQBY*E{mHhlyFw^9@}H$Hr&#rrKY_W{_VE-8Ec{AMB(?OhnLv>u6x z?$h4D7ZtW_+Pg67{>a#>@vjY=4{+sv@7~vC65fQ zm0F?2b)AE2Fy#jS5yOw-#=jaHRVqkdkA5$Nc^L;svtAUbuxaY=rgG6e9*J}Nl&E1F z0RjNdg_5zSS*g0!I1JyBBXwRmbroo}@36ChbLa7nLRH`aEjMxm4HjE?d z-Bw#)Y_Lh8x4<1hcI1qO(1K3EQck>`V;rT9z9nK68iA8SB2i@iwS1$kdFWR|eUCB4 zHlG_-vvQInOTI3q*X&99%EZePvcdmYtf1b7JL0&*J2qK+`e&3>s64Q#U&Jcl&+V5p zXuH$v?a05&TP2Rk79>d~u?K-18@pfZ$yfSA&^Sq1%>IG8Q!biKLsk}+^FI<^*^oc% zz*^S2$ZpZGz|CFlOtzFP$l`2tyBa!Hr`50dKg|kk(vG?tY;aUOHy}pSe+t43niWLD z^ifxJq@sN_9fR%^0rwM_5FBCFj7Ek=NB9p;0~HcD2~b=}o0a{n^P>JZk6$bs7_1bC znBfXH?)Ad{rm4YSiwN4$zMXmF>{pW5zg_gYC6}~Zjs8NMV1n;r92j85Oud3 zKT(PlKm1r}`ZM>c-Mj2y+HQ?HBfV>mv-w!dw>HY7jExw^>gL%wmEm&BPEqQ$cd*`DZ@SeT5YMwUjm3ucP=HZlN{#WbxtA1 zFLxC(AV5Yxz0Bx$K4@?aS*w$P9pInz`tNM9R@_dO2DrI~Z%eLfI3C+c1-i4B2c8lMRBKnX5Ys1*H?>9CWb{R|4KY+k zhMMi9?}V&ri&YxL30CYueXXlI*n$w%zY;YjT!PXI{oP-;V3lREI|Ry$a{JMV2!0xq z57}h!YFX^oToanp-qpnp=(Rw*(eVLJKON8><||L*Em1L?a*_i#nFWtT)HPz!o<{RL z0}V(V_{{?xC5e05RnrEa!l(|{50K8g9-{gD(K$br^)EHYuwKGz9y&Op$(EfB-C4I_ z0Zlvee$PlR(Prz3oOoVk(;l>51hbcAOQl@V26#YJBv<0z)?oH~boS9@@Ct>l!WXKi zqQ3&WuYIlJ(IH=WI6y6R7&OlBc^?n4EiFxkell4DD2Cer0&m3GmX{>CvJ6QRb~r6y zb`sf#MqSY=(X3oEO2ld2C^)`c$m&J1sS`!8JO9^^Ah0xG!}{~Ak}C$l)qQcg_9bG9 z-kYEEPSFb`J~9aEfaZotHW^5!x2_b?YvRQ2sYZ=bOyC%T3~K-?WRQd+HB_H2a+z4g zz7D#J5u2=H=dZpiIi~^L61k&$^QHOTUwf;BZ;g5VF(Lp7vl$*O2A)+DQ6mV%(@%EZ z_0Bx}Vec|Sdc}!eaWc+b|+LAs%f;tnf{E60t^ak*czIp3o z6ZAGJ=a$NdO|QK>$9BU6V*1JZW!mLVv8QJ>8$6ILAaNsOL9`wbiz24mG+$fIxzT7- zCXX)(z(VG(KcL2GyQ+{nr3PaQTLk;qcsu`uek#;j;##&?&z&U9yfRVSdqRy@lWb?z zO8qYDsYBdSWd}Ah#Wm0+#!Z`zHxRVkg)7yU8WFTqU{OHmETSwyfC1ze%P)A0@Onc$d}o#N#Ae>+goFf?(wFpn3ywR;yz-ka?$c=#hF+8eAB1_N zRK&TeKEu?W1af@5vQX}F906>8_IVg2SEX*(Dm&GOHEdgvk(KSFA<}x-0i&jQ6)Ab5 z8VB@$V5l)~$-6hPOA>dtn~+~YH{QidR7Ak-i$u1PMp1kmCI@43LIoq$+Biv~k(tvqJgn%7Gq z7i%5H+)4^bgD1ukbHos*_BAsV^5=z57i?jBZ#`5R8_9aECZ z^Y>G?z26z{7!IceI0ecF-e-MZWBK7@TbvN48v-TWxg?R*#a=tXvTt3M+%z=|aQA-` zBlxJogz%I2$Jp)5L1E*a%sU)-oA{>XByQQYEGdHI8;;P0=$wNDb6zXLnj<2La+b6lPsIxYvfNc z3bmld(|);w3Z3XPD%yWT2`k^ zOU1sX{{%W~;f)5K2YM~eSh!N0mT#?MjRc&^!b~2?46Z&`{_y28W!8&MA_qhfwG`aQ_+M#tWsaw(vq*abdqWbi?#?gnX#T^WW>;A8|;eZwvakqx$R%1V+e z?{LlmR4(!Nzrnyt(eZ=%f!oki1G9y!3?8BI%RT3}Y?RE{WpG;&7SZt2*X`I*F3giO zWRG@9TWJT9egCdvmRCLZOrmS#e>QNIt{zj7B7OFVpM=+!N85Vqb8;HGM|3@Got>2> z8HBLiTP_bGmBszt?Mjpd&u)fxEZ`MB>Jtl_(<3KA*aA~Wzyt;ho4TB(~HKBi|MUbj#k>gs!XuyIi?vw#7n&=T#4ghk$BMpQ%& z2^!FXAMio>WAev{sEMNSyDrRaZaB|r0y#32Qp{c_EvTlOnPqK}N)@040b)Q8aJf?f#IIIe9Ca_Xjol|3floiP zMXrWvn^dT7GV;rOWx1>W0SDmK5?MoU&dEMLVTZGSt`=G(u|Rj1|M_Imnf5A0Y4SJv zT=Uv&5yF|%g@Lt7q}@JvQsrnI0Q8-9utMj)sUQpg;!r`Qu38Te?$SeB{AAG}xnrQf z+>Mpt*D$PF>7dcnvc#1CsPa$fsQ7XFRlGIvIm~Pd|2O#7NeS{QF6sc8a<2-qCYAgslx%^ z8(UvgD(xsStk100wG!9j;lOgyc}Z zLw;5M6&QI$v+;X{C$8wPD-Y4{9`^bG479WiMuDtVIO>?Xy2wE*VJ6BUTA@=8Lg_n8 zpghgO(Jtfup0a{^XoagzH--`-Uw{Q8{KX0TO1yeHpoSQD{@oNa(JEtVj)#&h>RU)=m=>)@}fy?c;@DjRqyvScUx;L+k+gom@-N62aW>@ zBVfHzvhfs=OFFVKe5$iz6LlvHyoLCD74|O!<_8=}^CF))o|QP)g?2c4+A@(#UE3P` z6gHKl4)3J;iZzD+m0$)^GD})3AbEHjOm!3@jN!@2l_i#%gc{@AsJKIxL8>P=UC3{& zW@N5-3=lb12~RNrf9b+r0$z|p_PZ{2`|1tBDDkV4zmkK-Ge-`n#ayW&JY~jE^$gKL zi58>}Lld7tL0&{QY}i&!e=%iXCptWT9{mGar0cLrQTdh)40VC7=_tl2nynOOgK8i> z72|QY?@A#Bu36qodxu#OfGWsUr}Y?F@Ao0BTpS%0AwvS3t7R5SVwRK)Za~97RViV; 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 + + + + + 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). +

+ +
+ + diff --git a/naked-objects/webapp/src/main/webapp/css/application.css b/naked-objects/webapp/src/main/webapp/css/application.css new file mode 100644 index 000000000..9f1612af1 --- /dev/null +++ b/naked-objects/webapp/src/main/webapp/css/application.css @@ -0,0 +1,19 @@ +/* + * 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. + */ + diff --git a/naked-objects/webapp/src/main/webapp/images/spinning-icon.gif b/naked-objects/webapp/src/main/webapp/images/spinning-icon.gif new file mode 100644 index 0000000000000000000000000000000000000000..75e3b1e5baa32a169f85a25f2031f3058b834e09 GIT binary patch literal 5266 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 - + 4.0.0 com.iluwatar @@ -66,7 +65,8 @@ private-class-data object-pool dependency-injection - + naked-objects + @@ -119,7 +119,7 @@ - + @@ -164,4 +164,4 @@ - + \ No newline at end of file From 833b5883d42697f9b63c4be74051c977a7480526 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 13 Jul 2015 15:22:28 +0300 Subject: [PATCH 005/687] #91 Eclipse fix for generated project --- .../main/java/domainapp/dom/modules/simple/SimpleObjects.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java index 0634dd16a..47ab6c160 100644 --- a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java +++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java @@ -70,7 +70,7 @@ public class SimpleObjects { final String name ) { return container.allMatches( - new QueryDefault<>( + new QueryDefault( SimpleObject.class, "findByName", "name", name)); From e6cae6dcbde5ab6ac60cfd944df93efe0e16183d Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 13 Jul 2015 21:16:43 +0300 Subject: [PATCH 006/687] #91 Changed version numbers and removed artifact names --- naked-objects/dom/pom.xml | 356 ++++++++------- naked-objects/fixture/pom.xml | 57 ++- naked-objects/integtests/pom.xml | 196 ++++---- naked-objects/pom.xml | 741 +++++++++++++++---------------- naked-objects/webapp/pom.xml | 616 ++++++++++++------------- 5 files changed, 947 insertions(+), 1019 deletions(-) diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index 8d3d866c6..dcfb0cda5 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -1,194 +1,186 @@ - - 4.0.0 + + + 4.0.0 - - com.iluwatar - naked-objects - 1.0-SNAPSHOT - + + com.iluwatar + naked-objects + 1.1.0 + - naked-objects-dom - Simple App DOM + naked-objects-dom - - - - src/main/resources - - - src/main/java - - ** - - - **/*.java - - - - + + + + src/main/resources + + + src/main/java + + ** + + + **/*.java + + + + - - - org.apache.isis.core - isis-core-applib - + + + org.apache.isis.core + isis-core-applib + - - org.apache.isis.core - isis-core-unittestsupport - test - + + org.apache.isis.core + isis-core-unittestsupport + test + - - - org.objenesis - objenesis - test - + + + org.objenesis + objenesis + test + - - org.assertj - assertj-core - test - + + org.assertj + assertj-core + test + - + - - - enhance - - true - - - 4.0.0-release - - - - - - - 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 - - - - - - - - + + + enhance + + true + + + 4.0.0-release + + + + + + + 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 + + + + + + + + diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml index 63ee62d1a..20e6eb4e0 100644 --- a/naked-objects/fixture/pom.xml +++ b/naked-objects/fixture/pom.xml @@ -1,38 +1,31 @@ - - 4.0.0 + + + 4.0.0 - - com.iluwatar - naked-objects - 1.0-SNAPSHOT - + + com.iluwatar + naked-objects + 1.1.0 + - naked-objects-fixture - Simple App Fixtures + naked-objects-fixture - - - ${project.groupId} - naked-objects-dom - - + + + ${project.groupId} + naked-objects-dom + + diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index e627a017e..19c26443c 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -1,128 +1,100 @@ - - 4.0.0 + + + 4.0.0 - - com.iluwatar - naked-objects - 1.0-SNAPSHOT - + + com.iluwatar + naked-objects + 1.1.0 + - naked-objects-integtests - Simple App Integration Tests + naked-objects-integtests - - - - src/test/resources - - - src/test/java - - ** - - - **/*.java - - - - - + + + + src/test/resources + + + src/test/java + + ** + + + **/*.java + + + + + - - - ${project.groupId} - naked-objects-fixture - + + + ${project.groupId} + naked-objects-fixture + - - org.apache.isis.core - isis-core-unittestsupport - + + org.apache.isis.core + isis-core-unittestsupport + - - org.apache.isis.core - isis-core-integtestsupport - - - org.apache.isis.core - isis-core-specsupport - + + org.apache.isis.core + isis-core-integtestsupport + + + org.apache.isis.core + isis-core-specsupport + - - org.hamcrest - hamcrest-library - + + org.hamcrest + hamcrest-library + - - org.apache.isis.core - isis-core-wrapper - - - org.apache.isis.core - isis-core-runtime - + + org.apache.isis.core + isis-core-wrapper + + + org.apache.isis.core + isis-core-runtime + - - org.assertj - assertj-core - test - + + org.assertj + assertj-core + test + - - org.hsqldb - hsqldb - + + org.hsqldb + hsqldb + - + - - net.masterthought - cucumber-reporting - 0.0.21 - - - net.masterthought - maven-cucumber-reporting - 0.0.4 - - --> - - - + diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index 700d487ee..09614e785 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -1,400 +1,399 @@ - - 4.0.0 - - java-design-patterns - com.iluwatar - 1.1.0 - + + + 4.0.0 + + java-design-patterns + com.iluwatar + 1.1.0 + - com.iluwatar - naked-objects - 1.0-SNAPSHOT + naked-objects - Simple App + pom - pom + + 3.0.4 + - - 3.0.4 - + + 1.9.0-SNAPSHOT - - 1.9.0-SNAPSHOT + UTF-8 + UTF-8 + 2.0.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 + + + - - - 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-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-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 + + + - - 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 + - - 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.mortbay.jetty - maven-jetty-plugin - 6.1.26 - + + org.apache.maven.plugins + maven-shade-plugin + 2.2 + - - 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.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/** - - - 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/** - **/*.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 - **/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 + + + - **/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 - - - + + - - + + org.apache.isis.core + isis + ${isis.version} + pom + import + - - org.apache.isis.core - isis - ${isis.version} - pom - import - + + org.apache.isis.viewer + isis-viewer-wicket + ${isis.version} + pom + import + - - org.apache.isis.viewer - isis-viewer-wicket - ${isis.version} - pom - import - - - - org.assertj - assertj-core - ${assertj-core.version} - + + org.assertj + assertj-core + ${assertj-core.version} + - - - ${project.groupId} - naked-objects-dom - 1.0-SNAPSHOT - - - ${project.groupId} - naked-objects-fixture - 1.0-SNAPSHOT - - - ${project.groupId} - naked-objects-webapp - 1.0-SNAPSHOT - + + + ${project.groupId} + naked-objects-dom + 1.1.0 + + + ${project.groupId} + naked-objects-fixture + 1.1.0 + + + ${project.groupId} + naked-objects-webapp + 1.1.0 + - - + + - - - m2e - - - m2e.version - - - - target-ide - - - + + + m2e + + + m2e.version + + + + target-ide + + + - - dom - fixture - integtests - webapp - + + dom + fixture + integtests + webapp + \ No newline at end of file diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index 1d2aa3222..7e90194d0 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -1,352 +1,324 @@ - - 4.0.0 + + + 4.0.0 - - com.iluwatar - naked-objects - 1.0-SNAPSHOT - + + com.iluwatar + naked-objects + 1.1.0 + - naked-objects-webapp - Simple App Webapp + 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. + This module runs both the Wicket viewer and the Restfulobjects viewer in a single webapp configured to run using the datanucleus object store. - war + 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.mortbay.jetty + maven-jetty-plugin + - - org.codehaus.mojo - build-helper-maven-plugin - 1.8 - - - validate - - maven-version - - - - + + + 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 + + + - - 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.codehaus.mojo + build-helper-maven-plugin + 1.8 + + + validate + + maven-version + + + + - - - - - - org.eclipse.m2e - lifecycle-mapping - 1.0.0 - - - - - - org.codehaus.mojo - build-helper-maven-plugin - [1.5,) - - 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 + + - - - - - ${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.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-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.isis.core + isis-core-webserver + runtime + true + - - org.apache.geronimo.specs - geronimo-servlet_3.0_spec - + + org.apache.geronimo.specs + geronimo-servlet_3.0_spec + - - - org.hsqldb - hsqldb - + + + org.hsqldb + hsqldb + - + - - + + - - org.lazyluke - log4jdbc-remix - - - org.slf4j - slf4j-api - - - + + 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 - - - - - - + + + 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 + + + + + + - - - - - - - + + + + + + + - - - - - + + + + + - - - + + + - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + From 0f739b0a83e9f8fee32e67fe0c60d88b8bd198d3 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 13 Jul 2015 23:30:25 +0300 Subject: [PATCH 007/687] #91 README.md changes --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 59312ea84..0bb3528a9 100644 --- a/README.md +++ b/README.md @@ -86,6 +86,7 @@ An architectural pattern is a general, reusable solution to a commonly occurring * [Data Access Object](#dao) * [Service Layer](#service-layer) +* [Naked Objects](#naked-objects) ### Integration Patterns @@ -642,6 +643,16 @@ validation and for building to order * When you need to remove knowledge of concrete implementation from object * To enable unit testing of classes in isolation using mock objects or stubs +## Naked Objects [↑](#list-of-design-patterns) +**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](https://github.com/iluwatar/java-design-patterns/blob/master/naked-objects/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 + # Frequently asked questions @@ -731,6 +742,7 @@ Java-design-patterns project uses [semantic versioning](http://semver.org/) sche * [Martin Fowler - Tolerant Reader](http://martinfowler.com/bliki/TolerantReader.html) * [Trygve Reenskaug - Model-view-controller](http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) * [Flux - Application architecture for building user interfaces](http://facebook.github.io/flux/) +* [Richard Pawson - Naked Objects](http://downloads.nakedobjects.net/resources/Pawson%20thesis.pdf) From 6dc1b82638b243909e2d18e608252a4a38454dfc Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 13 Jul 2015 23:40:48 +0300 Subject: [PATCH 008/687] #91 Added class diagram --- naked-objects/etc/naked-objects.png | Bin 0 -> 75022 bytes naked-objects/etc/naked-objects.ucls | 162 +++++++++++++++++++++++++++ 2 files changed, 162 insertions(+) create mode 100644 naked-objects/etc/naked-objects.png create mode 100644 naked-objects/etc/naked-objects.ucls diff --git a/naked-objects/etc/naked-objects.png b/naked-objects/etc/naked-objects.png new file mode 100644 index 0000000000000000000000000000000000000000..eda8439a2896339adc829e61b5cde85ca7d1af4b GIT binary patch literal 75022 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°gp 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

p0NZ!WK-SDvpILX1AY_?Sw+>6=zV1W^cNhBJ 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 literal 0 HcmV?d00001 diff --git a/naked-objects/etc/naked-objects.ucls b/naked-objects/etc/naked-objects.ucls new file mode 100644 index 000000000..8e9afac6d --- /dev/null +++ b/naked-objects/etc/naked-objects.ucls @@ -0,0 +1,162 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file From fb8ca3cd88bb9a4d607b42903b01b2d309b01963 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 13 Jul 2015 23:45:58 +0300 Subject: [PATCH 009/687] #91 Added real world example --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 0bb3528a9..986d0dbd1 100644 --- a/README.md +++ b/README.md @@ -653,6 +653,9 @@ validation and for building to order * 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/) + # Frequently asked questions From 7196b6d631ae1ae34d7157804b43b74af4daeda5 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 13 Jul 2015 23:49:01 +0300 Subject: [PATCH 010/687] #91 Added README --- naked-objects/README | 1 + 1 file changed, 1 insertion(+) create mode 100644 naked-objects/README diff --git a/naked-objects/README b/naked-objects/README new file mode 100644 index 000000000..c3e693735 --- /dev/null +++ b/naked-objects/README @@ -0,0 +1 @@ +This 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-archetype \ No newline at end of file From a0861c47e1f2fc3ec4c4155427d029e7831da202 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 14 Jul 2015 00:10:01 +0300 Subject: [PATCH 011/687] Reached milestone, set version to 1.2.0 --- abstract-factory/pom.xml | 2 +- adapter/pom.xml | 2 +- bridge/pom.xml | 2 +- builder/pom.xml | 2 +- callback/pom.xml | 2 +- chain/pom.xml | 2 +- command/pom.xml | 2 +- composite/pom.xml | 2 +- dao/pom.xml | 2 +- decorator/pom.xml | 2 +- dependency-injection/pom.xml | 2 +- double-checked-locking/pom.xml | 2 +- double-dispatch/pom.xml | 2 +- event-aggregator/pom.xml | 2 +- execute-around/pom.xml | 2 +- facade/pom.xml | 2 +- factory-method/pom.xml | 2 +- flux/pom.xml | 2 +- flyweight/pom.xml | 2 +- intercepting-filter/pom.xml | 2 +- interpreter/pom.xml | 2 +- iterator/pom.xml | 2 +- lazy-loading/pom.xml | 2 +- mediator/pom.xml | 2 +- memento/pom.xml | 2 +- model-view-controller/pom.xml | 2 +- model-view-presenter/pom.xml | 2 +- multiton/pom.xml | 2 +- naked-objects/dom/pom.xml | 2 +- naked-objects/fixture/pom.xml | 2 +- naked-objects/integtests/pom.xml | 2 +- naked-objects/pom.xml | 8 ++++---- naked-objects/webapp/pom.xml | 2 +- null-object/pom.xml | 2 +- object-pool/pom.xml | 2 +- observer/pom.xml | 2 +- poison-pill/pom.xml | 2 +- pom.xml | 2 +- private-class-data/pom.xml | 2 +- property/pom.xml | 2 +- prototype/pom.xml | 2 +- proxy/pom.xml | 2 +- resource-acquisition-is-initialization/pom.xml | 2 +- servant/pom.xml | 2 +- service-layer/pom.xml | 2 +- service-locator/pom.xml | 2 +- singleton/pom.xml | 2 +- specification/pom.xml | 2 +- state/pom.xml | 2 +- strategy/pom.xml | 2 +- template-method/pom.xml | 2 +- thread-pool/pom.xml | 2 +- tolerant-reader/pom.xml | 2 +- visitor/pom.xml | 2 +- 54 files changed, 57 insertions(+), 57 deletions(-) diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml index a071aee26..434617a85 100644 --- a/abstract-factory/pom.xml +++ b/abstract-factory/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 abstract-factory diff --git a/adapter/pom.xml b/adapter/pom.xml index 7a6861fca..426758057 100644 --- a/adapter/pom.xml +++ b/adapter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 adapter diff --git a/bridge/pom.xml b/bridge/pom.xml index 4718a01bf..c40c9ed5c 100644 --- a/bridge/pom.xml +++ b/bridge/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 bridge diff --git a/builder/pom.xml b/builder/pom.xml index e5984720d..0853718ef 100644 --- a/builder/pom.xml +++ b/builder/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 builder diff --git a/callback/pom.xml b/callback/pom.xml index 862fb53a1..10d054aae 100644 --- a/callback/pom.xml +++ b/callback/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 callback diff --git a/chain/pom.xml b/chain/pom.xml index 3e960293a..64d47f946 100644 --- a/chain/pom.xml +++ b/chain/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 chain diff --git a/command/pom.xml b/command/pom.xml index 53a8e1914..6a364ad5b 100644 --- a/command/pom.xml +++ b/command/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 command diff --git a/composite/pom.xml b/composite/pom.xml index d8d7e4233..e348dd48a 100644 --- a/composite/pom.xml +++ b/composite/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 composite diff --git a/dao/pom.xml b/dao/pom.xml index bfd35c727..6f5cd0720 100644 --- a/dao/pom.xml +++ b/dao/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 dao diff --git a/decorator/pom.xml b/decorator/pom.xml index ab15cde08..192c77c78 100644 --- a/decorator/pom.xml +++ b/decorator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 decorator diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml index 813030b51..8eaee2fe6 100644 --- a/dependency-injection/pom.xml +++ b/dependency-injection/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 dependency-injection diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml index 8103cf986..c5eeb0350 100644 --- a/double-checked-locking/pom.xml +++ b/double-checked-locking/pom.xml @@ -3,7 +3,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 double-checked-locking diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml index 40356e018..6b6b86ab4 100644 --- a/double-dispatch/pom.xml +++ b/double-dispatch/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 double-dispatch diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml index 910d6a35e..d0f0a8341 100644 --- a/event-aggregator/pom.xml +++ b/event-aggregator/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 event-aggregator diff --git a/execute-around/pom.xml b/execute-around/pom.xml index 1782caf88..24ecb6ed9 100644 --- a/execute-around/pom.xml +++ b/execute-around/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 execute-around diff --git a/facade/pom.xml b/facade/pom.xml index b80538341..89b75cd68 100644 --- a/facade/pom.xml +++ b/facade/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 facade diff --git a/factory-method/pom.xml b/factory-method/pom.xml index 9f4c79c15..ac25424eb 100644 --- a/factory-method/pom.xml +++ b/factory-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 factory-method diff --git a/flux/pom.xml b/flux/pom.xml index ad511a53c..80bff387f 100644 --- a/flux/pom.xml +++ b/flux/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 flux diff --git a/flyweight/pom.xml b/flyweight/pom.xml index 70f98f9b1..68a0c7228 100644 --- a/flyweight/pom.xml +++ b/flyweight/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 flyweight diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml index ae450f8ec..d64be4ed3 100644 --- a/intercepting-filter/pom.xml +++ b/intercepting-filter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 intercepting-filter diff --git a/interpreter/pom.xml b/interpreter/pom.xml index d58404463..12e3e0782 100644 --- a/interpreter/pom.xml +++ b/interpreter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 interpreter diff --git a/iterator/pom.xml b/iterator/pom.xml index 48b91d9e5..2f1445f9f 100644 --- a/iterator/pom.xml +++ b/iterator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 iterator diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml index 454a70a58..7aa3afc23 100644 --- a/lazy-loading/pom.xml +++ b/lazy-loading/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 lazy-loading diff --git a/mediator/pom.xml b/mediator/pom.xml index 95ad4d78f..e0e8679d2 100644 --- a/mediator/pom.xml +++ b/mediator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 mediator diff --git a/memento/pom.xml b/memento/pom.xml index db012477b..9f18dcf0b 100644 --- a/memento/pom.xml +++ b/memento/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 memento diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml index 8b5e1a250..225c9bb3c 100644 --- a/model-view-controller/pom.xml +++ b/model-view-controller/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 model-view-controller diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml index a00deaac3..cd4de7de2 100644 --- a/model-view-presenter/pom.xml +++ b/model-view-presenter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 model-view-presenter model-view-presenter diff --git a/multiton/pom.xml b/multiton/pom.xml index 52c71824b..7803db40b 100644 --- a/multiton/pom.xml +++ b/multiton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 multiton diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index dcfb0cda5..e3c1f5274 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.1.0 + 1.2.0 naked-objects-dom diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml index 20e6eb4e0..35587fe58 100644 --- a/naked-objects/fixture/pom.xml +++ b/naked-objects/fixture/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.1.0 + 1.2.0 naked-objects-fixture diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index 19c26443c..6e7aac0fc 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.1.0 + 1.2.0 naked-objects-integtests diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index 09614e785..51ad45540 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -15,7 +15,7 @@ java-design-patterns com.iluwatar - 1.1.0 + 1.2.0 naked-objects @@ -359,17 +359,17 @@ ${project.groupId} naked-objects-dom - 1.1.0 + 1.2.0 ${project.groupId} naked-objects-fixture - 1.1.0 + 1.2.0 ${project.groupId} naked-objects-webapp - 1.1.0 + 1.2.0 diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index 7e90194d0..3126ecffc 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.1.0 + 1.2.0 naked-objects-webapp diff --git a/null-object/pom.xml b/null-object/pom.xml index 14d872f6c..9992adbc3 100644 --- a/null-object/pom.xml +++ b/null-object/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 null-object diff --git a/object-pool/pom.xml b/object-pool/pom.xml index 59406068a..fc3d176b7 100644 --- a/object-pool/pom.xml +++ b/object-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 object-pool diff --git a/observer/pom.xml b/observer/pom.xml index 77246fb13..0aed8eff8 100644 --- a/observer/pom.xml +++ b/observer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 observer diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml index 10887dac5..49065ab5a 100644 --- a/poison-pill/pom.xml +++ b/poison-pill/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 poison-pill diff --git a/pom.xml b/pom.xml index 1336bc6d6..7e1566876 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 pom diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml index 58fdeef04..ea4a67328 100644 --- a/private-class-data/pom.xml +++ b/private-class-data/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 private-class-data diff --git a/property/pom.xml b/property/pom.xml index 579ea9041..6cd9e05fe 100644 --- a/property/pom.xml +++ b/property/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 property diff --git a/prototype/pom.xml b/prototype/pom.xml index 31e07ca52..1752c069b 100644 --- a/prototype/pom.xml +++ b/prototype/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 prototype diff --git a/proxy/pom.xml b/proxy/pom.xml index a33f4f612..64fee37f6 100644 --- a/proxy/pom.xml +++ b/proxy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 proxy diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml index 978598909..d0f51a252 100644 --- a/resource-acquisition-is-initialization/pom.xml +++ b/resource-acquisition-is-initialization/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 resource-acquisition-is-initialization diff --git a/servant/pom.xml b/servant/pom.xml index 72c0a91c2..8a2a2cca7 100644 --- a/servant/pom.xml +++ b/servant/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 servant diff --git a/service-layer/pom.xml b/service-layer/pom.xml index 45d3eacd6..37e66fad8 100644 --- a/service-layer/pom.xml +++ b/service-layer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 service-layer diff --git a/service-locator/pom.xml b/service-locator/pom.xml index a0a84a43c..8b587e917 100644 --- a/service-locator/pom.xml +++ b/service-locator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 service-locator diff --git a/singleton/pom.xml b/singleton/pom.xml index 1db1ff382..7aa7b902a 100644 --- a/singleton/pom.xml +++ b/singleton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 singleton diff --git a/specification/pom.xml b/specification/pom.xml index 533897e00..322d80d2d 100644 --- a/specification/pom.xml +++ b/specification/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 specification diff --git a/state/pom.xml b/state/pom.xml index 7f8bb7fbf..a948e0bf8 100644 --- a/state/pom.xml +++ b/state/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 state diff --git a/strategy/pom.xml b/strategy/pom.xml index 466262d9b..5ceab5e61 100644 --- a/strategy/pom.xml +++ b/strategy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 strategy diff --git a/template-method/pom.xml b/template-method/pom.xml index 7280b6cf5..91edfabc3 100644 --- a/template-method/pom.xml +++ b/template-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 template-method diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml index 71a357ab9..a75932f08 100644 --- a/thread-pool/pom.xml +++ b/thread-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 thread-pool diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml index c92b169ba..de9372911 100644 --- a/tolerant-reader/pom.xml +++ b/tolerant-reader/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 tolerant-reader diff --git a/visitor/pom.xml b/visitor/pom.xml index 609892888..97b57bc19 100644 --- a/visitor/pom.xml +++ b/visitor/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.1.0 + 1.2.0 visitor From 4ad5e84d0eec771303e700f7d2b7712c685563ef Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 11:44:39 +0300 Subject: [PATCH 012/687] #90 Skeleton for Front Controller example --- front-controller/pom.xml | 19 +++ .../src/main/java/com/iluwatar/App.java | 7 ++ .../src/test/java/com/iluwatar/AppTest.java | 12 ++ pom.xml | 114 +++++++++--------- 4 files changed, 95 insertions(+), 57 deletions(-) create mode 100644 front-controller/pom.xml create mode 100644 front-controller/src/main/java/com/iluwatar/App.java create mode 100644 front-controller/src/test/java/com/iluwatar/AppTest.java diff --git a/front-controller/pom.xml b/front-controller/pom.xml new file mode 100644 index 000000000..2327abd69 --- /dev/null +++ b/front-controller/pom.xml @@ -0,0 +1,19 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.2.0 + + front-controller + + + junit + junit + test + + + diff --git a/front-controller/src/main/java/com/iluwatar/App.java b/front-controller/src/main/java/com/iluwatar/App.java new file mode 100644 index 000000000..b95f9d5b2 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/App.java @@ -0,0 +1,7 @@ +package com.iluwatar; + +public class App { + public static void main(String[] args) { + System.out.println("Hello World!"); + } +} diff --git a/front-controller/src/test/java/com/iluwatar/AppTest.java b/front-controller/src/test/java/com/iluwatar/AppTest.java new file mode 100644 index 000000000..b81f7499d --- /dev/null +++ b/front-controller/src/test/java/com/iluwatar/AppTest.java @@ -0,0 +1,12 @@ +package com.iluwatar; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/pom.xml b/pom.xml index 7e1566876..d97d0d94c 100644 --- a/pom.xml +++ b/pom.xml @@ -1,5 +1,6 @@ - + 4.0.0 com.iluwatar @@ -64,9 +65,10 @@ thread-pool private-class-data object-pool - dependency-injection - naked-objects - + dependency-injection + naked-objects + front-controller + @@ -88,44 +90,42 @@ - + - - - org.eclipse.m2e - lifecycle-mapping - 1.0.0 - - - - - - org.jacoco - - jacoco-maven-plugin - - - [0.6.2,) - - - prepare-agent - - - - - - - - - - + + + org.eclipse.m2e + lifecycle-mapping + 1.0.0 + + + + + + org.jacoco + + jacoco-maven-plugin + + + [0.6.2,) + + + prepare-agent + + + + + + + + + + @@ -141,26 +141,26 @@ - org.eluder.coveralls - coveralls-maven-plugin - ${coveralls.version} - - jb6wYzxkVvjolD6qOWpzWdcWBzYk2fAmF - - + org.eluder.coveralls + coveralls-maven-plugin + ${coveralls.version} + + jb6wYzxkVvjolD6qOWpzWdcWBzYk2fAmF + + - org.jacoco - jacoco-maven-plugin - ${jacoco.version} - - - prepare-agent - - prepare-agent - - - - + org.jacoco + jacoco-maven-plugin + ${jacoco.version} + + + prepare-agent + + prepare-agent + + + + From c4556561c402f8b336ce5389d14d6d3b0b9fc296 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 12:44:51 +0300 Subject: [PATCH 013/687] #90 Finished the example code --- .../src/main/java/com/iluwatar/App.java | 6 +++- .../com/iluwatar/ApplicationException.java | 8 ++++++ .../main/java/com/iluwatar/ArcherCommand.java | 9 ++++++ .../main/java/com/iluwatar/ArcherView.java | 9 ++++++ .../java/com/iluwatar/CatapultCommand.java | 9 ++++++ .../main/java/com/iluwatar/CatapultView.java | 9 ++++++ .../src/main/java/com/iluwatar/Command.java | 6 ++++ .../java/com/iluwatar/FrontController.java | 28 +++++++++++++++++++ .../java/com/iluwatar/UnknownCommand.java | 9 ++++++ .../src/main/java/com/iluwatar/View.java | 6 ++++ 10 files changed, 98 insertions(+), 1 deletion(-) create mode 100644 front-controller/src/main/java/com/iluwatar/ApplicationException.java create mode 100644 front-controller/src/main/java/com/iluwatar/ArcherCommand.java create mode 100644 front-controller/src/main/java/com/iluwatar/ArcherView.java create mode 100644 front-controller/src/main/java/com/iluwatar/CatapultCommand.java create mode 100644 front-controller/src/main/java/com/iluwatar/CatapultView.java create mode 100644 front-controller/src/main/java/com/iluwatar/Command.java create mode 100644 front-controller/src/main/java/com/iluwatar/FrontController.java create mode 100644 front-controller/src/main/java/com/iluwatar/UnknownCommand.java create mode 100644 front-controller/src/main/java/com/iluwatar/View.java diff --git a/front-controller/src/main/java/com/iluwatar/App.java b/front-controller/src/main/java/com/iluwatar/App.java index b95f9d5b2..91948f24c 100644 --- a/front-controller/src/main/java/com/iluwatar/App.java +++ b/front-controller/src/main/java/com/iluwatar/App.java @@ -1,7 +1,11 @@ package com.iluwatar; public class App { + public static void main(String[] args) { - System.out.println("Hello World!"); + FrontController controller = new FrontController(); + controller.handleRequest("Archer"); + controller.handleRequest("Catapult"); + controller.handleRequest("foobar"); } } diff --git a/front-controller/src/main/java/com/iluwatar/ApplicationException.java b/front-controller/src/main/java/com/iluwatar/ApplicationException.java new file mode 100644 index 000000000..c30c63047 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/ApplicationException.java @@ -0,0 +1,8 @@ +package com.iluwatar; + +public class ApplicationException extends RuntimeException { + + public ApplicationException(Throwable cause) { + super(cause); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/ArcherCommand.java b/front-controller/src/main/java/com/iluwatar/ArcherCommand.java new file mode 100644 index 000000000..2cdb74221 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/ArcherCommand.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class ArcherCommand implements Command { + + @Override + public void process() { + new ArcherView().display(); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/ArcherView.java b/front-controller/src/main/java/com/iluwatar/ArcherView.java new file mode 100644 index 000000000..a8333d160 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/ArcherView.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class ArcherView implements View { + + @Override + public void display() { + System.out.println("Displaying archers"); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/CatapultCommand.java b/front-controller/src/main/java/com/iluwatar/CatapultCommand.java new file mode 100644 index 000000000..767358dd5 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/CatapultCommand.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class CatapultCommand implements Command { + + @Override + public void process() { + new CatapultView().display(); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/CatapultView.java b/front-controller/src/main/java/com/iluwatar/CatapultView.java new file mode 100644 index 000000000..131e3a880 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/CatapultView.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class CatapultView implements View { + + @Override + public void display() { + System.out.println("Displaying catapults"); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/Command.java b/front-controller/src/main/java/com/iluwatar/Command.java new file mode 100644 index 000000000..6e22cd753 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/Command.java @@ -0,0 +1,6 @@ +package com.iluwatar; + +public interface Command { + + void process(); +} diff --git a/front-controller/src/main/java/com/iluwatar/FrontController.java b/front-controller/src/main/java/com/iluwatar/FrontController.java new file mode 100644 index 000000000..26001228a --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/FrontController.java @@ -0,0 +1,28 @@ +package com.iluwatar; + +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 Class getCommandClass(String request) { + Class result; + try { + result = Class.forName("com.iluwatar." + request + "Command"); + } catch (ClassNotFoundException e) { + result = UnknownCommand.class; + } + return result; + } +} diff --git a/front-controller/src/main/java/com/iluwatar/UnknownCommand.java b/front-controller/src/main/java/com/iluwatar/UnknownCommand.java new file mode 100644 index 000000000..ecdc46e71 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/UnknownCommand.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class UnknownCommand implements Command { + + @Override + public void process() { + System.out.println("Error 500"); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/View.java b/front-controller/src/main/java/com/iluwatar/View.java new file mode 100644 index 000000000..7ff7a6888 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/View.java @@ -0,0 +1,6 @@ +package com.iluwatar; + +public interface View { + + void display(); +} From a9fa3046909739b8abc2b949b8574c42c2f31948 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 13:54:07 +0300 Subject: [PATCH 014/687] #90 Added comments for the example code. --- .../src/main/java/com/iluwatar/App.java | 18 ++++++++++++++++++ .../main/java/com/iluwatar/ArcherCommand.java | 5 +++++ .../src/main/java/com/iluwatar/ArcherView.java | 5 +++++ .../java/com/iluwatar/CatapultCommand.java | 5 +++++ .../main/java/com/iluwatar/CatapultView.java | 5 +++++ .../src/main/java/com/iluwatar/Command.java | 5 +++++ .../src/main/java/com/iluwatar/ErrorView.java | 14 ++++++++++++++ .../java/com/iluwatar/FrontController.java | 6 ++++++ .../main/java/com/iluwatar/UnknownCommand.java | 7 ++++++- .../src/main/java/com/iluwatar/View.java | 5 +++++ 10 files changed, 74 insertions(+), 1 deletion(-) create mode 100644 front-controller/src/main/java/com/iluwatar/ErrorView.java diff --git a/front-controller/src/main/java/com/iluwatar/App.java b/front-controller/src/main/java/com/iluwatar/App.java index 91948f24c..9db0c4c7f 100644 --- a/front-controller/src/main/java/com/iluwatar/App.java +++ b/front-controller/src/main/java/com/iluwatar/App.java @@ -1,5 +1,23 @@ package com.iluwatar; +/** + * + * 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 (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 (Command) which then display + * the correct view (View). + * + * In this example we have implemented two views: ArcherView and CatapultView. These + * are displayed by sending correct request to the FrontController object. For example, + * the ArcherView gets displayed when FrontController receives request "Archer". When + * the request is unknown, we display the error view (ErrorView). + * + */ public class App { public static void main(String[] args) { diff --git a/front-controller/src/main/java/com/iluwatar/ArcherCommand.java b/front-controller/src/main/java/com/iluwatar/ArcherCommand.java index 2cdb74221..0b85247c5 100644 --- a/front-controller/src/main/java/com/iluwatar/ArcherCommand.java +++ b/front-controller/src/main/java/com/iluwatar/ArcherCommand.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Command for archers. + * + */ public class ArcherCommand implements Command { @Override diff --git a/front-controller/src/main/java/com/iluwatar/ArcherView.java b/front-controller/src/main/java/com/iluwatar/ArcherView.java index a8333d160..a670dd10d 100644 --- a/front-controller/src/main/java/com/iluwatar/ArcherView.java +++ b/front-controller/src/main/java/com/iluwatar/ArcherView.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * View for archers. + * + */ public class ArcherView implements View { @Override diff --git a/front-controller/src/main/java/com/iluwatar/CatapultCommand.java b/front-controller/src/main/java/com/iluwatar/CatapultCommand.java index 767358dd5..db0a38b40 100644 --- a/front-controller/src/main/java/com/iluwatar/CatapultCommand.java +++ b/front-controller/src/main/java/com/iluwatar/CatapultCommand.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Command for catapults. + * + */ public class CatapultCommand implements Command { @Override diff --git a/front-controller/src/main/java/com/iluwatar/CatapultView.java b/front-controller/src/main/java/com/iluwatar/CatapultView.java index 131e3a880..6459b3b48 100644 --- a/front-controller/src/main/java/com/iluwatar/CatapultView.java +++ b/front-controller/src/main/java/com/iluwatar/CatapultView.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * View for catapults. + * + */ public class CatapultView implements View { @Override diff --git a/front-controller/src/main/java/com/iluwatar/Command.java b/front-controller/src/main/java/com/iluwatar/Command.java index 6e22cd753..657ef58d5 100644 --- a/front-controller/src/main/java/com/iluwatar/Command.java +++ b/front-controller/src/main/java/com/iluwatar/Command.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Commands are the intermediary between requests and views. + * + */ public interface Command { void process(); diff --git a/front-controller/src/main/java/com/iluwatar/ErrorView.java b/front-controller/src/main/java/com/iluwatar/ErrorView.java new file mode 100644 index 000000000..1a91a0d52 --- /dev/null +++ b/front-controller/src/main/java/com/iluwatar/ErrorView.java @@ -0,0 +1,14 @@ +package com.iluwatar; + +/** + * + * View for errors. + * + */ +public class ErrorView implements View { + + @Override + public void display() { + System.out.println("Error 500"); + } +} diff --git a/front-controller/src/main/java/com/iluwatar/FrontController.java b/front-controller/src/main/java/com/iluwatar/FrontController.java index 26001228a..09e90f7ed 100644 --- a/front-controller/src/main/java/com/iluwatar/FrontController.java +++ b/front-controller/src/main/java/com/iluwatar/FrontController.java @@ -1,5 +1,11 @@ package com.iluwatar; +/** + * + * FrontController is the handler class that takes in all the requests and + * renders the correct response. + * + */ public class FrontController { public void handleRequest(String request) { diff --git a/front-controller/src/main/java/com/iluwatar/UnknownCommand.java b/front-controller/src/main/java/com/iluwatar/UnknownCommand.java index ecdc46e71..b3186a514 100644 --- a/front-controller/src/main/java/com/iluwatar/UnknownCommand.java +++ b/front-controller/src/main/java/com/iluwatar/UnknownCommand.java @@ -1,9 +1,14 @@ package com.iluwatar; +/** + * + * Default command in case the mapping is not successful. + * + */ public class UnknownCommand implements Command { @Override public void process() { - System.out.println("Error 500"); + new ErrorView().display(); } } diff --git a/front-controller/src/main/java/com/iluwatar/View.java b/front-controller/src/main/java/com/iluwatar/View.java index 7ff7a6888..6061ed0e5 100644 --- a/front-controller/src/main/java/com/iluwatar/View.java +++ b/front-controller/src/main/java/com/iluwatar/View.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Views are the representations rendered for the user. + * + */ public interface View { void display(); From 600215599c81539455ce8139c4b9ee9b76bfe9d9 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 14:02:41 +0300 Subject: [PATCH 015/687] #90 Added class diagram --- front-controller/etc/front-controller.png | Bin 0 -> 27672 bytes front-controller/etc/front-controller.ucls | 135 +++++++++++++++++++++ 2 files changed, 135 insertions(+) create mode 100644 front-controller/etc/front-controller.png create mode 100644 front-controller/etc/front-controller.ucls diff --git a/front-controller/etc/front-controller.png b/front-controller/etc/front-controller.png new file mode 100644 index 0000000000000000000000000000000000000000..77c14ef019cc2864c159a9600095e7117c479916 GIT binary patch literal 27672 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file From 3fc25a2102b76a2cce5bd10e71ed66fc7a8502b2 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 14:17:01 +0300 Subject: [PATCH 016/687] #90 Added pattern description to README.md --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 986d0dbd1..5154f6db4 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,7 @@ Presentation Tier patterns are the top-most level of the application, this is co * [Model-View-Controller](#model-view-controller) * [Model-View-Presenter](#model-view-presenter) * [Flux](#flux) +* [Front Controller](#front-controller) ### Architectural Patterns @@ -656,6 +657,19 @@ validation and for building to order **Real world examples:** * [Apache Isis](https://isis.apache.org/) +## Front Controller [↑](#list-of-design-patterns) +**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](https://github.com/iluwatar/java-design-patterns/blob/master/front-controller/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 configution portable, you only need to register the handler web server specific way + +**Real world examples:** +* [Apache Struts](https://struts.apache.org/) + # Frequently asked questions From 1371f75e36ce3ce5887242116e6d8166b32b739c Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 14:19:05 +0300 Subject: [PATCH 017/687] #90 Added book reference --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 5154f6db4..000c707c9 100644 --- a/README.md +++ b/README.md @@ -760,6 +760,7 @@ Java-design-patterns project uses [semantic versioning](http://semver.org/) sche * [Trygve Reenskaug - Model-view-controller](http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) * [Flux - Application architecture for building user interfaces](http://facebook.github.io/flux/) * [Richard Pawson - Naked Objects](http://downloads.nakedobjects.net/resources/Pawson%20thesis.pdf) +* [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) From 4a002d9a886b73ddae32a5e3f5197a4683fde9ce Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 14:28:45 +0300 Subject: [PATCH 018/687] Achieved milestone 1.3.0 --- abstract-factory/pom.xml | 2 +- adapter/pom.xml | 2 +- bridge/pom.xml | 2 +- builder/pom.xml | 2 +- callback/pom.xml | 2 +- chain/pom.xml | 2 +- command/pom.xml | 2 +- composite/pom.xml | 2 +- dao/pom.xml | 2 +- decorator/pom.xml | 2 +- dependency-injection/pom.xml | 2 +- double-checked-locking/pom.xml | 2 +- double-dispatch/pom.xml | 2 +- event-aggregator/pom.xml | 2 +- execute-around/pom.xml | 2 +- facade/pom.xml | 2 +- factory-method/pom.xml | 2 +- flux/pom.xml | 2 +- flyweight/pom.xml | 2 +- front-controller/pom.xml | 2 +- intercepting-filter/pom.xml | 2 +- interpreter/pom.xml | 2 +- iterator/pom.xml | 2 +- lazy-loading/pom.xml | 2 +- mediator/pom.xml | 2 +- memento/pom.xml | 2 +- model-view-controller/pom.xml | 2 +- model-view-presenter/pom.xml | 2 +- multiton/pom.xml | 2 +- naked-objects/dom/pom.xml | 2 +- naked-objects/fixture/pom.xml | 2 +- naked-objects/integtests/pom.xml | 2 +- naked-objects/pom.xml | 8 ++++---- naked-objects/webapp/pom.xml | 2 +- null-object/pom.xml | 2 +- object-pool/pom.xml | 2 +- observer/pom.xml | 2 +- poison-pill/pom.xml | 2 +- pom.xml | 2 +- private-class-data/pom.xml | 2 +- property/pom.xml | 2 +- prototype/pom.xml | 2 +- proxy/pom.xml | 2 +- resource-acquisition-is-initialization/pom.xml | 2 +- servant/pom.xml | 2 +- service-layer/pom.xml | 2 +- service-locator/pom.xml | 2 +- singleton/pom.xml | 2 +- specification/pom.xml | 2 +- state/pom.xml | 2 +- strategy/pom.xml | 2 +- template-method/pom.xml | 2 +- thread-pool/pom.xml | 2 +- tolerant-reader/pom.xml | 2 +- visitor/pom.xml | 2 +- 55 files changed, 58 insertions(+), 58 deletions(-) diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml index 434617a85..cf3f42637 100644 --- a/abstract-factory/pom.xml +++ b/abstract-factory/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 abstract-factory diff --git a/adapter/pom.xml b/adapter/pom.xml index 426758057..1a37277fd 100644 --- a/adapter/pom.xml +++ b/adapter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 adapter diff --git a/bridge/pom.xml b/bridge/pom.xml index c40c9ed5c..2c2795b6b 100644 --- a/bridge/pom.xml +++ b/bridge/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 bridge diff --git a/builder/pom.xml b/builder/pom.xml index 0853718ef..eb13d07d4 100644 --- a/builder/pom.xml +++ b/builder/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 builder diff --git a/callback/pom.xml b/callback/pom.xml index 10d054aae..062532d79 100644 --- a/callback/pom.xml +++ b/callback/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 callback diff --git a/chain/pom.xml b/chain/pom.xml index 64d47f946..7dc5da4ef 100644 --- a/chain/pom.xml +++ b/chain/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 chain diff --git a/command/pom.xml b/command/pom.xml index 6a364ad5b..d11137641 100644 --- a/command/pom.xml +++ b/command/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 command diff --git a/composite/pom.xml b/composite/pom.xml index e348dd48a..57511a3fb 100644 --- a/composite/pom.xml +++ b/composite/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 composite diff --git a/dao/pom.xml b/dao/pom.xml index 6f5cd0720..1163a2614 100644 --- a/dao/pom.xml +++ b/dao/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 dao diff --git a/decorator/pom.xml b/decorator/pom.xml index 192c77c78..6ed6a47f2 100644 --- a/decorator/pom.xml +++ b/decorator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 decorator diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml index 8eaee2fe6..85ece56c9 100644 --- a/dependency-injection/pom.xml +++ b/dependency-injection/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 dependency-injection diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml index c5eeb0350..9bfb95b4f 100644 --- a/double-checked-locking/pom.xml +++ b/double-checked-locking/pom.xml @@ -3,7 +3,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 double-checked-locking diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml index 6b6b86ab4..e94961351 100644 --- a/double-dispatch/pom.xml +++ b/double-dispatch/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 double-dispatch diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml index d0f0a8341..56b30d431 100644 --- a/event-aggregator/pom.xml +++ b/event-aggregator/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 event-aggregator diff --git a/execute-around/pom.xml b/execute-around/pom.xml index 24ecb6ed9..b22c98028 100644 --- a/execute-around/pom.xml +++ b/execute-around/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 execute-around diff --git a/facade/pom.xml b/facade/pom.xml index 89b75cd68..50fe9d9fe 100644 --- a/facade/pom.xml +++ b/facade/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 facade diff --git a/factory-method/pom.xml b/factory-method/pom.xml index ac25424eb..e9284bf2a 100644 --- a/factory-method/pom.xml +++ b/factory-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 factory-method diff --git a/flux/pom.xml b/flux/pom.xml index 80bff387f..e146be5e2 100644 --- a/flux/pom.xml +++ b/flux/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 flux diff --git a/flyweight/pom.xml b/flyweight/pom.xml index 68a0c7228..84bc21d64 100644 --- a/flyweight/pom.xml +++ b/flyweight/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 flyweight diff --git a/front-controller/pom.xml b/front-controller/pom.xml index 2327abd69..2eb369395 100644 --- a/front-controller/pom.xml +++ b/front-controller/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 front-controller diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml index d64be4ed3..64c64cac0 100644 --- a/intercepting-filter/pom.xml +++ b/intercepting-filter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 intercepting-filter diff --git a/interpreter/pom.xml b/interpreter/pom.xml index 12e3e0782..39239f05c 100644 --- a/interpreter/pom.xml +++ b/interpreter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 interpreter diff --git a/iterator/pom.xml b/iterator/pom.xml index 2f1445f9f..a0ece2b0d 100644 --- a/iterator/pom.xml +++ b/iterator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 iterator diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml index 7aa3afc23..4d916c29d 100644 --- a/lazy-loading/pom.xml +++ b/lazy-loading/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 lazy-loading diff --git a/mediator/pom.xml b/mediator/pom.xml index e0e8679d2..ad79b61d2 100644 --- a/mediator/pom.xml +++ b/mediator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 mediator diff --git a/memento/pom.xml b/memento/pom.xml index 9f18dcf0b..d970b3a72 100644 --- a/memento/pom.xml +++ b/memento/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 memento diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml index 225c9bb3c..fcd16a133 100644 --- a/model-view-controller/pom.xml +++ b/model-view-controller/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 model-view-controller diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml index cd4de7de2..ab2c3f75f 100644 --- a/model-view-presenter/pom.xml +++ b/model-view-presenter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 model-view-presenter model-view-presenter diff --git a/multiton/pom.xml b/multiton/pom.xml index 7803db40b..45322e26d 100644 --- a/multiton/pom.xml +++ b/multiton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 multiton diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index e3c1f5274..efa96fc51 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.2.0 + 1.3.0 naked-objects-dom diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml index 35587fe58..361c4af2c 100644 --- a/naked-objects/fixture/pom.xml +++ b/naked-objects/fixture/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.2.0 + 1.3.0 naked-objects-fixture diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index 6e7aac0fc..52de9e9ee 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.2.0 + 1.3.0 naked-objects-integtests diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index 51ad45540..a46b07060 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -15,7 +15,7 @@ java-design-patterns com.iluwatar - 1.2.0 + 1.3.0 naked-objects @@ -359,17 +359,17 @@ ${project.groupId} naked-objects-dom - 1.2.0 + 1.3.0 ${project.groupId} naked-objects-fixture - 1.2.0 + 1.3.0 ${project.groupId} naked-objects-webapp - 1.2.0 + 1.3.0 diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index 3126ecffc..cd6ea43fa 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.2.0 + 1.3.0 naked-objects-webapp diff --git a/null-object/pom.xml b/null-object/pom.xml index 9992adbc3..4a233526d 100644 --- a/null-object/pom.xml +++ b/null-object/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 null-object diff --git a/object-pool/pom.xml b/object-pool/pom.xml index fc3d176b7..bb481869b 100644 --- a/object-pool/pom.xml +++ b/object-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 object-pool diff --git a/observer/pom.xml b/observer/pom.xml index 0aed8eff8..c9a157f4b 100644 --- a/observer/pom.xml +++ b/observer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 observer diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml index 49065ab5a..9478519a0 100644 --- a/poison-pill/pom.xml +++ b/poison-pill/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 poison-pill diff --git a/pom.xml b/pom.xml index d97d0d94c..4c6d44cf9 100644 --- a/pom.xml +++ b/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 pom diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml index ea4a67328..e76321352 100644 --- a/private-class-data/pom.xml +++ b/private-class-data/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 private-class-data diff --git a/property/pom.xml b/property/pom.xml index 6cd9e05fe..a719e5c2f 100644 --- a/property/pom.xml +++ b/property/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 property diff --git a/prototype/pom.xml b/prototype/pom.xml index 1752c069b..d4011872c 100644 --- a/prototype/pom.xml +++ b/prototype/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 prototype diff --git a/proxy/pom.xml b/proxy/pom.xml index 64fee37f6..8e8f54a5a 100644 --- a/proxy/pom.xml +++ b/proxy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 proxy diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml index d0f51a252..6470c9c40 100644 --- a/resource-acquisition-is-initialization/pom.xml +++ b/resource-acquisition-is-initialization/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 resource-acquisition-is-initialization diff --git a/servant/pom.xml b/servant/pom.xml index 8a2a2cca7..94d072220 100644 --- a/servant/pom.xml +++ b/servant/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 servant diff --git a/service-layer/pom.xml b/service-layer/pom.xml index 37e66fad8..fe8d811c5 100644 --- a/service-layer/pom.xml +++ b/service-layer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 service-layer diff --git a/service-locator/pom.xml b/service-locator/pom.xml index 8b587e917..fa3b22aea 100644 --- a/service-locator/pom.xml +++ b/service-locator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 service-locator diff --git a/singleton/pom.xml b/singleton/pom.xml index 7aa7b902a..017e34ba0 100644 --- a/singleton/pom.xml +++ b/singleton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 singleton diff --git a/specification/pom.xml b/specification/pom.xml index 322d80d2d..f284f0efc 100644 --- a/specification/pom.xml +++ b/specification/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 specification diff --git a/state/pom.xml b/state/pom.xml index a948e0bf8..8f46effc7 100644 --- a/state/pom.xml +++ b/state/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 state diff --git a/strategy/pom.xml b/strategy/pom.xml index 5ceab5e61..59fefc1f8 100644 --- a/strategy/pom.xml +++ b/strategy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 strategy diff --git a/template-method/pom.xml b/template-method/pom.xml index 91edfabc3..12842fe28 100644 --- a/template-method/pom.xml +++ b/template-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 template-method diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml index a75932f08..4b8fb3d75 100644 --- a/thread-pool/pom.xml +++ b/thread-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 thread-pool diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml index de9372911..d509c13e4 100644 --- a/tolerant-reader/pom.xml +++ b/tolerant-reader/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 tolerant-reader diff --git a/visitor/pom.xml b/visitor/pom.xml index 97b57bc19..13697e160 100644 --- a/visitor/pom.xml +++ b/visitor/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.2.0 + 1.3.0 visitor From 215af05853348d68f05a0e814092aee84123466d Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 19 Jul 2015 14:34:28 +0300 Subject: [PATCH 019/687] Update Tolerant Reader class diagram. --- tolerant-reader/etc/tolerant-reader.png | Bin 24123 -> 20514 bytes tolerant-reader/etc/tolerant-reader.ucls | 42 ++++++++++++----------- 2 files changed, 22 insertions(+), 20 deletions(-) diff --git a/tolerant-reader/etc/tolerant-reader.png b/tolerant-reader/etc/tolerant-reader.png index 396b2559bdc959d2712efe97faaea657c06efd88..45f0302a2c7bd80c975f20ed67eb700d0224e368 100644 GIT binary patch literal 20514 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%0APyX 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 literal 24123 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 diff --git a/tolerant-reader/etc/tolerant-reader.ucls b/tolerant-reader/etc/tolerant-reader.ucls index 1c9065583..92e069f8e 100644 --- a/tolerant-reader/etc/tolerant-reader.ucls +++ b/tolerant-reader/etc/tolerant-reader.ucls @@ -1,45 +1,47 @@ - - + + - - + + - - + + - - - - - - - - + + + + + + + + + - + From f7402b8c19db205d95624cb42fffa12c6dd7daa0 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 20 Jul 2015 17:13:21 +0300 Subject: [PATCH 020/687] #104 Workaround to re-enable code coverage analysis --- pom.xml | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/pom.xml b/pom.xml index 4c6d44cf9..2cbc41b71 100644 --- a/pom.xml +++ b/pom.xml @@ -152,6 +152,13 @@ org.jacoco jacoco-maven-plugin ${jacoco.version} + + + + + domainapp/dom/modules/simple/QSimpleObject.class + + prepare-agent From cd07c5cf6053c3b140fd88f923e93fadfedd8ff6 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 20 Jul 2015 19:11:19 +0300 Subject: [PATCH 021/687] #55 Added skeleton for Repository example --- pom.xml | 8 ++++---- repository/pom.xml | 19 +++++++++++++++++++ .../src/main/java/com/iluwatar/App.java | 8 ++++++++ .../src/test/java/com/iluwatar/AppTest.java | 12 ++++++++++++ 4 files changed, 43 insertions(+), 4 deletions(-) create mode 100644 repository/pom.xml create mode 100644 repository/src/main/java/com/iluwatar/App.java create mode 100644 repository/src/test/java/com/iluwatar/AppTest.java diff --git a/pom.xml b/pom.xml index 2cbc41b71..023656abf 100644 --- a/pom.xml +++ b/pom.xml @@ -1,6 +1,5 @@ - + 4.0.0 com.iluwatar @@ -68,7 +67,8 @@ dependency-injection naked-objects front-controller - + repository + @@ -119,7 +119,7 @@ - + diff --git a/repository/pom.xml b/repository/pom.xml new file mode 100644 index 000000000..a950d3abb --- /dev/null +++ b/repository/pom.xml @@ -0,0 +1,19 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.3.0 + + repository + + + junit + junit + test + + + diff --git a/repository/src/main/java/com/iluwatar/App.java b/repository/src/main/java/com/iluwatar/App.java new file mode 100644 index 000000000..9d4f497d2 --- /dev/null +++ b/repository/src/main/java/com/iluwatar/App.java @@ -0,0 +1,8 @@ +package com.iluwatar; + +public class App { + + public static void main( String[] args ) { + System.out.println( "Hello World!" ); + } +} diff --git a/repository/src/test/java/com/iluwatar/AppTest.java b/repository/src/test/java/com/iluwatar/AppTest.java new file mode 100644 index 000000000..6db5ad214 --- /dev/null +++ b/repository/src/test/java/com/iluwatar/AppTest.java @@ -0,0 +1,12 @@ +package com.iluwatar; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 73606dae1a45cea3ca6391137d79f4891daf88a0 Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Mon, 20 Jul 2015 22:55:39 +0300 Subject: [PATCH 022/687] #68: Implementation of Async Method Invocation pattern --- async-method-invocation/pom.xml | 18 ++++ .../iluwatar/async/method/invocation/App.java | 50 +++++++++ .../method/invocation/AsyncCallback.java | 9 ++ .../method/invocation/AsyncExecutor.java | 14 +++ .../async/method/invocation/AsyncResult.java | 12 +++ .../invocation/ThreadAsyncExecutor.java | 101 ++++++++++++++++++ .../async/method/invocation/AppTest.java | 13 +++ pom.xml | 1 + 8 files changed, 218 insertions(+) create mode 100644 async-method-invocation/pom.xml create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java create mode 100644 async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml new file mode 100644 index 000000000..be932bca5 --- /dev/null +++ b/async-method-invocation/pom.xml @@ -0,0 +1,18 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.3.0 + + async-method-invocation + + + junit + junit + test + + + diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java new file mode 100644 index 000000000..f59f831b2 --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java @@ -0,0 +1,50 @@ +package com.iluwatar.async.method.invocation; + +import java.util.concurrent.Callable; + +public class App { + + public static void main(String[] args) throws Exception { + AsyncExecutor executor = new ThreadAsyncExecutor(); + 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")); + + Thread.sleep(350); // Oh boy I'm working hard here + log("Some hard work done"); + + Integer result1 = executor.endProcess(asyncResult1); + String result2 = executor.endProcess(asyncResult2); + Long result3 = executor.endProcess(asyncResult3); + asyncResult4.await(); + asyncResult5.await(); + + log("Result 1: " + result1); + log("Result 2: " + result2); + log("Result 3: " + result3); + } + + private static Callable lazyval(T value, long delayMillis) { + return () -> { + Thread.sleep(delayMillis); + log("Task completed with: " + value); + return value; + }; + } + + 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) { + System.out.println(String.format("[%1$-10s] - %2$s", Thread.currentThread().getName(), msg)); + } +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java new file mode 100644 index 000000000..0477f70e1 --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java @@ -0,0 +1,9 @@ +package com.iluwatar.async.method.invocation; + +import java.util.Optional; + +public interface AsyncCallback { + + void onComplete(T value, Optional ex); + +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java new file mode 100644 index 000000000..dd23a8bfb --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java @@ -0,0 +1,14 @@ +package com.iluwatar.async.method.invocation; + +import java.util.concurrent.Callable; +import java.util.concurrent.ExecutionException; + +public interface AsyncExecutor { + + AsyncResult startProcess(Callable task); + + AsyncResult startProcess(Callable task, AsyncCallback callback); + + T endProcess(AsyncResult asyncResult) throws ExecutionException, InterruptedException; + +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java new file mode 100644 index 000000000..5bf6145b8 --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java @@ -0,0 +1,12 @@ +package com.iluwatar.async.method.invocation; + +import java.util.concurrent.ExecutionException; + +public interface AsyncResult { + + boolean isCompleted(); + + T getValue() throws ExecutionException; + + void await() throws InterruptedException; +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java new file mode 100644 index 000000000..b368e284d --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java @@ -0,0 +1,101 @@ +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; + +public class ThreadAsyncExecutor implements AsyncExecutor { + + 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()) { + return asyncResult.getValue(); + } else { + asyncResult.await(); + return asyncResult.getValue(); + } + } + + 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); + } + + void setValue(T value) { + this.value = value; + this.state = COMPLETED; + this.callback.ifPresent(ac -> ac.onComplete(value, Optional.empty())); + synchronized (lock) { + lock.notifyAll(); + } + } + + 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(); + } + } + } + } +} diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java new file mode 100644 index 000000000..989fa6d1d --- /dev/null +++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java @@ -0,0 +1,13 @@ +package com.iluwatar.async.method.invocation; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() throws Exception { + String[] args = {}; + App.main(args); + } + +} diff --git a/pom.xml b/pom.xml index 2cbc41b71..fe92fd404 100644 --- a/pom.xml +++ b/pom.xml @@ -68,6 +68,7 @@ dependency-injection naked-objects front-controller + async-method-invocation From 064aa26d444f7b43999a9615dcb2453ec2451414 Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Tue, 21 Jul 2015 00:28:24 +0300 Subject: [PATCH 023/687] #68: Javadocs. --- .../iluwatar/async/method/invocation/App.java | 52 +++++++++++++++++++ .../method/invocation/AsyncCallback.java | 6 +++ .../method/invocation/AsyncExecutor.java | 23 ++++++++ .../async/method/invocation/AsyncResult.java | 17 ++++++ .../invocation/ThreadAsyncExecutor.java | 24 +++++++++ 5 files changed, 122 insertions(+) diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java index f59f831b2..de4dfe926 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java @@ -2,30 +2,76 @@ package com.iluwatar.async.method.invocation; 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 { 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); @@ -34,6 +80,12 @@ public class App { }; } + /** + * 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()) { diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java index 0477f70e1..067b79d43 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java @@ -4,6 +4,12 @@ import java.util.Optional; 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); } diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java index dd23a8bfb..4bf837a4f 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java @@ -5,10 +5,33 @@ import java.util.concurrent.ExecutionException; 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; } diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java index 5bf6145b8..689095e9d 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java @@ -4,9 +4,26 @@ import java.util.concurrent.ExecutionException; 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; } diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java index b368e284d..18b27c3b6 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java @@ -5,8 +5,12 @@ 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 @@ -37,6 +41,14 @@ public class ThreadAsyncExecutor implements AsyncExecutor { } } + /** + * 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; @@ -55,6 +67,12 @@ public class ThreadAsyncExecutor implements AsyncExecutor { 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; @@ -64,6 +82,12 @@ public class ThreadAsyncExecutor implements AsyncExecutor { } } + /** + * 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; From b22d2ddf8992f5c92c854c2b71f6118bef3309e4 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 21 Jul 2015 21:11:22 +0300 Subject: [PATCH 024/687] #55 Repository example skeleton --- repository/pom.xml | 15 +++++ .../src/main/java/com/iluwatar/App.java | 52 ++++++++++++++-- .../src/main/java/com/iluwatar/Person.java | 59 +++++++++++++++++++ .../src/main/java/com/iluwatar/PersonDao.java | 17 ++++++ .../main/resources/META-INF/persistence.xml | 8 +++ .../src/main/resources/applicationContext.xml | 51 ++++++++++++++++ 6 files changed, 198 insertions(+), 4 deletions(-) create mode 100644 repository/src/main/java/com/iluwatar/Person.java create mode 100644 repository/src/main/java/com/iluwatar/PersonDao.java create mode 100644 repository/src/main/resources/META-INF/persistence.xml create mode 100644 repository/src/main/resources/applicationContext.xml diff --git a/repository/pom.xml b/repository/pom.xml index a950d3abb..ddd69942f 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -15,5 +15,20 @@ junit test + + org.springframework.data + spring-data-jpa + 1.7.1.RELEASE + + + org.hibernate + hibernate-entitymanager + 5.0.0.CR2 + + + org.postgresql + postgresql + 9.4-1200-jdbc4 + diff --git a/repository/src/main/java/com/iluwatar/App.java b/repository/src/main/java/com/iluwatar/App.java index 9d4f497d2..0408cd7c2 100644 --- a/repository/src/main/java/com/iluwatar/App.java +++ b/repository/src/main/java/com/iluwatar/App.java @@ -1,8 +1,52 @@ package com.iluwatar; +import java.util.List; + +import org.springframework.context.support.ClassPathXmlApplicationContext; + +/** + * Standalone application with Spring Data JPA, Hibernate and Maven + * + * @author DevCrumb.com + */ public class App { - - public static void main( String[] args ) { - System.out.println( "Hello World!" ); - } + public static void main(String[] args) { + ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( + "applicationContext.xml"); + PersonDao dao = context.getBean(PersonDao.class); + + Person peter = new Person("Peter", "Sagan"); + Person nasta = new Person("Nasta", "Kuzminova"); + + // Add new Person records + dao.save(peter); + dao.save(nasta); + + // Count Person records + System.out.println("Count Person records: " + dao.count()); + + // Print all records + List persons = (List) dao.findAll(); + for (Person person : persons) { + System.out.println(person); + } + + // Find Person by surname + System.out.println("Find by surname 'Sagan': " + dao.findBySurname("Sagan")); + + // Update Person + nasta.setName("Barbora"); + nasta.setSurname("Spotakova"); + dao.save(nasta); + + System.out.println("Find by id 2: " + dao.findOne(2L)); + + // Remove record from Person + dao.delete(2L); + + // And finally count records + System.out.println("Count Person records: " + dao.count()); + + context.close(); + } } diff --git a/repository/src/main/java/com/iluwatar/Person.java b/repository/src/main/java/com/iluwatar/Person.java new file mode 100644 index 000000000..bd2ebf43a --- /dev/null +++ b/repository/src/main/java/com/iluwatar/Person.java @@ -0,0 +1,59 @@ +package com.iluwatar; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; + +/** + * Person entity + * + * @author DevCrumb.com + */ +@Entity +public class Person { + + @Id + @GeneratedValue + private Long id; + private String name; + private String surname; + + public Person() { + } + + public Person(String name, String surname) { + this.name = name; + this.surname = surname; + } + + 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; + } + + @Override + public String toString() { + return "Person [id=" + id + ", name=" + name + ", surname=" + surname + + "]"; + } + +} diff --git a/repository/src/main/java/com/iluwatar/PersonDao.java b/repository/src/main/java/com/iluwatar/PersonDao.java new file mode 100644 index 000000000..66b625782 --- /dev/null +++ b/repository/src/main/java/com/iluwatar/PersonDao.java @@ -0,0 +1,17 @@ +package com.iluwatar; + +import java.util.List; + +import org.springframework.data.repository.CrudRepository; +import org.springframework.stereotype.Repository; + +/** + * Person dao interface + * + * @author DevCrumb.com + */ +@Repository +public interface PersonDao extends CrudRepository { + + public List findBySurname(String surname); +} diff --git a/repository/src/main/resources/META-INF/persistence.xml b/repository/src/main/resources/META-INF/persistence.xml new file mode 100644 index 000000000..4c1478e55 --- /dev/null +++ b/repository/src/main/resources/META-INF/persistence.xml @@ -0,0 +1,8 @@ + + + + + + \ No newline at end of file diff --git a/repository/src/main/resources/applicationContext.xml b/repository/src/main/resources/applicationContext.xml new file mode 100644 index 000000000..c7c4179d2 --- /dev/null +++ b/repository/src/main/resources/applicationContext.xml @@ -0,0 +1,51 @@ + + + + + + + + + org.postgresql.Driver + + + jdbc:postgresql://localhost:5432/postgres + + + postgres + + + ile666 + + + + + + + + + + + + org.hibernate.dialect.PostgreSQLDialect + false + false + create + + + + + + + + + \ No newline at end of file From 936d4c061444789a1e289ad803940d80c82e4a8f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 21 Jul 2015 21:11:33 +0300 Subject: [PATCH 025/687] #55 Update Hibernate version --- pom.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pom.xml b/pom.xml index 023656abf..5a0e02095 100644 --- a/pom.xml +++ b/pom.xml @@ -9,7 +9,7 @@ UTF-8 - 5.0.0.Beta1 + 5.0.0.CR2 1.4.187 4.12 3.0 @@ -72,11 +72,11 @@ - + com.h2database h2 From 581ce4170e578aa114285b222980112c8298e1fc Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 21 Jul 2015 21:17:32 +0300 Subject: [PATCH 026/687] #55 Move spring-data dependency to parent & update version --- pom.xml | 15 +++++++++++++-- repository/pom.xml | 2 -- 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/pom.xml b/pom.xml index 5a0e02095..19ba0db00 100644 --- a/pom.xml +++ b/pom.xml @@ -10,6 +10,7 @@ UTF-8 5.0.0.CR2 + 1.8.1.RELEASE 1.4.187 4.12 3.0 @@ -72,11 +73,21 @@ - + + + org.hibernate + hibernate-entitymanager + ${hibernate.version} + + + org.springframework.data + spring-data-jpa + ${spring-data.version} + com.h2database h2 diff --git a/repository/pom.xml b/repository/pom.xml index ddd69942f..573f49d1e 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -18,12 +18,10 @@ org.springframework.data spring-data-jpa - 1.7.1.RELEASE org.hibernate hibernate-entitymanager - 5.0.0.CR2 org.postgresql From 9b4db0a5036454e54443ae56c6c39096ef1a23b8 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 21 Jul 2015 23:23:36 +0300 Subject: [PATCH 027/687] #55 H2 database taken to use in the example code --- repository/pom.xml | 9 +++ .../src/main/java/com/iluwatar/App.java | 5 -- .../src/main/java/com/iluwatar/Person.java | 5 -- .../src/main/java/com/iluwatar/PersonDao.java | 5 -- .../main/resources/META-INF/persistence.xml | 6 +- .../src/main/resources/applicationContext.xml | 59 ++++++++----------- 6 files changed, 36 insertions(+), 53 deletions(-) diff --git a/repository/pom.xml b/repository/pom.xml index 573f49d1e..386a21c52 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -28,5 +28,14 @@ postgresql 9.4-1200-jdbc4 + + commons-dbcp + commons-dbcp + 1.4 + + + com.h2database + h2 + diff --git a/repository/src/main/java/com/iluwatar/App.java b/repository/src/main/java/com/iluwatar/App.java index 0408cd7c2..3dac5647e 100644 --- a/repository/src/main/java/com/iluwatar/App.java +++ b/repository/src/main/java/com/iluwatar/App.java @@ -4,11 +4,6 @@ import java.util.List; import org.springframework.context.support.ClassPathXmlApplicationContext; -/** - * Standalone application with Spring Data JPA, Hibernate and Maven - * - * @author DevCrumb.com - */ public class App { public static void main(String[] args) { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( diff --git a/repository/src/main/java/com/iluwatar/Person.java b/repository/src/main/java/com/iluwatar/Person.java index bd2ebf43a..22495b926 100644 --- a/repository/src/main/java/com/iluwatar/Person.java +++ b/repository/src/main/java/com/iluwatar/Person.java @@ -4,11 +4,6 @@ import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; -/** - * Person entity - * - * @author DevCrumb.com - */ @Entity public class Person { diff --git a/repository/src/main/java/com/iluwatar/PersonDao.java b/repository/src/main/java/com/iluwatar/PersonDao.java index 66b625782..6b0c0081a 100644 --- a/repository/src/main/java/com/iluwatar/PersonDao.java +++ b/repository/src/main/java/com/iluwatar/PersonDao.java @@ -5,11 +5,6 @@ import java.util.List; import org.springframework.data.repository.CrudRepository; import org.springframework.stereotype.Repository; -/** - * Person dao interface - * - * @author DevCrumb.com - */ @Repository public interface PersonDao extends CrudRepository { diff --git a/repository/src/main/resources/META-INF/persistence.xml b/repository/src/main/resources/META-INF/persistence.xml index 4c1478e55..0aded0dbd 100644 --- a/repository/src/main/resources/META-INF/persistence.xml +++ b/repository/src/main/resources/META-INF/persistence.xml @@ -1,8 +1,8 @@ + xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"> - \ No newline at end of file + diff --git a/repository/src/main/resources/applicationContext.xml b/repository/src/main/resources/applicationContext.xml index c7c4179d2..d68207f31 100644 --- a/repository/src/main/resources/applicationContext.xml +++ b/repository/src/main/resources/applicationContext.xml @@ -7,45 +7,34 @@ xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.0.xsd"> - + - - - - org.postgresql.Driver - - - jdbc:postgresql://localhost:5432/postgres - - - postgres - - - ile666 - - - - - - - - - - - - org.hibernate.dialect.PostgreSQLDialect - false - false - create - - - - \ No newline at end of file + + + + + + + + + + + + + + + + + + + + + From 918e489f9bf855bde0f36e99525e74d998b0e4b9 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 00:17:32 +0300 Subject: [PATCH 028/687] #55 Clean up example dependencies --- pom.xml | 24 +++++++++++++++++------- repository/pom.xml | 16 +++++----------- 2 files changed, 22 insertions(+), 18 deletions(-) diff --git a/pom.xml b/pom.xml index 19ba0db00..402a1eb2c 100644 --- a/pom.xml +++ b/pom.xml @@ -1,5 +1,6 @@ - + 4.0.0 com.iluwatar @@ -16,6 +17,7 @@ 3.0 3.1.0 0.7.2.201409121644 + 1.4 abstract-factory @@ -68,12 +70,12 @@ dependency-injection naked-objects front-controller - repository - + repository + - + org.hibernate hibernate-core ${hibernate.version} @@ -93,6 +95,11 @@ h2 ${h2.version} + + commons-dbcp + commons-dbcp + ${commons-dbcp.version} + junit junit @@ -130,7 +137,7 @@ - + @@ -163,8 +170,11 @@ org.jacoco jacoco-maven-plugin ${jacoco.version} - - + + domainapp/dom/modules/simple/QSimpleObject.class diff --git a/repository/pom.xml b/repository/pom.xml index 386a21c52..f4d1096d6 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -10,11 +10,6 @@ repository - - junit - junit - test - org.springframework.data spring-data-jpa @@ -23,19 +18,18 @@ org.hibernate hibernate-entitymanager - - org.postgresql - postgresql - 9.4-1200-jdbc4 - commons-dbcp commons-dbcp - 1.4 com.h2database h2 + + junit + junit + test + From c6cf96b641e7564e3fc7d787cb9f1ce59c312efc Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 00:31:50 +0300 Subject: [PATCH 029/687] #55 Changed Hibernate to create-drop mode --- repository/src/main/java/com/iluwatar/App.java | 1 + repository/src/main/resources/applicationContext.xml | 3 +-- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/repository/src/main/java/com/iluwatar/App.java b/repository/src/main/java/com/iluwatar/App.java index 3dac5647e..748ed286e 100644 --- a/repository/src/main/java/com/iluwatar/App.java +++ b/repository/src/main/java/com/iluwatar/App.java @@ -5,6 +5,7 @@ import java.util.List; import org.springframework.context.support.ClassPathXmlApplicationContext; public class App { + public static void main(String[] args) { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( "applicationContext.xml"); diff --git a/repository/src/main/resources/applicationContext.xml b/repository/src/main/resources/applicationContext.xml index d68207f31..3fe15b2f6 100644 --- a/repository/src/main/resources/applicationContext.xml +++ b/repository/src/main/resources/applicationContext.xml @@ -8,7 +8,6 @@ http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.0.xsd"> - @@ -33,7 +32,7 @@ - + From 1c24f80f053af4341a7b37955ad9f201252b2962 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 00:58:22 +0300 Subject: [PATCH 030/687] #55 Commented the Repository example code --- repository/src/main/java/com/iluwatar/App.java | 15 +++++++++++++++ repository/src/main/java/com/iluwatar/Person.java | 6 +++++- .../src/main/java/com/iluwatar/PersonDao.java | 5 +++++ 3 files changed, 25 insertions(+), 1 deletion(-) diff --git a/repository/src/main/java/com/iluwatar/App.java b/repository/src/main/java/com/iluwatar/App.java index 748ed286e..ed7cadc4d 100644 --- a/repository/src/main/java/com/iluwatar/App.java +++ b/repository/src/main/java/com/iluwatar/App.java @@ -4,6 +4,21 @@ import java.util.List; 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 Person + * domain object. Using the PersonDao we perform CRUD operations on the entity. Underneath we have + * configured in-memory H2 database for which schema is created and dropped on each run. + * + */ public class App { public static void main(String[] args) { diff --git a/repository/src/main/java/com/iluwatar/Person.java b/repository/src/main/java/com/iluwatar/Person.java index 22495b926..d3fadeb89 100644 --- a/repository/src/main/java/com/iluwatar/Person.java +++ b/repository/src/main/java/com/iluwatar/Person.java @@ -4,6 +4,11 @@ import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; +/** + * + * Person entity + * + */ @Entity public class Person { @@ -50,5 +55,4 @@ public class Person { return "Person [id=" + id + ", name=" + name + ", surname=" + surname + "]"; } - } diff --git a/repository/src/main/java/com/iluwatar/PersonDao.java b/repository/src/main/java/com/iluwatar/PersonDao.java index 6b0c0081a..f59bfa292 100644 --- a/repository/src/main/java/com/iluwatar/PersonDao.java +++ b/repository/src/main/java/com/iluwatar/PersonDao.java @@ -5,6 +5,11 @@ import java.util.List; import org.springframework.data.repository.CrudRepository; import org.springframework.stereotype.Repository; +/** + * + * Person repository + * + */ @Repository public interface PersonDao extends CrudRepository { From a290c1af136ba219c3f5d9320159a8b8996bd796 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 01:00:20 +0300 Subject: [PATCH 031/687] #55 Added class diagram --- repository/etc/repository.png | Bin 0 -> 8827 bytes repository/etc/repository.ucls | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 32 insertions(+) create mode 100644 repository/etc/repository.png create mode 100644 repository/etc/repository.ucls diff --git a/repository/etc/repository.png b/repository/etc/repository.png new file mode 100644 index 0000000000000000000000000000000000000000..76adc34c4bb9ba8fcdf95f39c017f9499a3b8e0b GIT binary patch literal 8827 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 literal 0 HcmV?d00001 diff --git a/repository/etc/repository.ucls b/repository/etc/repository.ucls new file mode 100644 index 000000000..6a10449d8 --- /dev/null +++ b/repository/etc/repository.ucls @@ -0,0 +1,32 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file From 9040c8bec68f34a3377211ecfbd0ad8899ae7392 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 01:15:30 +0300 Subject: [PATCH 032/687] #55 Added Repository description to README.md --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index 000c707c9..ac0614c8b 100644 --- a/README.md +++ b/README.md @@ -88,6 +88,7 @@ An architectural pattern is a general, reusable solution to a commonly occurring * [Data Access Object](#dao) * [Service Layer](#service-layer) * [Naked Objects](#naked-objects) +* [Repository](#repository) ### Integration Patterns @@ -670,6 +671,20 @@ validation and for building to order **Real world examples:** * [Apache Struts](https://struts.apache.org/) +## Repository [↑](#list-of-design-patterns) +**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](https://github.com/iluwatar/java-design-patterns/blob/master/repository/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/) + # Frequently asked questions From 6b11329ae07330d6f1310edf3bffc0d4d4f0b6ee Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 01:17:42 +0300 Subject: [PATCH 033/687] #55 Added book reference --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index ac0614c8b..19cc195ef 100644 --- a/README.md +++ b/README.md @@ -776,6 +776,7 @@ Java-design-patterns project uses [semantic versioning](http://semver.org/) sche * [Flux - Application architecture for building user interfaces](http://facebook.github.io/flux/) * [Richard Pawson - Naked Objects](http://downloads.nakedobjects.net/resources/Pawson%20thesis.pdf) * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) +* [Spring Data](http://www.amazon.com/Spring-Data-Mark-Pollack/dp/1449323952/ref=sr_1_1) From d3642cc94c2d1e7e6a44e846dea9468a6fc71ab7 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 01:26:48 +0300 Subject: [PATCH 034/687] Milestone 1.4.0 achieved --- abstract-factory/pom.xml | 2 +- adapter/pom.xml | 2 +- bridge/pom.xml | 2 +- builder/pom.xml | 2 +- callback/pom.xml | 2 +- chain/pom.xml | 2 +- command/pom.xml | 2 +- composite/pom.xml | 2 +- dao/pom.xml | 2 +- decorator/pom.xml | 2 +- dependency-injection/pom.xml | 2 +- double-checked-locking/pom.xml | 2 +- double-dispatch/pom.xml | 2 +- event-aggregator/pom.xml | 2 +- execute-around/pom.xml | 2 +- facade/pom.xml | 2 +- factory-method/pom.xml | 2 +- flux/pom.xml | 2 +- flyweight/pom.xml | 2 +- front-controller/pom.xml | 2 +- intercepting-filter/pom.xml | 2 +- interpreter/pom.xml | 2 +- iterator/pom.xml | 2 +- lazy-loading/pom.xml | 2 +- mediator/pom.xml | 2 +- memento/pom.xml | 2 +- model-view-controller/pom.xml | 2 +- model-view-presenter/pom.xml | 2 +- multiton/pom.xml | 2 +- naked-objects/dom/pom.xml | 2 +- naked-objects/fixture/pom.xml | 2 +- naked-objects/integtests/pom.xml | 2 +- naked-objects/pom.xml | 8 ++++---- naked-objects/webapp/pom.xml | 2 +- null-object/pom.xml | 2 +- object-pool/pom.xml | 2 +- observer/pom.xml | 2 +- poison-pill/pom.xml | 2 +- pom.xml | 2 +- private-class-data/pom.xml | 2 +- property/pom.xml | 2 +- prototype/pom.xml | 2 +- proxy/pom.xml | 2 +- repository/pom.xml | 2 +- resource-acquisition-is-initialization/pom.xml | 2 +- servant/pom.xml | 2 +- service-layer/pom.xml | 2 +- service-locator/pom.xml | 2 +- singleton/pom.xml | 2 +- specification/pom.xml | 2 +- state/pom.xml | 2 +- strategy/pom.xml | 2 +- template-method/pom.xml | 2 +- thread-pool/pom.xml | 2 +- tolerant-reader/pom.xml | 2 +- visitor/pom.xml | 2 +- 56 files changed, 59 insertions(+), 59 deletions(-) diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml index cf3f42637..0e3be76d5 100644 --- a/abstract-factory/pom.xml +++ b/abstract-factory/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 abstract-factory diff --git a/adapter/pom.xml b/adapter/pom.xml index 1a37277fd..a0f738f34 100644 --- a/adapter/pom.xml +++ b/adapter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 adapter diff --git a/bridge/pom.xml b/bridge/pom.xml index 2c2795b6b..d633718db 100644 --- a/bridge/pom.xml +++ b/bridge/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 bridge diff --git a/builder/pom.xml b/builder/pom.xml index eb13d07d4..9649f8454 100644 --- a/builder/pom.xml +++ b/builder/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 builder diff --git a/callback/pom.xml b/callback/pom.xml index 062532d79..89759e6d8 100644 --- a/callback/pom.xml +++ b/callback/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 callback diff --git a/chain/pom.xml b/chain/pom.xml index 7dc5da4ef..da67b2505 100644 --- a/chain/pom.xml +++ b/chain/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 chain diff --git a/command/pom.xml b/command/pom.xml index d11137641..ae5d88f2d 100644 --- a/command/pom.xml +++ b/command/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 command diff --git a/composite/pom.xml b/composite/pom.xml index 57511a3fb..c2842b45b 100644 --- a/composite/pom.xml +++ b/composite/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 composite diff --git a/dao/pom.xml b/dao/pom.xml index 1163a2614..505925553 100644 --- a/dao/pom.xml +++ b/dao/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 dao diff --git a/decorator/pom.xml b/decorator/pom.xml index 6ed6a47f2..a44c99c71 100644 --- a/decorator/pom.xml +++ b/decorator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 decorator diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml index 85ece56c9..984a5015c 100644 --- a/dependency-injection/pom.xml +++ b/dependency-injection/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 dependency-injection diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml index 9bfb95b4f..48a18fe95 100644 --- a/double-checked-locking/pom.xml +++ b/double-checked-locking/pom.xml @@ -3,7 +3,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 double-checked-locking diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml index e94961351..aba8ab47c 100644 --- a/double-dispatch/pom.xml +++ b/double-dispatch/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 double-dispatch diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml index 56b30d431..28f508700 100644 --- a/event-aggregator/pom.xml +++ b/event-aggregator/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 event-aggregator diff --git a/execute-around/pom.xml b/execute-around/pom.xml index b22c98028..039d6666f 100644 --- a/execute-around/pom.xml +++ b/execute-around/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 execute-around diff --git a/facade/pom.xml b/facade/pom.xml index 50fe9d9fe..40f732f8e 100644 --- a/facade/pom.xml +++ b/facade/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 facade diff --git a/factory-method/pom.xml b/factory-method/pom.xml index e9284bf2a..2143e3103 100644 --- a/factory-method/pom.xml +++ b/factory-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 factory-method diff --git a/flux/pom.xml b/flux/pom.xml index e146be5e2..81599671b 100644 --- a/flux/pom.xml +++ b/flux/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 flux diff --git a/flyweight/pom.xml b/flyweight/pom.xml index 84bc21d64..d7d070158 100644 --- a/flyweight/pom.xml +++ b/flyweight/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 flyweight diff --git a/front-controller/pom.xml b/front-controller/pom.xml index 2eb369395..2e2eb2626 100644 --- a/front-controller/pom.xml +++ b/front-controller/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 front-controller diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml index 64c64cac0..5c7135de9 100644 --- a/intercepting-filter/pom.xml +++ b/intercepting-filter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 intercepting-filter diff --git a/interpreter/pom.xml b/interpreter/pom.xml index 39239f05c..6ff751018 100644 --- a/interpreter/pom.xml +++ b/interpreter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 interpreter diff --git a/iterator/pom.xml b/iterator/pom.xml index a0ece2b0d..f63f87631 100644 --- a/iterator/pom.xml +++ b/iterator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 iterator diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml index 4d916c29d..6d1df928a 100644 --- a/lazy-loading/pom.xml +++ b/lazy-loading/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 lazy-loading diff --git a/mediator/pom.xml b/mediator/pom.xml index ad79b61d2..cf4e0cb33 100644 --- a/mediator/pom.xml +++ b/mediator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 mediator diff --git a/memento/pom.xml b/memento/pom.xml index d970b3a72..a3f7157f2 100644 --- a/memento/pom.xml +++ b/memento/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 memento diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml index fcd16a133..fcf21f472 100644 --- a/model-view-controller/pom.xml +++ b/model-view-controller/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 model-view-controller diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml index ab2c3f75f..825323c63 100644 --- a/model-view-presenter/pom.xml +++ b/model-view-presenter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 model-view-presenter model-view-presenter diff --git a/multiton/pom.xml b/multiton/pom.xml index 45322e26d..dea5db5c0 100644 --- a/multiton/pom.xml +++ b/multiton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 multiton diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index efa96fc51..60bb6976e 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.3.0 + 1.4.0 naked-objects-dom diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml index 361c4af2c..3c2ef574d 100644 --- a/naked-objects/fixture/pom.xml +++ b/naked-objects/fixture/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.3.0 + 1.4.0 naked-objects-fixture diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index 52de9e9ee..f49716373 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.3.0 + 1.4.0 naked-objects-integtests diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index a46b07060..dacc3d3ef 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -15,7 +15,7 @@ java-design-patterns com.iluwatar - 1.3.0 + 1.4.0 naked-objects @@ -359,17 +359,17 @@ ${project.groupId} naked-objects-dom - 1.3.0 + 1.4.0 ${project.groupId} naked-objects-fixture - 1.3.0 + 1.4.0 ${project.groupId} naked-objects-webapp - 1.3.0 + 1.4.0 diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index cd6ea43fa..e21f4fe2e 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.3.0 + 1.4.0 naked-objects-webapp diff --git a/null-object/pom.xml b/null-object/pom.xml index 4a233526d..622814fa2 100644 --- a/null-object/pom.xml +++ b/null-object/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 null-object diff --git a/object-pool/pom.xml b/object-pool/pom.xml index bb481869b..ed26c2e93 100644 --- a/object-pool/pom.xml +++ b/object-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 object-pool diff --git a/observer/pom.xml b/observer/pom.xml index c9a157f4b..be30adb8b 100644 --- a/observer/pom.xml +++ b/observer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 observer diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml index 9478519a0..9a0323c3e 100644 --- a/poison-pill/pom.xml +++ b/poison-pill/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 poison-pill diff --git a/pom.xml b/pom.xml index 402a1eb2c..aa484f15a 100644 --- a/pom.xml +++ b/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 pom diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml index e76321352..29fd33975 100644 --- a/private-class-data/pom.xml +++ b/private-class-data/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 private-class-data diff --git a/property/pom.xml b/property/pom.xml index a719e5c2f..a34e16124 100644 --- a/property/pom.xml +++ b/property/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 property diff --git a/prototype/pom.xml b/prototype/pom.xml index d4011872c..d1211d63c 100644 --- a/prototype/pom.xml +++ b/prototype/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 prototype diff --git a/proxy/pom.xml b/proxy/pom.xml index 8e8f54a5a..1257e4c76 100644 --- a/proxy/pom.xml +++ b/proxy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 proxy diff --git a/repository/pom.xml b/repository/pom.xml index f4d1096d6..9d17bc14a 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 repository diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml index 6470c9c40..39a4ccc98 100644 --- a/resource-acquisition-is-initialization/pom.xml +++ b/resource-acquisition-is-initialization/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 resource-acquisition-is-initialization diff --git a/servant/pom.xml b/servant/pom.xml index 94d072220..0a885537d 100644 --- a/servant/pom.xml +++ b/servant/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 servant diff --git a/service-layer/pom.xml b/service-layer/pom.xml index fe8d811c5..305733d2d 100644 --- a/service-layer/pom.xml +++ b/service-layer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 service-layer diff --git a/service-locator/pom.xml b/service-locator/pom.xml index fa3b22aea..d64b7ad6d 100644 --- a/service-locator/pom.xml +++ b/service-locator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 service-locator diff --git a/singleton/pom.xml b/singleton/pom.xml index 017e34ba0..02f98932f 100644 --- a/singleton/pom.xml +++ b/singleton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 singleton diff --git a/specification/pom.xml b/specification/pom.xml index f284f0efc..d1303c858 100644 --- a/specification/pom.xml +++ b/specification/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 specification diff --git a/state/pom.xml b/state/pom.xml index 8f46effc7..f7b1275c1 100644 --- a/state/pom.xml +++ b/state/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 state diff --git a/strategy/pom.xml b/strategy/pom.xml index 59fefc1f8..c33857bd0 100644 --- a/strategy/pom.xml +++ b/strategy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 strategy diff --git a/template-method/pom.xml b/template-method/pom.xml index 12842fe28..3613c5af7 100644 --- a/template-method/pom.xml +++ b/template-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 template-method diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml index 4b8fb3d75..2190d9a72 100644 --- a/thread-pool/pom.xml +++ b/thread-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 thread-pool diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml index d509c13e4..220542548 100644 --- a/tolerant-reader/pom.xml +++ b/tolerant-reader/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 tolerant-reader diff --git a/visitor/pom.xml b/visitor/pom.xml index 13697e160..727778cee 100644 --- a/visitor/pom.xml +++ b/visitor/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 visitor From 731f37723ada34838b626b368137636556d2d689 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 21:04:38 +0300 Subject: [PATCH 035/687] #89 Skeleton for Business Delegate example --- business-delegate/pom.xml | 19 +++++++++++++++++++ .../src/main/java/com/iluwatar/App.java | 8 ++++++++ .../src/test/java/com/iluwatar/AppTest.java | 12 ++++++++++++ pom.xml | 8 ++++---- 4 files changed, 43 insertions(+), 4 deletions(-) create mode 100644 business-delegate/pom.xml create mode 100644 business-delegate/src/main/java/com/iluwatar/App.java create mode 100644 business-delegate/src/test/java/com/iluwatar/AppTest.java diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml new file mode 100644 index 000000000..788072429 --- /dev/null +++ b/business-delegate/pom.xml @@ -0,0 +1,19 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.4.0 + + business-delegate + + + junit + junit + test + + + diff --git a/business-delegate/src/main/java/com/iluwatar/App.java b/business-delegate/src/main/java/com/iluwatar/App.java new file mode 100644 index 000000000..71fd395ab --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/App.java @@ -0,0 +1,8 @@ +package com.iluwatar; + +public class App { + + public static void main(String[] args) { + System.out.println("Hello World!"); + } +} diff --git a/business-delegate/src/test/java/com/iluwatar/AppTest.java b/business-delegate/src/test/java/com/iluwatar/AppTest.java new file mode 100644 index 000000000..b81f7499d --- /dev/null +++ b/business-delegate/src/test/java/com/iluwatar/AppTest.java @@ -0,0 +1,12 @@ +package com.iluwatar; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/pom.xml b/pom.xml index aa484f15a..5cd021ad4 100644 --- a/pom.xml +++ b/pom.xml @@ -1,6 +1,5 @@ - + 4.0.0 com.iluwatar @@ -71,7 +70,8 @@ naked-objects front-controller repository - + business-delegate + @@ -137,7 +137,7 @@ - + From 2c52d11b432f74848f453a054fb1782caea6dd9d Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Wed, 22 Jul 2015 23:18:07 +0300 Subject: [PATCH 036/687] #68: Documented async method invocation. --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 000c707c9..5de7711ec 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,7 @@ Concurrency patterns are those types of design patterns that deal with the multi * [Double Checked Locking](#double-checked-locking) * [Thread Pool](#thread-pool) +* [Async Method Invocation](#async-method-invocation) ### Presentation Tier Patterns @@ -618,6 +619,18 @@ validation and for building to order **Applicability:** Use the Thread Pool pattern when * You have a large number of short-lived tasks to be executed in parallel +## Async Method Invocation [↑](#list-of-design-patterns) +**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. + +**Applicability:** Use async method invocation pattern when +* You have multiple independent tasks that can run in parallel +* You need to improve performance of running a group of sequential tasks +* You have limited number of processing capacity or long running tasks and the caller cannot 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) + ## Private Class Data [↑](#list-of-design-patterns) **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. From 61573e9ef25ebe46e82639ca3b5628c2533079f5 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 22 Jul 2015 23:20:28 +0300 Subject: [PATCH 037/687] #89 Finished the example code --- .../src/main/java/com/iluwatar/App.java | 10 +++++++++- .../java/com/iluwatar/BusinessDelegate.java | 17 +++++++++++++++++ .../main/java/com/iluwatar/BusinessLookup.java | 12 ++++++++++++ .../main/java/com/iluwatar/BusinessService.java | 6 ++++++ .../src/main/java/com/iluwatar/Client.java | 14 ++++++++++++++ .../src/main/java/com/iluwatar/EjbService.java | 9 +++++++++ .../src/main/java/com/iluwatar/JmsService.java | 9 +++++++++ .../src/main/java/com/iluwatar/ServiceType.java | 6 ++++++ 8 files changed, 82 insertions(+), 1 deletion(-) create mode 100644 business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java create mode 100644 business-delegate/src/main/java/com/iluwatar/BusinessLookup.java create mode 100644 business-delegate/src/main/java/com/iluwatar/BusinessService.java create mode 100644 business-delegate/src/main/java/com/iluwatar/Client.java create mode 100644 business-delegate/src/main/java/com/iluwatar/EjbService.java create mode 100644 business-delegate/src/main/java/com/iluwatar/JmsService.java create mode 100644 business-delegate/src/main/java/com/iluwatar/ServiceType.java diff --git a/business-delegate/src/main/java/com/iluwatar/App.java b/business-delegate/src/main/java/com/iluwatar/App.java index 71fd395ab..15dc5e079 100644 --- a/business-delegate/src/main/java/com/iluwatar/App.java +++ b/business-delegate/src/main/java/com/iluwatar/App.java @@ -3,6 +3,14 @@ package com.iluwatar; public class App { public static void main(String[] args) { - System.out.println("Hello World!"); + + BusinessDelegate businessDelegate = new BusinessDelegate(); + businessDelegate.setServiceType(ServiceType.EJB); + + Client client = new Client(businessDelegate); + client.doTask(); + + businessDelegate.setServiceType(ServiceType.JMS); + client.doTask(); } } diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java new file mode 100644 index 000000000..3e20c81f4 --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java @@ -0,0 +1,17 @@ +package com.iluwatar; + +public class BusinessDelegate { + + private BusinessLookup lookupService = new BusinessLookup(); + private BusinessService businessService; + private ServiceType serviceType; + + public void setServiceType(ServiceType serviceType) { + this.serviceType = serviceType; + } + + public void doTask() { + businessService = lookupService.getBusinessService(serviceType); + businessService.doProcessing(); + } +} diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java new file mode 100644 index 000000000..f7bba0ca4 --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java @@ -0,0 +1,12 @@ +package com.iluwatar; + +public class BusinessLookup { + + public BusinessService getBusinessService(ServiceType serviceType) { + if (serviceType.equals(ServiceType.EJB)) { + return new EjbService(); + } else { + return new JmsService(); + } + } +} diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessService.java b/business-delegate/src/main/java/com/iluwatar/BusinessService.java new file mode 100644 index 000000000..80fe4b273 --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/BusinessService.java @@ -0,0 +1,6 @@ +package com.iluwatar; + +public interface BusinessService { + + void doProcessing(); +} diff --git a/business-delegate/src/main/java/com/iluwatar/Client.java b/business-delegate/src/main/java/com/iluwatar/Client.java new file mode 100644 index 000000000..7780e1abc --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/Client.java @@ -0,0 +1,14 @@ +package com.iluwatar; + +public class Client { + + private BusinessDelegate businessDelegate; + + public Client(BusinessDelegate businessDelegate) { + this.businessDelegate = businessDelegate; + } + + public void doTask() { + businessDelegate.doTask(); + } +} diff --git a/business-delegate/src/main/java/com/iluwatar/EjbService.java b/business-delegate/src/main/java/com/iluwatar/EjbService.java new file mode 100644 index 000000000..0126cdc98 --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/EjbService.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class EjbService implements BusinessService { + + @Override + public void doProcessing() { + System.out.println("EjbService is now processing"); + } +} diff --git a/business-delegate/src/main/java/com/iluwatar/JmsService.java b/business-delegate/src/main/java/com/iluwatar/JmsService.java new file mode 100644 index 000000000..ae71a1ba0 --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/JmsService.java @@ -0,0 +1,9 @@ +package com.iluwatar; + +public class JmsService implements BusinessService { + + @Override + public void doProcessing() { + System.out.println("JmsService is now processing"); + } +} diff --git a/business-delegate/src/main/java/com/iluwatar/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/ServiceType.java new file mode 100644 index 000000000..6380bb8e6 --- /dev/null +++ b/business-delegate/src/main/java/com/iluwatar/ServiceType.java @@ -0,0 +1,6 @@ +package com.iluwatar; + +public enum ServiceType { + + EJB, JMS; +} From 3e8ef01288d862ea9e6db0a8f8aa0727aff12dfd Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Mon, 20 Jul 2015 22:55:39 +0300 Subject: [PATCH 038/687] #68: Implementation of Async Method Invocation pattern --- async-method-invocation/pom.xml | 18 ++++ .../iluwatar/async/method/invocation/App.java | 50 +++++++++ .../method/invocation/AsyncCallback.java | 9 ++ .../method/invocation/AsyncExecutor.java | 14 +++ .../async/method/invocation/AsyncResult.java | 12 +++ .../invocation/ThreadAsyncExecutor.java | 101 ++++++++++++++++++ .../async/method/invocation/AppTest.java | 13 +++ pom.xml | 1 + 8 files changed, 218 insertions(+) create mode 100644 async-method-invocation/pom.xml create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java create mode 100644 async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java create mode 100644 async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml new file mode 100644 index 000000000..be932bca5 --- /dev/null +++ b/async-method-invocation/pom.xml @@ -0,0 +1,18 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.3.0 + + async-method-invocation + + + junit + junit + test + + + diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java new file mode 100644 index 000000000..f59f831b2 --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java @@ -0,0 +1,50 @@ +package com.iluwatar.async.method.invocation; + +import java.util.concurrent.Callable; + +public class App { + + public static void main(String[] args) throws Exception { + AsyncExecutor executor = new ThreadAsyncExecutor(); + 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")); + + Thread.sleep(350); // Oh boy I'm working hard here + log("Some hard work done"); + + Integer result1 = executor.endProcess(asyncResult1); + String result2 = executor.endProcess(asyncResult2); + Long result3 = executor.endProcess(asyncResult3); + asyncResult4.await(); + asyncResult5.await(); + + log("Result 1: " + result1); + log("Result 2: " + result2); + log("Result 3: " + result3); + } + + private static Callable lazyval(T value, long delayMillis) { + return () -> { + Thread.sleep(delayMillis); + log("Task completed with: " + value); + return value; + }; + } + + 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) { + System.out.println(String.format("[%1$-10s] - %2$s", Thread.currentThread().getName(), msg)); + } +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java new file mode 100644 index 000000000..0477f70e1 --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java @@ -0,0 +1,9 @@ +package com.iluwatar.async.method.invocation; + +import java.util.Optional; + +public interface AsyncCallback { + + void onComplete(T value, Optional ex); + +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java new file mode 100644 index 000000000..dd23a8bfb --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java @@ -0,0 +1,14 @@ +package com.iluwatar.async.method.invocation; + +import java.util.concurrent.Callable; +import java.util.concurrent.ExecutionException; + +public interface AsyncExecutor { + + AsyncResult startProcess(Callable task); + + AsyncResult startProcess(Callable task, AsyncCallback callback); + + T endProcess(AsyncResult asyncResult) throws ExecutionException, InterruptedException; + +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java new file mode 100644 index 000000000..5bf6145b8 --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java @@ -0,0 +1,12 @@ +package com.iluwatar.async.method.invocation; + +import java.util.concurrent.ExecutionException; + +public interface AsyncResult { + + boolean isCompleted(); + + T getValue() throws ExecutionException; + + void await() throws InterruptedException; +} diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java new file mode 100644 index 000000000..b368e284d --- /dev/null +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java @@ -0,0 +1,101 @@ +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; + +public class ThreadAsyncExecutor implements AsyncExecutor { + + 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()) { + return asyncResult.getValue(); + } else { + asyncResult.await(); + return asyncResult.getValue(); + } + } + + 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); + } + + void setValue(T value) { + this.value = value; + this.state = COMPLETED; + this.callback.ifPresent(ac -> ac.onComplete(value, Optional.empty())); + synchronized (lock) { + lock.notifyAll(); + } + } + + 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(); + } + } + } + } +} diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java new file mode 100644 index 000000000..989fa6d1d --- /dev/null +++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java @@ -0,0 +1,13 @@ +package com.iluwatar.async.method.invocation; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() throws Exception { + String[] args = {}; + App.main(args); + } + +} diff --git a/pom.xml b/pom.xml index aa484f15a..93bb137b4 100644 --- a/pom.xml +++ b/pom.xml @@ -71,6 +71,7 @@ naked-objects front-controller repository + async-method-invocation From 5cc83b85b404bf961f535104d23377347e7aec62 Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Tue, 21 Jul 2015 00:28:24 +0300 Subject: [PATCH 039/687] #68: Javadocs. --- .../iluwatar/async/method/invocation/App.java | 52 +++++++++++++++++++ .../method/invocation/AsyncCallback.java | 6 +++ .../method/invocation/AsyncExecutor.java | 23 ++++++++ .../async/method/invocation/AsyncResult.java | 17 ++++++ .../invocation/ThreadAsyncExecutor.java | 24 +++++++++ 5 files changed, 122 insertions(+) diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java index f59f831b2..de4dfe926 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java @@ -2,30 +2,76 @@ package com.iluwatar.async.method.invocation; 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 { 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); @@ -34,6 +80,12 @@ public class App { }; } + /** + * 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()) { diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java index 0477f70e1..067b79d43 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java @@ -4,6 +4,12 @@ import java.util.Optional; 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); } diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java index dd23a8bfb..4bf837a4f 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java @@ -5,10 +5,33 @@ import java.util.concurrent.ExecutionException; 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; } diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java index 5bf6145b8..689095e9d 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java @@ -4,9 +4,26 @@ import java.util.concurrent.ExecutionException; 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; } diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java index b368e284d..18b27c3b6 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java @@ -5,8 +5,12 @@ 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 @@ -37,6 +41,14 @@ public class ThreadAsyncExecutor implements AsyncExecutor { } } + /** + * 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; @@ -55,6 +67,12 @@ public class ThreadAsyncExecutor implements AsyncExecutor { 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; @@ -64,6 +82,12 @@ public class ThreadAsyncExecutor implements AsyncExecutor { } } + /** + * 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; From 6fbac15e6434855ced1c983fc18f8812f1b5b190 Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Wed, 22 Jul 2015 23:18:07 +0300 Subject: [PATCH 040/687] #68: Documented async method invocation. --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index 19cc195ef..06ebd1353 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,7 @@ Concurrency patterns are those types of design patterns that deal with the multi * [Double Checked Locking](#double-checked-locking) * [Thread Pool](#thread-pool) +* [Async Method Invocation](#async-method-invocation) ### Presentation Tier Patterns @@ -619,6 +620,18 @@ validation and for building to order **Applicability:** Use the Thread Pool pattern when * You have a large number of short-lived tasks to be executed in parallel +## Async Method Invocation [↑](#list-of-design-patterns) +**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. + +**Applicability:** Use async method invocation pattern when +* You have multiple independent tasks that can run in parallel +* You need to improve performance of running a group of sequential tasks +* You have limited number of processing capacity or long running tasks and the caller cannot 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) + ## Private Class Data [↑](#list-of-design-patterns) **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. From f7bf3955410a7c424f10e324db0338eda9fa7876 Mon Sep 17 00:00:00 2001 From: Tapio Rautonen Date: Wed, 22 Jul 2015 23:38:09 +0300 Subject: [PATCH 041/687] #68: Updated for upstream. --- async-method-invocation/pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml index be932bca5..56d3ffffc 100644 --- a/async-method-invocation/pom.xml +++ b/async-method-invocation/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.3.0 + 1.4.0 async-method-invocation From 642cf925c62224974b6e873c0692a66823a2644f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 23 Jul 2015 00:01:39 +0300 Subject: [PATCH 042/687] #89 Added comments to the example code --- .../src/main/java/com/iluwatar/App.java | 15 +++++++++++++++ .../main/java/com/iluwatar/BusinessDelegate.java | 5 +++++ .../main/java/com/iluwatar/BusinessLookup.java | 5 +++++ .../main/java/com/iluwatar/BusinessService.java | 5 +++++ .../src/main/java/com/iluwatar/Client.java | 5 +++++ .../src/main/java/com/iluwatar/EjbService.java | 5 +++++ .../src/main/java/com/iluwatar/JmsService.java | 5 +++++ .../src/main/java/com/iluwatar/ServiceType.java | 5 +++++ 8 files changed, 50 insertions(+) diff --git a/business-delegate/src/main/java/com/iluwatar/App.java b/business-delegate/src/main/java/com/iluwatar/App.java index 15dc5e079..3f9ef41c6 100644 --- a/business-delegate/src/main/java/com/iluwatar/App.java +++ b/business-delegate/src/main/java/com/iluwatar/App.java @@ -1,5 +1,20 @@ package com.iluwatar; +/** + * + * The Business Delegate pattern adds an abstraction layer between 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 (Client) utilizes a business delegate (BusinessDelegate) to execute a task. + * The Business Delegate then selects the appropriate service and makes the service call. + * + */ public class App { public static void main(String[] args) { diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java index 3e20c81f4..a4893e728 100644 --- a/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java +++ b/business-delegate/src/main/java/com/iluwatar/BusinessDelegate.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * BusinessDelegate separates presentation and business tiers + * + */ public class BusinessDelegate { private BusinessLookup lookupService = new BusinessLookup(); diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java index f7bba0ca4..9fb7e07a5 100644 --- a/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java +++ b/business-delegate/src/main/java/com/iluwatar/BusinessLookup.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Class for performing service lookups + * + */ public class BusinessLookup { public BusinessService getBusinessService(ServiceType serviceType) { diff --git a/business-delegate/src/main/java/com/iluwatar/BusinessService.java b/business-delegate/src/main/java/com/iluwatar/BusinessService.java index 80fe4b273..c324ff8f9 100644 --- a/business-delegate/src/main/java/com/iluwatar/BusinessService.java +++ b/business-delegate/src/main/java/com/iluwatar/BusinessService.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Interface for service implementations + * + */ public interface BusinessService { void doProcessing(); diff --git a/business-delegate/src/main/java/com/iluwatar/Client.java b/business-delegate/src/main/java/com/iluwatar/Client.java index 7780e1abc..8c8c4ce1f 100644 --- a/business-delegate/src/main/java/com/iluwatar/Client.java +++ b/business-delegate/src/main/java/com/iluwatar/Client.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Client utilizes BusinessDelegate to call the business tier + * + */ public class Client { private BusinessDelegate businessDelegate; diff --git a/business-delegate/src/main/java/com/iluwatar/EjbService.java b/business-delegate/src/main/java/com/iluwatar/EjbService.java index 0126cdc98..987bf73bd 100644 --- a/business-delegate/src/main/java/com/iluwatar/EjbService.java +++ b/business-delegate/src/main/java/com/iluwatar/EjbService.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Service EJB implementation + * + */ public class EjbService implements BusinessService { @Override diff --git a/business-delegate/src/main/java/com/iluwatar/JmsService.java b/business-delegate/src/main/java/com/iluwatar/JmsService.java index ae71a1ba0..a7f1f1158 100644 --- a/business-delegate/src/main/java/com/iluwatar/JmsService.java +++ b/business-delegate/src/main/java/com/iluwatar/JmsService.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Service JMS implementation + * + */ public class JmsService implements BusinessService { @Override diff --git a/business-delegate/src/main/java/com/iluwatar/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/ServiceType.java index 6380bb8e6..fb9999e4a 100644 --- a/business-delegate/src/main/java/com/iluwatar/ServiceType.java +++ b/business-delegate/src/main/java/com/iluwatar/ServiceType.java @@ -1,5 +1,10 @@ package com.iluwatar; +/** + * + * Enumeration for service types + * + */ public enum ServiceType { EJB, JMS; From e2af6dc2295e1a598cc153df8d483b65b30bf9bb Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 23 Jul 2015 00:03:43 +0300 Subject: [PATCH 043/687] #89 Added class diagram --- business-delegate/etc/business-delegate.png | Bin 0 -> 24283 bytes business-delegate/etc/business-delegate.ucls | 113 +++++++++++++++++++ 2 files changed, 113 insertions(+) create mode 100644 business-delegate/etc/business-delegate.png create mode 100644 business-delegate/etc/business-delegate.ucls diff --git a/business-delegate/etc/business-delegate.png b/business-delegate/etc/business-delegate.png new file mode 100644 index 0000000000000000000000000000000000000000..928cf934645b8447540ddfb344c04220105b3db3 GIT binary patch literal 24283 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 literal 0 HcmV?d00001 diff --git a/business-delegate/etc/business-delegate.ucls b/business-delegate/etc/business-delegate.ucls new file mode 100644 index 000000000..f57d01cd5 --- /dev/null +++ b/business-delegate/etc/business-delegate.ucls @@ -0,0 +1,113 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file From 869c578fe3a546c8fc683dd39c3eac1f599991ce Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 23 Jul 2015 00:16:32 +0300 Subject: [PATCH 044/687] #89 Added Business Delegate pattern description to README.md --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 19cc195ef..2e0a14417 100644 --- a/README.md +++ b/README.md @@ -81,6 +81,10 @@ Presentation Tier patterns are the top-most level of the application, this is co * [Flux](#flux) * [Front Controller](#front-controller) +### Business Tier Patterns + +* [Business Delegate](#business-delegate) + ### Architectural Patterns An architectural pattern is a general, reusable solution to a commonly occurring problem in software architecture within a given context. @@ -685,6 +689,16 @@ validation and for building to order **Real world examples:** * [Spring Data](http://projects.spring.io/spring-data/) +## Business Delegate [↑](#list-of-design-patterns) +**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](https://github.com/iluwatar/java-design-patterns/blob/master/business-delegate/etc/business-delegate.png "Business Delegate") + +**Applicability:** Use the Business Delegate pattern when +* you want loose couping between presentation and business tiers +* you want to orchestrate calls to multiple business services +* you want to encapsulate service lookups and service calls + # Frequently asked questions From 0fc009cba27eb992411f35167a4270aa28b1cb74 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 23 Jul 2015 00:17:51 +0300 Subject: [PATCH 045/687] #89 Added book reference --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 2e0a14417..ba6fc5887 100644 --- a/README.md +++ b/README.md @@ -791,6 +791,7 @@ Java-design-patterns project uses [semantic versioning](http://semver.org/) sche * [Richard Pawson - Naked Objects](http://downloads.nakedobjects.net/resources/Pawson%20thesis.pdf) * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) * [Spring Data](http://www.amazon.com/Spring-Data-Mark-Pollack/dp/1449323952/ref=sr_1_1) +* [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) From 18618dfbecab447b9e94bfdb931bdd117536f8fb Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 23 Jul 2015 00:49:04 +0300 Subject: [PATCH 046/687] #68 Added class diagram and referenced it from the README.md --- README.md | 2 + .../etc/async-method-invocation.png | Bin 0 -> 36923 bytes .../etc/async-method-invocation.ucls | 85 ++++++++++++++++++ 3 files changed, 87 insertions(+) create mode 100644 async-method-invocation/etc/async-method-invocation.png create mode 100644 async-method-invocation/etc/async-method-invocation.ucls diff --git a/README.md b/README.md index 62bc68242..753b500bb 100644 --- a/README.md +++ b/README.md @@ -627,6 +627,8 @@ validation and for building to order ## Async Method Invocation [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/async-method-invocation/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 performance of running a group of sequential tasks diff --git a/async-method-invocation/etc/async-method-invocation.png b/async-method-invocation/etc/async-method-invocation.png new file mode 100644 index 0000000000000000000000000000000000000000..764895d7a217b838e4c884ced9df9d0d4888d28f GIT binary patch literal 36923 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file From af92d8dde5e34110723dd5494a4e1f1b5671af95 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 23 Jul 2015 00:59:51 +0300 Subject: [PATCH 047/687] Reached milestone 1.5.0 --- abstract-factory/pom.xml | 2 +- adapter/pom.xml | 2 +- async-method-invocation/pom.xml | 2 +- bridge/pom.xml | 2 +- builder/pom.xml | 2 +- business-delegate/pom.xml | 2 +- callback/pom.xml | 2 +- chain/pom.xml | 2 +- command/pom.xml | 2 +- composite/pom.xml | 2 +- dao/pom.xml | 2 +- decorator/pom.xml | 2 +- dependency-injection/pom.xml | 2 +- double-checked-locking/pom.xml | 2 +- double-dispatch/pom.xml | 2 +- event-aggregator/pom.xml | 2 +- execute-around/pom.xml | 2 +- facade/pom.xml | 2 +- factory-method/pom.xml | 2 +- flux/pom.xml | 2 +- flyweight/pom.xml | 2 +- front-controller/pom.xml | 2 +- intercepting-filter/pom.xml | 2 +- interpreter/pom.xml | 2 +- iterator/pom.xml | 2 +- lazy-loading/pom.xml | 2 +- mediator/pom.xml | 2 +- memento/pom.xml | 2 +- model-view-controller/pom.xml | 2 +- model-view-presenter/pom.xml | 2 +- multiton/pom.xml | 2 +- naked-objects/dom/pom.xml | 2 +- naked-objects/fixture/pom.xml | 2 +- naked-objects/integtests/pom.xml | 2 +- naked-objects/pom.xml | 8 ++++---- naked-objects/webapp/pom.xml | 2 +- null-object/pom.xml | 2 +- object-pool/pom.xml | 2 +- observer/pom.xml | 2 +- poison-pill/pom.xml | 2 +- pom.xml | 2 +- private-class-data/pom.xml | 2 +- property/pom.xml | 2 +- prototype/pom.xml | 2 +- proxy/pom.xml | 2 +- repository/pom.xml | 2 +- resource-acquisition-is-initialization/pom.xml | 2 +- servant/pom.xml | 2 +- service-layer/pom.xml | 2 +- service-locator/pom.xml | 2 +- singleton/pom.xml | 2 +- specification/pom.xml | 2 +- state/pom.xml | 2 +- strategy/pom.xml | 2 +- template-method/pom.xml | 2 +- thread-pool/pom.xml | 2 +- tolerant-reader/pom.xml | 2 +- visitor/pom.xml | 2 +- 58 files changed, 61 insertions(+), 61 deletions(-) diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml index 0e3be76d5..798093c01 100644 --- a/abstract-factory/pom.xml +++ b/abstract-factory/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 abstract-factory diff --git a/adapter/pom.xml b/adapter/pom.xml index a0f738f34..8def28655 100644 --- a/adapter/pom.xml +++ b/adapter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 adapter diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml index 56d3ffffc..699258d93 100644 --- a/async-method-invocation/pom.xml +++ b/async-method-invocation/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 async-method-invocation diff --git a/bridge/pom.xml b/bridge/pom.xml index d633718db..01bd26061 100644 --- a/bridge/pom.xml +++ b/bridge/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 bridge diff --git a/builder/pom.xml b/builder/pom.xml index 9649f8454..c5405d0c6 100644 --- a/builder/pom.xml +++ b/builder/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 builder diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml index 788072429..2a7e77e3c 100644 --- a/business-delegate/pom.xml +++ b/business-delegate/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 business-delegate diff --git a/callback/pom.xml b/callback/pom.xml index 89759e6d8..d54b76172 100644 --- a/callback/pom.xml +++ b/callback/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 callback diff --git a/chain/pom.xml b/chain/pom.xml index da67b2505..f4a712260 100644 --- a/chain/pom.xml +++ b/chain/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 chain diff --git a/command/pom.xml b/command/pom.xml index ae5d88f2d..10bc00f0c 100644 --- a/command/pom.xml +++ b/command/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 command diff --git a/composite/pom.xml b/composite/pom.xml index c2842b45b..4c910e451 100644 --- a/composite/pom.xml +++ b/composite/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 composite diff --git a/dao/pom.xml b/dao/pom.xml index 505925553..6653741e4 100644 --- a/dao/pom.xml +++ b/dao/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 dao diff --git a/decorator/pom.xml b/decorator/pom.xml index a44c99c71..1b93a171c 100644 --- a/decorator/pom.xml +++ b/decorator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 decorator diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml index 984a5015c..70300b617 100644 --- a/dependency-injection/pom.xml +++ b/dependency-injection/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 dependency-injection diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml index 48a18fe95..21eb281c6 100644 --- a/double-checked-locking/pom.xml +++ b/double-checked-locking/pom.xml @@ -3,7 +3,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 double-checked-locking diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml index aba8ab47c..0d7462486 100644 --- a/double-dispatch/pom.xml +++ b/double-dispatch/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 double-dispatch diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml index 28f508700..90f488729 100644 --- a/event-aggregator/pom.xml +++ b/event-aggregator/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 event-aggregator diff --git a/execute-around/pom.xml b/execute-around/pom.xml index 039d6666f..d8d41f5d8 100644 --- a/execute-around/pom.xml +++ b/execute-around/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 execute-around diff --git a/facade/pom.xml b/facade/pom.xml index 40f732f8e..53ac6fd67 100644 --- a/facade/pom.xml +++ b/facade/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 facade diff --git a/factory-method/pom.xml b/factory-method/pom.xml index 2143e3103..1812b006d 100644 --- a/factory-method/pom.xml +++ b/factory-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 factory-method diff --git a/flux/pom.xml b/flux/pom.xml index 81599671b..367598fa2 100644 --- a/flux/pom.xml +++ b/flux/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 flux diff --git a/flyweight/pom.xml b/flyweight/pom.xml index d7d070158..87903217c 100644 --- a/flyweight/pom.xml +++ b/flyweight/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 flyweight diff --git a/front-controller/pom.xml b/front-controller/pom.xml index 2e2eb2626..d0fcc001f 100644 --- a/front-controller/pom.xml +++ b/front-controller/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 front-controller diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml index 5c7135de9..b4b5db5ae 100644 --- a/intercepting-filter/pom.xml +++ b/intercepting-filter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 intercepting-filter diff --git a/interpreter/pom.xml b/interpreter/pom.xml index 6ff751018..f2778e0cd 100644 --- a/interpreter/pom.xml +++ b/interpreter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 interpreter diff --git a/iterator/pom.xml b/iterator/pom.xml index f63f87631..b77939c9d 100644 --- a/iterator/pom.xml +++ b/iterator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 iterator diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml index 6d1df928a..cbbafae14 100644 --- a/lazy-loading/pom.xml +++ b/lazy-loading/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 lazy-loading diff --git a/mediator/pom.xml b/mediator/pom.xml index cf4e0cb33..2f3f83ff5 100644 --- a/mediator/pom.xml +++ b/mediator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 mediator diff --git a/memento/pom.xml b/memento/pom.xml index a3f7157f2..ccc2bd1e2 100644 --- a/memento/pom.xml +++ b/memento/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 memento diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml index fcf21f472..3a9167f5e 100644 --- a/model-view-controller/pom.xml +++ b/model-view-controller/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 model-view-controller diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml index 825323c63..5277e57ab 100644 --- a/model-view-presenter/pom.xml +++ b/model-view-presenter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 model-view-presenter model-view-presenter diff --git a/multiton/pom.xml b/multiton/pom.xml index dea5db5c0..8f1220119 100644 --- a/multiton/pom.xml +++ b/multiton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 multiton diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index 60bb6976e..73cfd6a73 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.4.0 + 1.5.0 naked-objects-dom diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml index 3c2ef574d..b0146e84e 100644 --- a/naked-objects/fixture/pom.xml +++ b/naked-objects/fixture/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.4.0 + 1.5.0 naked-objects-fixture diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index f49716373..9e595f7b9 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.4.0 + 1.5.0 naked-objects-integtests diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index dacc3d3ef..56acd4a15 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -15,7 +15,7 @@ java-design-patterns com.iluwatar - 1.4.0 + 1.5.0 naked-objects @@ -359,17 +359,17 @@ ${project.groupId} naked-objects-dom - 1.4.0 + 1.5.0 ${project.groupId} naked-objects-fixture - 1.4.0 + 1.5.0 ${project.groupId} naked-objects-webapp - 1.4.0 + 1.5.0 diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index e21f4fe2e..fb80173f2 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.4.0 + 1.5.0 naked-objects-webapp diff --git a/null-object/pom.xml b/null-object/pom.xml index 622814fa2..dfa1c6891 100644 --- a/null-object/pom.xml +++ b/null-object/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 null-object diff --git a/object-pool/pom.xml b/object-pool/pom.xml index ed26c2e93..3226bf71c 100644 --- a/object-pool/pom.xml +++ b/object-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 object-pool diff --git a/observer/pom.xml b/observer/pom.xml index be30adb8b..49a484edf 100644 --- a/observer/pom.xml +++ b/observer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 observer diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml index 9a0323c3e..c3a5e46c1 100644 --- a/poison-pill/pom.xml +++ b/poison-pill/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 poison-pill diff --git a/pom.xml b/pom.xml index 888008055..db468a2fb 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 pom diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml index 29fd33975..6e6817621 100644 --- a/private-class-data/pom.xml +++ b/private-class-data/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 private-class-data diff --git a/property/pom.xml b/property/pom.xml index a34e16124..6b0511fe0 100644 --- a/property/pom.xml +++ b/property/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 property diff --git a/prototype/pom.xml b/prototype/pom.xml index d1211d63c..39d8b7d33 100644 --- a/prototype/pom.xml +++ b/prototype/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 prototype diff --git a/proxy/pom.xml b/proxy/pom.xml index 1257e4c76..560c456b8 100644 --- a/proxy/pom.xml +++ b/proxy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 proxy diff --git a/repository/pom.xml b/repository/pom.xml index 9d17bc14a..fe3ca4c0d 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 repository diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml index 39a4ccc98..fb965ca2d 100644 --- a/resource-acquisition-is-initialization/pom.xml +++ b/resource-acquisition-is-initialization/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 resource-acquisition-is-initialization diff --git a/servant/pom.xml b/servant/pom.xml index 0a885537d..b59a470f2 100644 --- a/servant/pom.xml +++ b/servant/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 servant diff --git a/service-layer/pom.xml b/service-layer/pom.xml index 305733d2d..96e4e6dbf 100644 --- a/service-layer/pom.xml +++ b/service-layer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 service-layer diff --git a/service-locator/pom.xml b/service-locator/pom.xml index d64b7ad6d..6b287242e 100644 --- a/service-locator/pom.xml +++ b/service-locator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 service-locator diff --git a/singleton/pom.xml b/singleton/pom.xml index 02f98932f..dfb5cff82 100644 --- a/singleton/pom.xml +++ b/singleton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 singleton diff --git a/specification/pom.xml b/specification/pom.xml index d1303c858..53e92fef1 100644 --- a/specification/pom.xml +++ b/specification/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 specification diff --git a/state/pom.xml b/state/pom.xml index f7b1275c1..e9178d0ae 100644 --- a/state/pom.xml +++ b/state/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 state diff --git a/strategy/pom.xml b/strategy/pom.xml index c33857bd0..c24ccf9af 100644 --- a/strategy/pom.xml +++ b/strategy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 strategy diff --git a/template-method/pom.xml b/template-method/pom.xml index 3613c5af7..b0063c79e 100644 --- a/template-method/pom.xml +++ b/template-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 template-method diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml index 2190d9a72..21f0bad3d 100644 --- a/thread-pool/pom.xml +++ b/thread-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 thread-pool diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml index 220542548..fb28424d4 100644 --- a/tolerant-reader/pom.xml +++ b/tolerant-reader/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 tolerant-reader diff --git a/visitor/pom.xml b/visitor/pom.xml index 727778cee..a420b3269 100644 --- a/visitor/pom.xml +++ b/visitor/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.4.0 + 1.5.0 visitor From 3d488ec15a81d16be35843bb96505da1306db88b Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 24 Jul 2015 11:32:22 +0300 Subject: [PATCH 048/687] #108 Consistent package naming throughout the examples --- business-delegate/etc/business-delegate.ucls | 83 +++++--- .../iluwatar/{ => business/delegate}/App.java | 2 +- .../delegate}/BusinessDelegate.java | 2 +- .../delegate}/BusinessLookup.java | 2 +- .../delegate}/BusinessService.java | 2 +- .../{ => business/delegate}/Client.java | 2 +- .../{ => business/delegate}/EjbService.java | 2 +- .../{ => business/delegate}/JmsService.java | 2 +- .../{ => business/delegate}/ServiceType.java | 2 +- .../iluwatar/business/delegate}/AppTest.java | 28 +-- .../injection}/AdvancedWizard.java | 2 +- .../injection}/App.java | 2 +- .../injection}/GuiceWizard.java | 2 +- .../injection}/OldTobyTobacco.java | 2 +- .../injection}/RivendellTobacco.java | 2 +- .../injection}/SecondBreakfastTobacco.java | 2 +- .../injection}/SimpleWizard.java | 2 +- .../injection}/Tobacco.java | 2 +- .../injection}/TobaccoModule.java | 2 +- .../injection}/Wizard.java | 2 +- .../injection}/AppTest.java | 4 +- .../etc/double-checked-locking.ucls | 16 +- .../locking}/App.java | 2 +- .../locking}/Inventory.java | 2 +- .../locking}/Item.java | 2 +- .../doublechecked/locking}/AppTest.java | 28 +-- .../doublecheckedlocking/AppTest.java | 14 -- .../aggregator}/App.java | 70 +++---- .../aggregator}/Event.java | 42 ++-- .../aggregator}/EventEmitter.java | 70 +++---- .../aggregator}/EventObserver.java | 24 +-- .../aggregator}/KingJoffrey.java | 28 +-- .../aggregator}/KingsHand.java | 56 +++--- .../aggregator}/LordBaelish.java | 48 ++--- .../aggregator}/LordVarys.java | 48 ++--- .../aggregator}/Scout.java | 48 ++--- .../aggregator}/Weekday.java | 32 ++-- .../iluwatar/event/aggregator/AppTest.java | 13 ++ .../com/iluwatar/eventaggregator/AppTest.java | 13 -- .../around}/App.java | 2 +- .../around}/FileWriterAction.java | 2 +- .../around}/SimpleFileWriter.java | 2 +- .../around}/AppTest.java | 4 +- factory-method/etc/factory-method.ucls | 82 ++++---- .../method}/App.java | 56 +++--- .../method}/Blacksmith.java | 24 +-- .../method}/ElfBlacksmith.java | 28 +-- .../method}/ElfWeapon.java | 32 ++-- .../method}/OrcBlacksmith.java | 28 +-- .../method}/OrcWeapon.java | 32 ++-- .../com/iluwatar/factory/method/Weapon.java | 5 + .../method}/WeaponType.java | 34 ++-- .../com/iluwatar/factorymethod/Weapon.java | 5 - .../com/iluwatar/factory/method}/AppTest.java | 4 +- front-controller/etc/front-controller.ucls | 84 ++++---- .../iluwatar/{ => front/controller}/App.java | 2 +- .../controller}/ApplicationException.java | 2 +- .../{ => front/controller}/ArcherCommand.java | 2 +- .../{ => front/controller}/ArcherView.java | 2 +- .../controller}/CatapultCommand.java | 2 +- .../{ => front/controller}/CatapultView.java | 2 +- .../{ => front/controller}/Command.java | 2 +- .../{ => front/controller}/ErrorView.java | 2 +- .../controller}/FrontController.java | 2 +- .../controller}/UnknownCommand.java | 2 +- .../iluwatar/{ => front/controller}/View.java | 2 +- .../{ => front/controller}/AppTest.java | 4 +- .../etc/intercepting-filter.ucls | 180 ++++++++++-------- .../filter}/AbstractFilter.java | 2 +- .../filter}/AddressFilter.java | 2 +- .../filter}/App.java | 2 +- .../filter}/Client.java | 2 +- .../filter}/ContactFilter.java | 2 +- .../filter}/DepositFilter.java | 2 +- .../filter}/Filter.java | 2 +- .../filter}/FilterChain.java | 2 +- .../filter}/FilterManager.java | 2 +- .../filter}/NameFilter.java | 2 +- .../filter}/Order.java | 2 +- .../filter}/OrderFilter.java | 2 +- .../filter}/Target.java | 2 +- .../iluwatar/intercepting/filter/AppTest.java | 14 ++ .../{lazyloading => lazy/loading}/App.java | 2 +- .../{lazyloading => lazy/loading}/Heavy.java | 2 +- .../loading}/HolderNaive.java | 2 +- .../loading}/HolderThreadSafe.java | 2 +- .../loading}/Java8Holder.java | 2 +- .../com/iluwatar/lazy/loading}/AppTest.java | 4 +- .../view/controller}/App.java | 2 +- .../view/controller}/Fatigue.java | 2 +- .../view/controller}/GiantController.java | 2 +- .../view/controller}/GiantModel.java | 2 +- .../view/controller}/GiantView.java | 2 +- .../view/controller}/Health.java | 2 +- .../view/controller}/Nourishment.java | 2 +- .../view/controller}/AppTest.java | 4 +- .../etc/model-view-presenter.ucls | 95 +++++---- .../view/presenter}/FileLoader.java | 2 +- .../view/presenter}/FileSelectorJFrame.java | 2 +- .../presenter}/FileSelectorPresenter.java | 2 +- .../view/presenter}/FileSelectorStub.java | 2 +- .../view/presenter}/FileSelectorView.java | 2 +- .../view/presenter}/MainApp.java | 2 +- .../presenter}/FileSelectorPresenterTest.java | 8 +- .../{objectpool => object/pool}/App.java | 90 ++++----- .../pool}/ObjectPool.java | 74 +++---- .../pool}/Oliphaunt.java | 62 +++--- .../pool}/OliphauntPool.java | 28 +-- .../com/iluwatar/object/pool}/AppTest.java | 4 +- .../{poisonpill => poison/pill}/App.java | 2 +- .../{poisonpill => poison/pill}/Consumer.java | 4 +- .../pill}/MQPublishPoint.java | 2 +- .../pill}/MQSubscribePoint.java | 2 +- .../{poisonpill => poison/pill}/Message.java | 2 +- .../pill}/MessageQueue.java | 2 +- .../{poisonpill => poison/pill}/Producer.java | 4 +- .../pill}/SimpleMessage.java | 2 +- .../pill}/SimpleMessageQueue.java | 2 +- .../com/iluwatar/poison/pill}/AppTest.java | 4 +- repository/etc/repository.ucls | 8 +- .../com/iluwatar/{ => repository}/App.java | 2 +- .../com/iluwatar/{ => repository}/Person.java | 2 +- .../iluwatar/{ => repository}/PersonDao.java | 2 +- .../com/iluwatar/repository}/AppTest.java | 4 +- .../acquisition/is/initialization}/App.java | 2 +- .../is/initialization}/SlidingDoor.java | 2 +- .../is/initialization}/TreasureChest.java | 2 +- .../is/initialization}/AppTest.java | 4 +- 128 files changed, 963 insertions(+), 873 deletions(-) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/App.java (96%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/BusinessDelegate.java (92%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/BusinessLookup.java (87%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/BusinessService.java (74%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/Client.java (88%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/EjbService.java (83%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/JmsService.java (83%) rename business-delegate/src/main/java/com/iluwatar/{ => business/delegate}/ServiceType.java (69%) rename {object-pool/src/test/java/com/iluwatar/objectpool => business-delegate/src/test/java/com/iluwatar/business/delegate}/AppTest.java (60%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/AdvancedWizard.java (89%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/App.java (97%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/GuiceWizard.java (90%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/OldTobyTobacco.java (72%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/RivendellTobacco.java (73%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/SecondBreakfastTobacco.java (75%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/SimpleWizard.java (87%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/Tobacco.java (84%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/TobaccoModule.java (86%) rename dependency-injection/src/main/java/com/iluwatar/{dependencyinjection => dependency/injection}/Wizard.java (65%) rename dependency-injection/src/test/java/com/iluwatar/{dependencyinjection => dependency/injection}/AppTest.java (58%) rename double-checked-locking/src/main/java/com/iluwatar/{doublecheckedlocking => doublechecked/locking}/App.java (94%) rename double-checked-locking/src/main/java/com/iluwatar/{doublecheckedlocking => doublechecked/locking}/Inventory.java (94%) rename double-checked-locking/src/main/java/com/iluwatar/{doublecheckedlocking => doublechecked/locking}/Item.java (52%) rename {factory-method/src/test/java/com/iluwatar/factorymethod => double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking}/AppTest.java (57%) delete mode 100644 double-checked-locking/src/test/java/com/iluwatar/doublecheckedlocking/AppTest.java rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/App.java (92%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/Event.java (85%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/EventEmitter.java (89%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/EventObserver.java (71%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/KingJoffrey.java (82%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/KingsHand.java (85%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/LordBaelish.java (84%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/LordVarys.java (84%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/Scout.java (83%) rename event-aggregator/src/main/java/com/iluwatar/{eventaggregator => event/aggregator}/Weekday.java (85%) create mode 100644 event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java delete mode 100644 event-aggregator/src/test/java/com/iluwatar/eventaggregator/AppTest.java rename execute-around/src/main/java/com/iluwatar/{executearound => execute/around}/App.java (95%) rename execute-around/src/main/java/com/iluwatar/{executearound => execute/around}/FileWriterAction.java (86%) rename execute-around/src/main/java/com/iluwatar/{executearound => execute/around}/SimpleFileWriter.java (93%) rename execute-around/src/test/java/com/iluwatar/{executearound => execute/around}/AppTest.java (83%) rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/App.java (92%) rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/Blacksmith.java (76%) rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/ElfBlacksmith.java (81%) rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/ElfWeapon.java (81%) rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/OrcBlacksmith.java (81%) rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/OrcWeapon.java (81%) create mode 100644 factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java rename factory-method/src/main/java/com/iluwatar/{factorymethod => factory/method}/WeaponType.java (82%) delete mode 100644 factory-method/src/main/java/com/iluwatar/factorymethod/Weapon.java rename {intercepting-filter/src/test/java/com/iluwatar/interceptingfilter => factory-method/src/test/java/com/iluwatar/factory/method}/AppTest.java (61%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/App.java (96%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/ApplicationException.java (78%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/ArcherCommand.java (80%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/ArcherView.java (80%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/CatapultCommand.java (80%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/CatapultView.java (81%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/Command.java (76%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/ErrorView.java (79%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/FrontController.java (94%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/UnknownCommand.java (83%) rename front-controller/src/main/java/com/iluwatar/{ => front/controller}/View.java (74%) rename front-controller/src/test/java/com/iluwatar/{ => front/controller}/AppTest.java (60%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/AbstractFilter.java (94%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/AddressFilter.java (91%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/App.java (93%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/Client.java (98%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/ContactFilter.java (94%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/DepositFilter.java (90%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/Filter.java (94%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/FilterChain.java (92%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/FilterManager.java (90%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/NameFilter.java (91%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/Order.java (96%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/OrderFilter.java (90%) rename intercepting-filter/src/main/java/com/iluwatar/{interceptingfilter => intercepting/filter}/Target.java (97%) create mode 100644 intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java rename lazy-loading/src/main/java/com/iluwatar/{lazyloading => lazy/loading}/App.java (96%) rename lazy-loading/src/main/java/com/iluwatar/{lazyloading => lazy/loading}/Heavy.java (89%) rename lazy-loading/src/main/java/com/iluwatar/{lazyloading => lazy/loading}/HolderNaive.java (90%) rename lazy-loading/src/main/java/com/iluwatar/{lazyloading => lazy/loading}/HolderThreadSafe.java (92%) rename lazy-loading/src/main/java/com/iluwatar/{lazyloading => lazy/loading}/Java8Holder.java (95%) rename {repository/src/test/java/com/iluwatar => lazy-loading/src/test/java/com/iluwatar/lazy/loading}/AppTest.java (62%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/App.java (97%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/Fatigue.java (85%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/GiantController.java (94%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/GiantModel.java (95%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/GiantView.java (77%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/Health.java (85%) rename model-view-controller/src/main/java/com/iluwatar/{modelviewcontroller => model/view/controller}/Nourishment.java (86%) rename model-view-controller/src/test/java/com/iluwatar/{modelviewcontroller => model/view/controller}/AppTest.java (57%) rename model-view-presenter/src/main/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/FileLoader.java (97%) rename model-view-presenter/src/main/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/FileSelectorJFrame.java (98%) rename model-view-presenter/src/main/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/FileSelectorPresenter.java (97%) rename model-view-presenter/src/main/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/FileSelectorStub.java (97%) rename model-view-presenter/src/main/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/FileSelectorView.java (96%) rename model-view-presenter/src/main/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/MainApp.java (95%) rename model-view-presenter/src/test/java/com/iluwatar/{modelviewpresenter => model/view/presenter}/FileSelectorPresenterTest.java (91%) rename object-pool/src/main/java/com/iluwatar/{objectpool => object/pool}/App.java (96%) rename object-pool/src/main/java/com/iluwatar/{objectpool => object/pool}/ObjectPool.java (90%) rename object-pool/src/main/java/com/iluwatar/{objectpool => object/pool}/Oliphaunt.java (86%) rename object-pool/src/main/java/com/iluwatar/{objectpool => object/pool}/OliphauntPool.java (78%) rename {business-delegate/src/test/java/com/iluwatar => object-pool/src/test/java/com/iluwatar/object/pool}/AppTest.java (63%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/App.java (97%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/Consumer.java (90%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/MQPublishPoint.java (81%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/MQSubscribePoint.java (81%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/Message.java (96%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/MessageQueue.java (84%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/Producer.java (92%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/SimpleMessage.java (95%) rename poison-pill/src/main/java/com/iluwatar/{poisonpill => poison/pill}/SimpleMessageQueue.java (93%) rename {lazy-loading/src/test/java/com/iluwatar/lazyloading => poison-pill/src/test/java/com/iluwatar/poison/pill}/AppTest.java (63%) rename repository/src/main/java/com/iluwatar/{ => repository}/App.java (98%) rename repository/src/main/java/com/iluwatar/{ => repository}/Person.java (96%) rename repository/src/main/java/com/iluwatar/{ => repository}/PersonDao.java (90%) rename {poison-pill/src/test/java/com/iluwatar/poisonpill => repository/src/test/java/com/iluwatar/repository}/AppTest.java (64%) rename resource-acquisition-is-initialization/src/main/java/com/iluwatar/{resourceacquisitionisinitialization => resource/acquisition/is/initialization}/App.java (95%) rename resource-acquisition-is-initialization/src/main/java/com/iluwatar/{resourceacquisitionisinitialization => resource/acquisition/is/initialization}/SlidingDoor.java (81%) rename resource-acquisition-is-initialization/src/main/java/com/iluwatar/{resourceacquisitionisinitialization => resource/acquisition/is/initialization}/TreasureChest.java (84%) rename resource-acquisition-is-initialization/src/test/java/com/iluwatar/{resourceacquisitionisinitialization => resource/acquisition/is/initialization}/AppTest.java (53%) diff --git a/business-delegate/etc/business-delegate.ucls b/business-delegate/etc/business-delegate.ucls index f57d01cd5..668a6579e 100644 --- a/business-delegate/etc/business-delegate.ucls +++ b/business-delegate/etc/business-delegate.ucls @@ -1,8 +1,9 @@ - + @@ -10,8 +11,9 @@ - + @@ -19,8 +21,9 @@ - + @@ -28,8 +31,9 @@ - + @@ -37,8 +41,9 @@ - + @@ -46,8 +51,9 @@ - + @@ -55,8 +61,9 @@ - + @@ -68,40 +75,56 @@ - - - - - + - - + + + + + + - + - - + + + + + + - + + + + + - - + + + + + + - - + + + + + + - + - - - - + + + + + + diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java similarity index 94% rename from double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/App.java rename to double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java index 863f20882..10d22a5b2 100644 --- a/double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/App.java +++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.doublecheckedlocking; +package com.iluwatar.doublechecked.locking; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java similarity index 94% rename from double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/Inventory.java rename to double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java index 368be2f9a..e69d30b10 100644 --- a/double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/Inventory.java +++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java @@ -1,4 +1,4 @@ -package com.iluwatar.doublecheckedlocking; +package com.iluwatar.doublechecked.locking; import java.util.ArrayList; import java.util.List; diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/Item.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java similarity index 52% rename from double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/Item.java rename to double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java index bca41c51e..81db22115 100644 --- a/double-checked-locking/src/main/java/com/iluwatar/doublecheckedlocking/Item.java +++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java @@ -1,4 +1,4 @@ -package com.iluwatar.doublecheckedlocking; +package com.iluwatar.doublechecked.locking; public class Item { String name; diff --git a/factory-method/src/test/java/com/iluwatar/factorymethod/AppTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java similarity index 57% rename from factory-method/src/test/java/com/iluwatar/factorymethod/AppTest.java rename to double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java index 0abf55c2d..51db32c4f 100644 --- a/factory-method/src/test/java/com/iluwatar/factorymethod/AppTest.java +++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java @@ -1,14 +1,14 @@ -package com.iluwatar.factorymethod; - -import org.junit.Test; - -import com.iluwatar.factorymethod.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.doublechecked.locking; + +import org.junit.Test; + +import com.iluwatar.doublechecked.locking.App; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublecheckedlocking/AppTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublecheckedlocking/AppTest.java deleted file mode 100644 index ca3d82871..000000000 --- a/double-checked-locking/src/test/java/com/iluwatar/doublecheckedlocking/AppTest.java +++ /dev/null @@ -1,14 +0,0 @@ -package com.iluwatar.doublecheckedlocking; - -import org.junit.Test; - -import com.iluwatar.doublecheckedlocking.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/App.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java similarity index 92% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/App.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java index 1b13dfdaa..44c678f81 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/App.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java @@ -1,35 +1,35 @@ -package com.iluwatar.eventaggregator; - -import java.util.ArrayList; -import java.util.List; - -/** - * - * The Event Aggregator pattern channels events from multiple objects - * into a single object to simplify registration for clients. - * - * In the example LordBaelish, LordVarys and Scout deliver events to - * KingsHand. KingsHand, the event aggregator, then delivers the events - * to KingJoffrey. - * - */ -public class App { - - 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); - } - } - } -} +package com.iluwatar.event.aggregator; + +import java.util.ArrayList; +import java.util.List; + +/** + * + * The Event Aggregator pattern channels events from multiple objects + * into a single object to simplify registration for clients. + * + * In the example LordBaelish, LordVarys and Scout deliver events to + * KingsHand. KingsHand, the event aggregator, then delivers the events + * to KingJoffrey. + * + */ +public class App { + + 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); + } + } + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/Event.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java similarity index 85% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/Event.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java index fbceeb01d..79d496b80 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/Event.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java @@ -1,21 +1,21 @@ -package com.iluwatar.eventaggregator; - -/** - * - * 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; - } -} +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; + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/EventEmitter.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java similarity index 89% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/EventEmitter.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java index 88c23178f..1832afeaa 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/EventEmitter.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java @@ -1,35 +1,35 @@ -package com.iluwatar.eventaggregator; - -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 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); -} +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 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); +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/EventObserver.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java similarity index 71% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/EventObserver.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java index c3dc54a47..a9785627f 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/EventObserver.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java @@ -1,12 +1,12 @@ -package com.iluwatar.eventaggregator; - -/** - * - * Observers of events implement this interface. - * - */ -public interface EventObserver { - - void onEvent(Event e); - -} +package com.iluwatar.event.aggregator; + +/** + * + * Observers of events implement this interface. + * + */ +public interface EventObserver { + + void onEvent(Event e); + +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/KingJoffrey.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java similarity index 82% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/KingJoffrey.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java index 642dfc787..c94d821be 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/KingJoffrey.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java @@ -1,14 +1,14 @@ -package com.iluwatar.eventaggregator; - -/** - * - * KingJoffrey observes events from KingsHand. - * - */ -public class KingJoffrey implements EventObserver { - - @Override - public void onEvent(Event e) { - System.out.println("Received event from the King's Hand: " + e.toString()); - } -} +package com.iluwatar.event.aggregator; + +/** + * + * KingJoffrey observes events from KingsHand. + * + */ +public class KingJoffrey implements EventObserver { + + @Override + public void onEvent(Event e) { + System.out.println("Received event from the King's Hand: " + e.toString()); + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/KingsHand.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java similarity index 85% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/KingsHand.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java index 2b8e1e769..a3e01334b 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/KingsHand.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java @@ -1,28 +1,28 @@ -package com.iluwatar.eventaggregator; - -/** - * - * 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 - } -} +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 + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/LordBaelish.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java similarity index 84% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/LordBaelish.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java index e3f0223a1..b13ec88fc 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/LordBaelish.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java @@ -1,24 +1,24 @@ -package com.iluwatar.eventaggregator; - -/** - * - * 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); - } - } -} +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); + } + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/LordVarys.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java similarity index 84% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/LordVarys.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java index 0afaaf150..d1fec048a 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/LordVarys.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java @@ -1,24 +1,24 @@ -package com.iluwatar.eventaggregator; - -/** - * - * 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); - } - } -} +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); + } + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/Scout.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java similarity index 83% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/Scout.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java index 6376182b7..8ff4e04ab 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/Scout.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java @@ -1,24 +1,24 @@ -package com.iluwatar.eventaggregator; - -/** - * - * 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); - } - } -} +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); + } + } +} diff --git a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/Weekday.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java similarity index 85% rename from event-aggregator/src/main/java/com/iluwatar/eventaggregator/Weekday.java rename to event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java index b62cbb106..651a4e71c 100644 --- a/event-aggregator/src/main/java/com/iluwatar/eventaggregator/Weekday.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java @@ -1,16 +1,16 @@ -package com.iluwatar.eventaggregator; - -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; - } -} +package com.iluwatar.event.aggregator; + +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; + } +} diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java new file mode 100644 index 000000000..1d2562e2c --- /dev/null +++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java @@ -0,0 +1,13 @@ +package com.iluwatar.event.aggregator; +import org.junit.Test; + +import com.iluwatar.event.aggregator.App; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/event-aggregator/src/test/java/com/iluwatar/eventaggregator/AppTest.java b/event-aggregator/src/test/java/com/iluwatar/eventaggregator/AppTest.java deleted file mode 100644 index 42710f378..000000000 --- a/event-aggregator/src/test/java/com/iluwatar/eventaggregator/AppTest.java +++ /dev/null @@ -1,13 +0,0 @@ -package com.iluwatar.eventaggregator; -import org.junit.Test; - -import com.iluwatar.eventaggregator.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} diff --git a/execute-around/src/main/java/com/iluwatar/executearound/App.java b/execute-around/src/main/java/com/iluwatar/execute/around/App.java similarity index 95% rename from execute-around/src/main/java/com/iluwatar/executearound/App.java rename to execute-around/src/main/java/com/iluwatar/execute/around/App.java index 783693fac..8603a12bc 100644 --- a/execute-around/src/main/java/com/iluwatar/executearound/App.java +++ b/execute-around/src/main/java/com/iluwatar/execute/around/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.executearound; +package com.iluwatar.execute.around; import java.io.FileWriter; import java.io.IOException; diff --git a/execute-around/src/main/java/com/iluwatar/executearound/FileWriterAction.java b/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java similarity index 86% rename from execute-around/src/main/java/com/iluwatar/executearound/FileWriterAction.java rename to execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java index 12eea7f66..904600ec6 100644 --- a/execute-around/src/main/java/com/iluwatar/executearound/FileWriterAction.java +++ b/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java @@ -1,4 +1,4 @@ -package com.iluwatar.executearound; +package com.iluwatar.execute.around; import java.io.FileWriter; import java.io.IOException; diff --git a/execute-around/src/main/java/com/iluwatar/executearound/SimpleFileWriter.java b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java similarity index 93% rename from execute-around/src/main/java/com/iluwatar/executearound/SimpleFileWriter.java rename to execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java index ee7f23360..2de1e5d67 100644 --- a/execute-around/src/main/java/com/iluwatar/executearound/SimpleFileWriter.java +++ b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java @@ -1,4 +1,4 @@ -package com.iluwatar.executearound; +package com.iluwatar.execute.around; import java.io.FileWriter; import java.io.IOException; diff --git a/execute-around/src/test/java/com/iluwatar/executearound/AppTest.java b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java similarity index 83% rename from execute-around/src/test/java/com/iluwatar/executearound/AppTest.java rename to execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java index 263595cd8..1e8a45947 100644 --- a/execute-around/src/test/java/com/iluwatar/executearound/AppTest.java +++ b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java @@ -1,4 +1,4 @@ -package com.iluwatar.executearound; +package com.iluwatar.execute.around; import java.io.File; import java.io.IOException; @@ -7,7 +7,7 @@ import org.junit.After; import org.junit.Before; import org.junit.Test; -import com.iluwatar.executearound.App; +import com.iluwatar.execute.around.App; /** * diff --git a/factory-method/etc/factory-method.ucls b/factory-method/etc/factory-method.ucls index 6f270fd18..562437995 100644 --- a/factory-method/etc/factory-method.ucls +++ b/factory-method/etc/factory-method.ucls @@ -1,8 +1,8 @@ - - + @@ -20,8 +21,9 @@ - + @@ -29,8 +31,8 @@ - + @@ -38,8 +40,8 @@ - + @@ -47,8 +49,8 @@ - + @@ -56,8 +58,8 @@ - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + - - + + + + + + + + + + + + + + diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/App.java b/factory-method/src/main/java/com/iluwatar/factory/method/App.java similarity index 92% rename from factory-method/src/main/java/com/iluwatar/factorymethod/App.java rename to factory-method/src/main/java/com/iluwatar/factory/method/App.java index 90d14dfb0..41b234791 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/App.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/App.java @@ -1,28 +1,28 @@ -package com.iluwatar.factorymethod; - -/** - * - * In Factory Method we have an interface (Blacksmith) with a method for - * creating objects (manufactureWeapon). The concrete subclasses (OrcBlacksmith, - * ElfBlacksmith) then override the method to produce objects of their liking. - * - */ -public class App { - - public static void main(String[] args) { - Blacksmith blacksmith; - Weapon weapon; - - blacksmith = new OrcBlacksmith(); - weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); - System.out.println(weapon); - weapon = blacksmith.manufactureWeapon(WeaponType.AXE); - System.out.println(weapon); - - blacksmith = new ElfBlacksmith(); - weapon = blacksmith.manufactureWeapon(WeaponType.SHORT_SWORD); - System.out.println(weapon); - weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); - System.out.println(weapon); - } -} +package com.iluwatar.factory.method; + +/** + * + * In Factory Method we have an interface (Blacksmith) with a method for + * creating objects (manufactureWeapon). The concrete subclasses (OrcBlacksmith, + * ElfBlacksmith) then override the method to produce objects of their liking. + * + */ +public class App { + + public static void main(String[] args) { + Blacksmith blacksmith; + Weapon weapon; + + blacksmith = new OrcBlacksmith(); + weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); + System.out.println(weapon); + weapon = blacksmith.manufactureWeapon(WeaponType.AXE); + System.out.println(weapon); + + blacksmith = new ElfBlacksmith(); + weapon = blacksmith.manufactureWeapon(WeaponType.SHORT_SWORD); + System.out.println(weapon); + weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR); + System.out.println(weapon); + } +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/Blacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java similarity index 76% rename from factory-method/src/main/java/com/iluwatar/factorymethod/Blacksmith.java rename to factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java index b18a5c6df..516c993a9 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/Blacksmith.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java @@ -1,12 +1,12 @@ -package com.iluwatar.factorymethod; - -/** - * - * The interface containing method for producing objects. - * - */ -public interface Blacksmith { - - Weapon manufactureWeapon(WeaponType weaponType); - -} +package com.iluwatar.factory.method; + +/** + * + * The interface containing method for producing objects. + * + */ +public interface Blacksmith { + + Weapon manufactureWeapon(WeaponType weaponType); + +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/ElfBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java similarity index 81% rename from factory-method/src/main/java/com/iluwatar/factorymethod/ElfBlacksmith.java rename to factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java index 21c6aacdf..9a5e62890 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/ElfBlacksmith.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java @@ -1,14 +1,14 @@ -package com.iluwatar.factorymethod; - -/** - * - * Concrete subclass for creating new objects. - * - */ -public class ElfBlacksmith implements Blacksmith { - - public Weapon manufactureWeapon(WeaponType weaponType) { - return new ElfWeapon(weaponType); - } - -} +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); + } + +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/ElfWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java similarity index 81% rename from factory-method/src/main/java/com/iluwatar/factorymethod/ElfWeapon.java rename to factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java index 7e90f3b38..a425d3ce7 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/ElfWeapon.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java @@ -1,16 +1,16 @@ -package com.iluwatar.factorymethod; - -public class ElfWeapon implements Weapon { - - private WeaponType weaponType; - - public ElfWeapon(WeaponType weaponType) { - this.weaponType = weaponType; - } - - @Override - public String toString() { - return "Elven " + weaponType; - } - -} +package com.iluwatar.factory.method; + +public class ElfWeapon implements Weapon { + + private WeaponType weaponType; + + public ElfWeapon(WeaponType weaponType) { + this.weaponType = weaponType; + } + + @Override + public String toString() { + return "Elven " + weaponType; + } + +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/OrcBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java similarity index 81% rename from factory-method/src/main/java/com/iluwatar/factorymethod/OrcBlacksmith.java rename to factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java index 297dd6b98..382507ec9 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/OrcBlacksmith.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java @@ -1,14 +1,14 @@ -package com.iluwatar.factorymethod; - -/** - * - * Concrete subclass for creating new objects. - * - */ -public class OrcBlacksmith implements Blacksmith { - - public Weapon manufactureWeapon(WeaponType weaponType) { - return new OrcWeapon(weaponType); - } - -} +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); + } + +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/OrcWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java similarity index 81% rename from factory-method/src/main/java/com/iluwatar/factorymethod/OrcWeapon.java rename to factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java index 2d7b19adb..ab9b83991 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/OrcWeapon.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java @@ -1,16 +1,16 @@ -package com.iluwatar.factorymethod; - -public class OrcWeapon implements Weapon { - - private WeaponType weaponType; - - public OrcWeapon(WeaponType weaponType) { - this.weaponType = weaponType; - } - - @Override - public String toString() { - return "Orcish " + weaponType; - } - -} +package com.iluwatar.factory.method; + +public class OrcWeapon implements Weapon { + + private WeaponType weaponType; + + public OrcWeapon(WeaponType weaponType) { + this.weaponType = weaponType; + } + + @Override + public String toString() { + return "Orcish " + weaponType; + } + +} diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java new file mode 100644 index 000000000..80e7c911f --- /dev/null +++ b/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java @@ -0,0 +1,5 @@ +package com.iluwatar.factory.method; + +public interface Weapon { + +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/WeaponType.java b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java similarity index 82% rename from factory-method/src/main/java/com/iluwatar/factorymethod/WeaponType.java rename to factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java index 45e1f82de..9ef82fff6 100644 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/WeaponType.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java @@ -1,17 +1,17 @@ -package com.iluwatar.factorymethod; - -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; - } -} +package com.iluwatar.factory.method; + +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; + } +} diff --git a/factory-method/src/main/java/com/iluwatar/factorymethod/Weapon.java b/factory-method/src/main/java/com/iluwatar/factorymethod/Weapon.java deleted file mode 100644 index 3a9346d03..000000000 --- a/factory-method/src/main/java/com/iluwatar/factorymethod/Weapon.java +++ /dev/null @@ -1,5 +0,0 @@ -package com.iluwatar.factorymethod; - -public interface Weapon { - -} diff --git a/intercepting-filter/src/test/java/com/iluwatar/interceptingfilter/AppTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java similarity index 61% rename from intercepting-filter/src/test/java/com/iluwatar/interceptingfilter/AppTest.java rename to factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java index eef4bf4e7..9fa0cc5eb 100644 --- a/intercepting-filter/src/test/java/com/iluwatar/interceptingfilter/AppTest.java +++ b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java @@ -1,7 +1,9 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.factory.method; import org.junit.Test; +import com.iluwatar.factory.method.App; + public class AppTest { @Test diff --git a/front-controller/etc/front-controller.ucls b/front-controller/etc/front-controller.ucls index bf12d4a82..11cdf66ec 100644 --- a/front-controller/etc/front-controller.ucls +++ b/front-controller/etc/front-controller.ucls @@ -1,8 +1,9 @@ - + @@ -10,8 +11,9 @@ - + @@ -19,8 +21,9 @@ - + @@ -28,8 +31,9 @@ - + @@ -37,8 +41,9 @@ - + @@ -46,8 +51,9 @@ - + @@ -55,8 +61,9 @@ - + @@ -64,8 +71,8 @@ - + @@ -73,8 +80,9 @@ - + @@ -83,48 +91,48 @@ - - + + - - + + - + + + + + - + - - - + + + - - - - - - - - - + + + + + - - + + diff --git a/front-controller/src/main/java/com/iluwatar/App.java b/front-controller/src/main/java/com/iluwatar/front/controller/App.java similarity index 96% rename from front-controller/src/main/java/com/iluwatar/App.java rename to front-controller/src/main/java/com/iluwatar/front/controller/App.java index 9db0c4c7f..d17987823 100644 --- a/front-controller/src/main/java/com/iluwatar/App.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/App.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/ApplicationException.java b/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java similarity index 78% rename from front-controller/src/main/java/com/iluwatar/ApplicationException.java rename to front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java index c30c63047..3a0191831 100644 --- a/front-controller/src/main/java/com/iluwatar/ApplicationException.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; public class ApplicationException extends RuntimeException { diff --git a/front-controller/src/main/java/com/iluwatar/ArcherCommand.java b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java similarity index 80% rename from front-controller/src/main/java/com/iluwatar/ArcherCommand.java rename to front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java index 0b85247c5..117aa0c8c 100644 --- a/front-controller/src/main/java/com/iluwatar/ArcherCommand.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherCommand.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/ArcherView.java b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java similarity index 80% rename from front-controller/src/main/java/com/iluwatar/ArcherView.java rename to front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java index a670dd10d..d8cae33c1 100644 --- a/front-controller/src/main/java/com/iluwatar/ArcherView.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/ArcherView.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/CatapultCommand.java b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java similarity index 80% rename from front-controller/src/main/java/com/iluwatar/CatapultCommand.java rename to front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java index db0a38b40..fae5d1753 100644 --- a/front-controller/src/main/java/com/iluwatar/CatapultCommand.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultCommand.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/CatapultView.java b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java similarity index 81% rename from front-controller/src/main/java/com/iluwatar/CatapultView.java rename to front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java index 6459b3b48..9ad94d522 100644 --- a/front-controller/src/main/java/com/iluwatar/CatapultView.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/CatapultView.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/Command.java b/front-controller/src/main/java/com/iluwatar/front/controller/Command.java similarity index 76% rename from front-controller/src/main/java/com/iluwatar/Command.java rename to front-controller/src/main/java/com/iluwatar/front/controller/Command.java index 657ef58d5..95bd00129 100644 --- a/front-controller/src/main/java/com/iluwatar/Command.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/Command.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/ErrorView.java b/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java similarity index 79% rename from front-controller/src/main/java/com/iluwatar/ErrorView.java rename to front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java index 1a91a0d52..04c31dd34 100644 --- a/front-controller/src/main/java/com/iluwatar/ErrorView.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/ErrorView.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/FrontController.java b/front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java similarity index 94% rename from front-controller/src/main/java/com/iluwatar/FrontController.java rename to front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java index 09e90f7ed..5a6dc2a78 100644 --- a/front-controller/src/main/java/com/iluwatar/FrontController.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/FrontController.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/UnknownCommand.java b/front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java similarity index 83% rename from front-controller/src/main/java/com/iluwatar/UnknownCommand.java rename to front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java index b3186a514..f8f93e7e0 100644 --- a/front-controller/src/main/java/com/iluwatar/UnknownCommand.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/UnknownCommand.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/main/java/com/iluwatar/View.java b/front-controller/src/main/java/com/iluwatar/front/controller/View.java similarity index 74% rename from front-controller/src/main/java/com/iluwatar/View.java rename to front-controller/src/main/java/com/iluwatar/front/controller/View.java index 6061ed0e5..29c5f0fcb 100644 --- a/front-controller/src/main/java/com/iluwatar/View.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/View.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.front.controller; /** * diff --git a/front-controller/src/test/java/com/iluwatar/AppTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java similarity index 60% rename from front-controller/src/test/java/com/iluwatar/AppTest.java rename to front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java index b81f7499d..2c05cf9c4 100644 --- a/front-controller/src/test/java/com/iluwatar/AppTest.java +++ b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java @@ -1,7 +1,9 @@ -package com.iluwatar; +package com.iluwatar.front.controller; import org.junit.Test; +import com.iluwatar.front.controller.App; + public class AppTest { @Test diff --git a/intercepting-filter/etc/intercepting-filter.ucls b/intercepting-filter/etc/intercepting-filter.ucls index c778f536e..9cf8d3c00 100644 --- a/intercepting-filter/etc/intercepting-filter.ucls +++ b/intercepting-filter/etc/intercepting-filter.ucls @@ -1,8 +1,8 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/AbstractFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java similarity index 94% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/AbstractFilter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java index 680738d6d..2c32772fa 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/AbstractFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Base class for order processing filters. diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/AddressFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java similarity index 91% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/AddressFilter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java index 836cc3928..0bd66c047 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/AddressFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/App.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java similarity index 93% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/App.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java index 51e363663..b597396f5 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/App.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Client.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java similarity index 98% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Client.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java index fde2b012d..6c94af5c5 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Client.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; import java.awt.BorderLayout; import java.awt.GridLayout; diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/ContactFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java similarity index 94% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/ContactFilter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java index 449d00be1..214376263 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/ContactFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/DepositFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java similarity index 90% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/DepositFilter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java index aa46c149c..129c07cd7 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/DepositFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Filter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java similarity index 94% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Filter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java index dc7e3445a..0782fddab 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Filter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Filter interface Filters perform certain tasks prior or after execution of diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/FilterChain.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java similarity index 92% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/FilterChain.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java index 56446833d..e11a58ea0 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/FilterChain.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java @@ -1,4 +1,4 @@ - package com.iluwatar.interceptingfilter; + package com.iluwatar.intercepting.filter; /** diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/FilterManager.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java similarity index 90% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/FilterManager.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java index f729ee734..65c822c8a 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/FilterManager.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Filter Manager manages the filters and Filter Chain. diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/NameFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java similarity index 91% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/NameFilter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java index ff4c9fd8d..c9da2600a 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/NameFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter This filter checks if the input in the Name diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Order.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java similarity index 96% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Order.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java index 96a30fd0a..60bf21f8e 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Order.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Order class carries the order data. diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/OrderFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java similarity index 90% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/OrderFilter.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java index b85fa3079..bc86289b4 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/OrderFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; /** * Concrete implementation of filter This checks for the order field diff --git a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Target.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java similarity index 97% rename from intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Target.java rename to intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java index 2e68c2380..6ca456512 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/interceptingfilter/Target.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java @@ -1,4 +1,4 @@ -package com.iluwatar.interceptingfilter; +package com.iluwatar.intercepting.filter; import java.awt.BorderLayout; import java.awt.Dimension; diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java new file mode 100644 index 000000000..b12bc8db9 --- /dev/null +++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java @@ -0,0 +1,14 @@ +package com.iluwatar.intercepting.filter; + +import org.junit.Test; + +import com.iluwatar.intercepting.filter.App; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/lazy-loading/src/main/java/com/iluwatar/lazyloading/App.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java similarity index 96% rename from lazy-loading/src/main/java/com/iluwatar/lazyloading/App.java rename to lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java index 608c39b5f..f12d4e20c 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazyloading/App.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.lazyloading; +package com.iluwatar.lazy.loading; /** * diff --git a/lazy-loading/src/main/java/com/iluwatar/lazyloading/Heavy.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java similarity index 89% rename from lazy-loading/src/main/java/com/iluwatar/lazyloading/Heavy.java rename to lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java index d87d4b5f7..c2715434f 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazyloading/Heavy.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java @@ -1,4 +1,4 @@ -package com.iluwatar.lazyloading; +package com.iluwatar.lazy.loading; /** * diff --git a/lazy-loading/src/main/java/com/iluwatar/lazyloading/HolderNaive.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java similarity index 90% rename from lazy-loading/src/main/java/com/iluwatar/lazyloading/HolderNaive.java rename to lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java index 1abc6463a..1421d4b23 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazyloading/HolderNaive.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java @@ -1,4 +1,4 @@ -package com.iluwatar.lazyloading; +package com.iluwatar.lazy.loading; /** * diff --git a/lazy-loading/src/main/java/com/iluwatar/lazyloading/HolderThreadSafe.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java similarity index 92% rename from lazy-loading/src/main/java/com/iluwatar/lazyloading/HolderThreadSafe.java rename to lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java index eff35c14a..cc039d9f0 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazyloading/HolderThreadSafe.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java @@ -1,4 +1,4 @@ -package com.iluwatar.lazyloading; +package com.iluwatar.lazy.loading; /** * diff --git a/lazy-loading/src/main/java/com/iluwatar/lazyloading/Java8Holder.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java similarity index 95% rename from lazy-loading/src/main/java/com/iluwatar/lazyloading/Java8Holder.java rename to lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java index 6be5e374e..6bd2382c1 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazyloading/Java8Holder.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java @@ -1,4 +1,4 @@ -package com.iluwatar.lazyloading; +package com.iluwatar.lazy.loading; import java.util.function.Supplier; diff --git a/repository/src/test/java/com/iluwatar/AppTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java similarity index 62% rename from repository/src/test/java/com/iluwatar/AppTest.java rename to lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java index 6db5ad214..96e88e75f 100644 --- a/repository/src/test/java/com/iluwatar/AppTest.java +++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java @@ -1,7 +1,9 @@ -package com.iluwatar; +package com.iluwatar.lazy.loading; import org.junit.Test; +import com.iluwatar.lazy.loading.App; + public class AppTest { @Test diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/App.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java similarity index 97% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/App.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java index eb9fbdc8f..e3d61302e 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/App.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Fatigue.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java similarity index 85% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Fatigue.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java index 7faa5f71b..d19df6a8c 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Fatigue.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantController.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java similarity index 94% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantController.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java index ab5f6d127..acda727d9 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantController.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantModel.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java similarity index 95% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantModel.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java index f623cd0a1..97c298768 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantModel.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantView.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java similarity index 77% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantView.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java index df23119c6..1cf5e20a6 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/GiantView.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Health.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java similarity index 85% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Health.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java index 263182c20..feaec81d7 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Health.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Nourishment.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java similarity index 86% rename from model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Nourishment.java rename to model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java index 799983e2a..7bab931b6 100644 --- a/model-view-controller/src/main/java/com/iluwatar/modelviewcontroller/Nourishment.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; /** * diff --git a/model-view-controller/src/test/java/com/iluwatar/modelviewcontroller/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java similarity index 57% rename from model-view-controller/src/test/java/com/iluwatar/modelviewcontroller/AppTest.java rename to model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java index f9c8eca8e..b6e2f1bff 100644 --- a/model-view-controller/src/test/java/com/iluwatar/modelviewcontroller/AppTest.java +++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java @@ -1,8 +1,8 @@ -package com.iluwatar.modelviewcontroller; +package com.iluwatar.model.view.controller; import org.junit.Test; -import com.iluwatar.modelviewcontroller.App; +import com.iluwatar.model.view.controller.App; public class AppTest { diff --git a/model-view-presenter/etc/model-view-presenter.ucls b/model-view-presenter/etc/model-view-presenter.ucls index aa8dd13ae..70e905d3f 100644 --- a/model-view-presenter/etc/model-view-presenter.ucls +++ b/model-view-presenter/etc/model-view-presenter.ucls @@ -1,8 +1,9 @@ - - - + file="/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java" + binary="false" corner="BOTTOM_RIGHT"> @@ -32,9 +33,9 @@ - - - - - - - - + - - + + + + + + - - - - - - - - - - - - - - - - - + - + - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileLoader.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java similarity index 97% rename from model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileLoader.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java index a0b0abdc9..aef5bade9 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileLoader.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; import java.io.BufferedReader; import java.io.File; diff --git a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorJFrame.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java similarity index 98% rename from model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorJFrame.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java index 025d17dab..be3c253ed 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorJFrame.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; import java.awt.Color; import java.awt.event.ActionEvent; diff --git a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorPresenter.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java similarity index 97% rename from model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorPresenter.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java index 80aac42ff..a7842e932 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorPresenter.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; /** * Every instance of this class represents the Presenter component in the diff --git a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorStub.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java similarity index 97% rename from model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorStub.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java index 8b7ff7dd6..7aa88e922 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorStub.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; /** * Every instance of this class represents the Stub component in the diff --git a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorView.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java similarity index 96% rename from model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorView.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java index 424a0eed3..e4a7efaee 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/FileSelectorView.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; /** * This interface represents the View component in the Model-View-Presenter diff --git a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/MainApp.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/MainApp.java similarity index 95% rename from model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/MainApp.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/MainApp.java index 96e2fdab2..73da4f733 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/modelviewpresenter/MainApp.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/MainApp.java @@ -1,4 +1,4 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; /** * diff --git a/model-view-presenter/src/test/java/com/iluwatar/modelviewpresenter/FileSelectorPresenterTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java similarity index 91% rename from model-view-presenter/src/test/java/com/iluwatar/modelviewpresenter/FileSelectorPresenterTest.java rename to model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java index 9895b99d5..119448e9c 100644 --- a/model-view-presenter/src/test/java/com/iluwatar/modelviewpresenter/FileSelectorPresenterTest.java +++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java @@ -1,13 +1,13 @@ -package com.iluwatar.modelviewpresenter; +package com.iluwatar.model.view.presenter; import static org.junit.Assert.*; import org.junit.Before; import org.junit.Test; -import com.iluwatar.modelviewpresenter.FileLoader; -import com.iluwatar.modelviewpresenter.FileSelectorPresenter; -import com.iluwatar.modelviewpresenter.FileSelectorStub; +import com.iluwatar.model.view.presenter.FileLoader; +import com.iluwatar.model.view.presenter.FileSelectorPresenter; +import com.iluwatar.model.view.presenter.FileSelectorStub; /** * This test case is responsible for testing our application by taking advantage diff --git a/object-pool/src/main/java/com/iluwatar/objectpool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java similarity index 96% rename from object-pool/src/main/java/com/iluwatar/objectpool/App.java rename to object-pool/src/main/java/com/iluwatar/object/pool/App.java index 2c6c855e5..d47bc51be 100644 --- a/object-pool/src/main/java/com/iluwatar/objectpool/App.java +++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java @@ -1,45 +1,45 @@ -package com.iluwatar.objectpool; - -/** - * - * 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 OliphauntPool inheriting from generic ObjectPool. Oliphaunts 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 { - - public static void main( String[] args ) { - OliphauntPool pool = new OliphauntPool(); - System.out.println(pool); - Oliphaunt oliphaunt1 = pool.checkOut(); - System.out.println("Checked out " + oliphaunt1); - System.out.println(pool); - Oliphaunt oliphaunt2 = pool.checkOut(); - System.out.println("Checked out " + oliphaunt2); - Oliphaunt oliphaunt3 = pool.checkOut(); - System.out.println("Checked out " + oliphaunt3); - System.out.println(pool); - System.out.println("Checking in " + oliphaunt1); - pool.checkIn(oliphaunt1); - System.out.println("Checking in " + oliphaunt2); - pool.checkIn(oliphaunt2); - System.out.println(pool); - Oliphaunt oliphaunt4 = pool.checkOut(); - System.out.println("Checked out " + oliphaunt4); - Oliphaunt oliphaunt5 = pool.checkOut(); - System.out.println("Checked out " + oliphaunt5); - System.out.println(pool); - } -} +package com.iluwatar.object.pool; + +/** + * + * 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 OliphauntPool inheriting from generic ObjectPool. Oliphaunts 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 { + + public static void main( String[] args ) { + OliphauntPool pool = new OliphauntPool(); + System.out.println(pool); + Oliphaunt oliphaunt1 = pool.checkOut(); + System.out.println("Checked out " + oliphaunt1); + System.out.println(pool); + Oliphaunt oliphaunt2 = pool.checkOut(); + System.out.println("Checked out " + oliphaunt2); + Oliphaunt oliphaunt3 = pool.checkOut(); + System.out.println("Checked out " + oliphaunt3); + System.out.println(pool); + System.out.println("Checking in " + oliphaunt1); + pool.checkIn(oliphaunt1); + System.out.println("Checking in " + oliphaunt2); + pool.checkIn(oliphaunt2); + System.out.println(pool); + Oliphaunt oliphaunt4 = pool.checkOut(); + System.out.println("Checked out " + oliphaunt4); + Oliphaunt oliphaunt5 = pool.checkOut(); + System.out.println("Checked out " + oliphaunt5); + System.out.println(pool); + } +} diff --git a/object-pool/src/main/java/com/iluwatar/objectpool/ObjectPool.java b/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java similarity index 90% rename from object-pool/src/main/java/com/iluwatar/objectpool/ObjectPool.java rename to object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java index 343f29aef..8b582630b 100644 --- a/object-pool/src/main/java/com/iluwatar/objectpool/ObjectPool.java +++ b/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java @@ -1,37 +1,37 @@ -package com.iluwatar.objectpool; - -import java.util.HashSet; - -/** - * - * Generic object pool - * - * @param - */ -public abstract class ObjectPool { - - private HashSet available = new HashSet<>(); - private HashSet inUse = new HashSet<>(); - - protected abstract T create(); - - public synchronized T checkOut() { - if (available.size() <= 0) { - 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()); - } -} +package com.iluwatar.object.pool; + +import java.util.HashSet; + +/** + * + * Generic object pool + * + * @param + */ +public abstract class ObjectPool { + + private HashSet available = new HashSet<>(); + private HashSet inUse = new HashSet<>(); + + protected abstract T create(); + + public synchronized T checkOut() { + if (available.size() <= 0) { + 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()); + } +} diff --git a/object-pool/src/main/java/com/iluwatar/objectpool/Oliphaunt.java b/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java similarity index 86% rename from object-pool/src/main/java/com/iluwatar/objectpool/Oliphaunt.java rename to object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java index 29d02d2e8..4b32e0ba1 100644 --- a/object-pool/src/main/java/com/iluwatar/objectpool/Oliphaunt.java +++ b/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java @@ -1,31 +1,31 @@ -package com.iluwatar.objectpool; - -/** - * - * Oliphaunts are expensive to create - * - */ -public class Oliphaunt { - - private static int counter = 1; - - private final int id; - - 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); - } -} +package com.iluwatar.object.pool; + +/** + * + * Oliphaunts are expensive to create + * + */ +public class Oliphaunt { + + private static int counter = 1; + + private final int id; + + 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); + } +} diff --git a/object-pool/src/main/java/com/iluwatar/objectpool/OliphauntPool.java b/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java similarity index 78% rename from object-pool/src/main/java/com/iluwatar/objectpool/OliphauntPool.java rename to object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java index 25f591f00..a0cfc0d54 100644 --- a/object-pool/src/main/java/com/iluwatar/objectpool/OliphauntPool.java +++ b/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java @@ -1,14 +1,14 @@ -package com.iluwatar.objectpool; - -/** - * - * Oliphaunt object pool - * - */ -public class OliphauntPool extends ObjectPool { - - @Override - protected Oliphaunt create() { - return new Oliphaunt(); - } -} +package com.iluwatar.object.pool; + +/** + * + * Oliphaunt object pool + * + */ +public class OliphauntPool extends ObjectPool { + + @Override + protected Oliphaunt create() { + return new Oliphaunt(); + } +} diff --git a/business-delegate/src/test/java/com/iluwatar/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java similarity index 63% rename from business-delegate/src/test/java/com/iluwatar/AppTest.java rename to object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java index b81f7499d..c856141db 100644 --- a/business-delegate/src/test/java/com/iluwatar/AppTest.java +++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java @@ -1,7 +1,9 @@ -package com.iluwatar; +package com.iluwatar.object.pool; import org.junit.Test; +import com.iluwatar.object.pool.App; + public class AppTest { @Test diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/App.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java similarity index 97% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/App.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/App.java index 85ed7c48e..8f665b1e3 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/App.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; /** * One of possible approaches to terminate Producer-Consumer pattern is using PoisonPill idiom. diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/Consumer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java similarity index 90% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/Consumer.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java index d2892f502..3bb9dcc56 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/Consumer.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java @@ -1,6 +1,6 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; -import com.iluwatar.poisonpill.Message.Headers; +import com.iluwatar.poison.pill.Message.Headers; /** * Class responsible for receiving and handling submitted to the queue messages diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/MQPublishPoint.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java similarity index 81% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/MQPublishPoint.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java index ca3555f52..9c72242be 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/MQPublishPoint.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; /** * Endpoint to publish {@link Message} to queue diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/MQSubscribePoint.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java similarity index 81% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/MQSubscribePoint.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java index 820d82bf3..f689835b6 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/MQSubscribePoint.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; /** * Endpoint to retrieve {@link Message} from queue diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/Message.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java similarity index 96% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/Message.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java index 1ea6c2904..f306e0385 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/Message.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; import java.util.Map; diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/MessageQueue.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java similarity index 84% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/MessageQueue.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java index 3a360cc5c..99231ab51 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/MessageQueue.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MessageQueue.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; /** * Represents abstraction of channel (or pipe) that bounds {@link Producer} and {@link Consumer} diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/Producer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java similarity index 92% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/Producer.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java index 1e4bd9aa3..56d086204 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/Producer.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java @@ -1,8 +1,8 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; import java.util.Date; -import com.iluwatar.poisonpill.Message.Headers; +import com.iluwatar.poison.pill.Message.Headers; /** * Class responsible for producing unit of work that can be expressed as message and submitted to queue diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/SimpleMessage.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java similarity index 95% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/SimpleMessage.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java index 40c990712..61a8664f5 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/SimpleMessage.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; import java.util.Collections; import java.util.HashMap; diff --git a/poison-pill/src/main/java/com/iluwatar/poisonpill/SimpleMessageQueue.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java similarity index 93% rename from poison-pill/src/main/java/com/iluwatar/poisonpill/SimpleMessageQueue.java rename to poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java index cf012d9c4..316ed33e5 100644 --- a/poison-pill/src/main/java/com/iluwatar/poisonpill/SimpleMessageQueue.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java @@ -1,4 +1,4 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.poison.pill; import java.util.concurrent.ArrayBlockingQueue; import java.util.concurrent.BlockingQueue; diff --git a/lazy-loading/src/test/java/com/iluwatar/lazyloading/AppTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java similarity index 63% rename from lazy-loading/src/test/java/com/iluwatar/lazyloading/AppTest.java rename to poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java index 142da8f2e..625d849a2 100644 --- a/lazy-loading/src/test/java/com/iluwatar/lazyloading/AppTest.java +++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java @@ -1,8 +1,8 @@ -package com.iluwatar.lazyloading; +package com.iluwatar.poison.pill; import org.junit.Test; -import com.iluwatar.lazyloading.App; +import com.iluwatar.poison.pill.App; public class AppTest { diff --git a/repository/etc/repository.ucls b/repository/etc/repository.ucls index 6a10449d8..6fcdb4e31 100644 --- a/repository/etc/repository.ucls +++ b/repository/etc/repository.ucls @@ -1,8 +1,8 @@ - + @@ -10,8 +10,8 @@ - + diff --git a/repository/src/main/java/com/iluwatar/App.java b/repository/src/main/java/com/iluwatar/repository/App.java similarity index 98% rename from repository/src/main/java/com/iluwatar/App.java rename to repository/src/main/java/com/iluwatar/repository/App.java index ed7cadc4d..8dd568d51 100644 --- a/repository/src/main/java/com/iluwatar/App.java +++ b/repository/src/main/java/com/iluwatar/repository/App.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.repository; import java.util.List; diff --git a/repository/src/main/java/com/iluwatar/Person.java b/repository/src/main/java/com/iluwatar/repository/Person.java similarity index 96% rename from repository/src/main/java/com/iluwatar/Person.java rename to repository/src/main/java/com/iluwatar/repository/Person.java index d3fadeb89..85d647b1a 100644 --- a/repository/src/main/java/com/iluwatar/Person.java +++ b/repository/src/main/java/com/iluwatar/repository/Person.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.repository; import javax.persistence.Entity; import javax.persistence.GeneratedValue; diff --git a/repository/src/main/java/com/iluwatar/PersonDao.java b/repository/src/main/java/com/iluwatar/repository/PersonDao.java similarity index 90% rename from repository/src/main/java/com/iluwatar/PersonDao.java rename to repository/src/main/java/com/iluwatar/repository/PersonDao.java index f59bfa292..bb8ba854b 100644 --- a/repository/src/main/java/com/iluwatar/PersonDao.java +++ b/repository/src/main/java/com/iluwatar/repository/PersonDao.java @@ -1,4 +1,4 @@ -package com.iluwatar; +package com.iluwatar.repository; import java.util.List; diff --git a/poison-pill/src/test/java/com/iluwatar/poisonpill/AppTest.java b/repository/src/test/java/com/iluwatar/repository/AppTest.java similarity index 64% rename from poison-pill/src/test/java/com/iluwatar/poisonpill/AppTest.java rename to repository/src/test/java/com/iluwatar/repository/AppTest.java index 6d39c06bb..2e638ba6b 100644 --- a/poison-pill/src/test/java/com/iluwatar/poisonpill/AppTest.java +++ b/repository/src/test/java/com/iluwatar/repository/AppTest.java @@ -1,8 +1,8 @@ -package com.iluwatar.poisonpill; +package com.iluwatar.repository; import org.junit.Test; -import com.iluwatar.poisonpill.App; +import com.iluwatar.repository.App; public class AppTest { diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/App.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java similarity index 95% rename from resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/App.java rename to resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java index ebf8a1dc7..b947d31d0 100644 --- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/App.java +++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java @@ -1,4 +1,4 @@ -package com.iluwatar.resourceacquisitionisinitialization; +package com.iluwatar.resource.acquisition.is.initialization; /** * diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/SlidingDoor.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java similarity index 81% rename from resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/SlidingDoor.java rename to resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java index c7181c8ba..2033707e6 100644 --- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/SlidingDoor.java +++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java @@ -1,4 +1,4 @@ -package com.iluwatar.resourceacquisitionisinitialization; +package com.iluwatar.resource.acquisition.is.initialization; /** * diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/TreasureChest.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java similarity index 84% rename from resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/TreasureChest.java rename to resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java index c8f6b8ba4..4d6b1a863 100644 --- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resourceacquisitionisinitialization/TreasureChest.java +++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java @@ -1,4 +1,4 @@ -package com.iluwatar.resourceacquisitionisinitialization; +package com.iluwatar.resource.acquisition.is.initialization; import java.io.Closeable; import java.io.IOException; diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resourceacquisitionisinitialization/AppTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java similarity index 53% rename from resource-acquisition-is-initialization/src/test/java/com/iluwatar/resourceacquisitionisinitialization/AppTest.java rename to resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java index 5f71bbddf..097ea4711 100644 --- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resourceacquisitionisinitialization/AppTest.java +++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java @@ -1,8 +1,8 @@ -package com.iluwatar.resourceacquisitionisinitialization; +package com.iluwatar.resource.acquisition.is.initialization; import org.junit.Test; -import com.iluwatar.resourceacquisitionisinitialization.App; +import com.iluwatar.resource.acquisition.is.initialization.App; public class AppTest { From 4c22055e4772d121a622c8f7b8664517b016aaa8 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sat, 25 Jul 2015 15:58:12 +0530 Subject: [PATCH 049/687] Implemented half sync half async pattern --- half-sync-half-async/pom.xml | 32 ++++++++++++ .../AsynchronousService.java | 51 +++++++++++++++++++ .../halfsynchalfasync/SynchronousLayer.java | 32 ++++++++++++ .../AsynchronousServiceTest.java | 45 ++++++++++++++++ 4 files changed, 160 insertions(+) create mode 100644 half-sync-half-async/pom.xml create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java create mode 100644 half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml new file mode 100644 index 000000000..a70b79ec8 --- /dev/null +++ b/half-sync-half-async/pom.xml @@ -0,0 +1,32 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.5.0 + + half-sync-half-async + + + junit + junit + test + + + org.mockito + mockito-all + test + + + + + + org.mockito + mockito-all + 1.9.5 + + + + diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java new file mode 100644 index 000000000..81186b433 --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java @@ -0,0 +1,51 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.Callable; +import java.util.concurrent.Future; +import java.util.concurrent.ThreadPoolExecutor; + +/** + * 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 threads one of the thread + * picks up the task and executes it in background and the result is posted back to the caller via + * {@link Future}. + */ +public abstract class AsynchronousService { + + /* + * This is the synchronous layer to which request to do work is submitted. + */ + private SynchronousLayer syncLayer = new SynchronousLayer(); + + /** + * Computes arithmetic sum for n + * + * @return future representing arithmetic sum of n + */ + public Future execute(final I input) { + /* + * This is the key part of this pattern where the caller thread does not block until + * the result of work is computed but is delegated to the synchronous layer which + * computes the task in background. This is useful if caller thread is an UI thread, + * which MUST remain responsive to user inputs. + */ + return syncLayer.submit(new Callable() { + + @Override + public O call() throws Exception { + return doInBackground(input); + } + + }); + } + + /** + * This method is called in context of background thread where the implementation should compute + * and return the result for input. + * + * @return computed result + */ + protected abstract O doInBackground(I input); +} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java new file mode 100644 index 000000000..9853ce8e2 --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java @@ -0,0 +1,32 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.Callable; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Future; +import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.ThreadPoolExecutor; +import java.util.concurrent.TimeUnit; + +/** + * This represents the Queuing and Synchronous layer of Half-Sync/Half-Async pattern. + * The incoming requests are queued and then picked up by the background threads for execution. + */ +public class SynchronousLayer { + + /* + * This is the queuing layer where incoming work is queued + */ + private LinkedBlockingQueue tasks = new LinkedBlockingQueue(); + /* + * This is the synchronous layer where background threads execute the work + */ + private ExecutorService service = new ThreadPoolExecutor(10, 10, 10, TimeUnit.SECONDS, tasks); + + /** + * Submit new work for backgrounds threads to compute + * @return the result after executing the work + */ + public Future submit(Callable work) { + return service.submit(work); + } +} diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java new file mode 100644 index 000000000..a938628df --- /dev/null +++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java @@ -0,0 +1,45 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.ExecutionException; +import java.util.concurrent.Future; + +import org.junit.Test; +import static org.junit.Assert.*; + +public class AsynchronousServiceTest { + + @Test + public void test() throws InterruptedException, ExecutionException { + /* + * Addition service is asynchronous layer which does not block on single request, + * and is always available for listening new requests. + */ + ArithmeticSumService service = new ArithmeticSumService(); + Future output1 = service.execute(100L); + Future output2 = service.execute(50L); + Future output3 = service.execute(200L); + Future output4 = service.execute(5L); + + assertEquals(ap(100), output1.get().longValue()); + assertEquals(ap(50), output2.get().longValue()); + assertEquals(ap(200), output3.get().longValue()); + assertEquals(ap(5), output4.get().longValue()); + } + + /* + * This is an asynchronous service which computes arithmetic sum + */ + class ArithmeticSumService extends AsynchronousService { + + @Override + protected Long doInBackground(Long n) { + return (n) * (n + 1) / 2; + } + } + + private long ap(int i) { + long out = (i) * (i + 1) / 2; + System.out.println(out); + return out; + } +} From dc4904c8d0dde8c278e362854a5db7e52684036b Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Mon, 27 Jul 2015 15:29:56 +0530 Subject: [PATCH 050/687] Changed the implementation for better understanding --- .../iluwatar/halfsynchalfasync/AsyncTask.java | 29 ++++++++++ .../AsynchronousService.java | 32 +++-------- .../halfsynchalfasync/QueuingLayer.java | 8 +++ .../halfsynchalfasync/SynchronousLayer.java | 46 +++++++++++---- .../AsynchronousServiceTest.java | 57 ++++++++++++------- 5 files changed, 117 insertions(+), 55 deletions(-) create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java new file mode 100644 index 000000000..1b9026c8b --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java @@ -0,0 +1,29 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.Callable; + +/** + * Represents some computation that is performed asynchronously. The computation is typically + * done is background threads and the result is posted back in form of callback. + * + * @param type of result + */ +public interface AsyncTask extends Callable { + /** + * Is called in context of caller thread before call to {@link #call()}. + * Validations can be performed here so that the performance penalty of context + * switching is not incurred. + */ + void preExecute(); + + /** + * Is a callback which is called after the result is successfully computed by + * {@link #call()}. + */ + void onResult(O result); + + void onError(Throwable throwable); + + @Override + O call() throws Exception; +} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java index 81186b433..1be5941c5 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java @@ -1,7 +1,6 @@ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.BlockingQueue; -import java.util.concurrent.Callable; import java.util.concurrent.Future; import java.util.concurrent.ThreadPoolExecutor; @@ -12,40 +11,27 @@ import java.util.concurrent.ThreadPoolExecutor; * picks up the task and executes it in background and the result is posted back to the caller via * {@link Future}. */ -public abstract class AsynchronousService { +public class AsynchronousService { /* - * This is the synchronous layer to which request to do work is submitted. + * This is the synchronous layer to which request to do work is delegated. */ - private SynchronousLayer syncLayer = new SynchronousLayer(); + private SynchronousLayer syncLayer; + + public AsynchronousService(QueuingLayer queuingLayer) { + this.syncLayer = new SynchronousLayer(queuingLayer); + } /** - * Computes arithmetic sum for n * - * @return future representing arithmetic sum of n */ - public Future execute(final I input) { + public void execute(final AsyncTask task) { /* * This is the key part of this pattern where the caller thread does not block until * the result of work is computed but is delegated to the synchronous layer which * computes the task in background. This is useful if caller thread is an UI thread, * which MUST remain responsive to user inputs. */ - return syncLayer.submit(new Callable() { - - @Override - public O call() throws Exception { - return doInBackground(input); - } - - }); + syncLayer.execute(task); } - - /** - * This method is called in context of background thread where the implementation should compute - * and return the result for input. - * - * @return computed result - */ - protected abstract O doInBackground(I input); } diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java new file mode 100644 index 000000000..82515e393 --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java @@ -0,0 +1,8 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.BlockingQueue; +import java.util.concurrent.LinkedBlockingQueue; + +public class QueuingLayer { + BlockingQueue incomingQueue = new LinkedBlockingQueue<>(); +} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java index 9853ce8e2..42d329f8a 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java @@ -1,32 +1,54 @@ package com.iluwatar.halfsynchalfasync; -import java.util.concurrent.Callable; +import java.util.concurrent.ExecutionException; import java.util.concurrent.ExecutorService; -import java.util.concurrent.Future; -import java.util.concurrent.LinkedBlockingQueue; +import java.util.concurrent.FutureTask; import java.util.concurrent.ThreadPoolExecutor; import java.util.concurrent.TimeUnit; /** * This represents the Queuing and Synchronous layer of Half-Sync/Half-Async pattern. - * The incoming requests are queued and then picked up by the background threads for execution. + * The {@link ThreadPoolExecutor} plays role of both Queuing layer as well as Synchronous layer + * of the pattern, where incoming tasks are queued if no worker is available. */ public class SynchronousLayer { /* - * This is the queuing layer where incoming work is queued + * This is the synchronous layer where background threads execute the work. */ - private LinkedBlockingQueue tasks = new LinkedBlockingQueue(); - /* - * This is the synchronous layer where background threads execute the work - */ - private ExecutorService service = new ThreadPoolExecutor(10, 10, 10, TimeUnit.SECONDS, tasks); + private ExecutorService service; + /** + * Creates synchronous layer which uses queuing layer to wait for incoming tasks to execute. + */ + public SynchronousLayer(QueuingLayer queuingLayer) { + service = new ThreadPoolExecutor(10, 10, 10, TimeUnit.SECONDS, queuingLayer.incomingQueue); + } /** * Submit new work for backgrounds threads to compute * @return the result after executing the work */ - public Future submit(Callable work) { - return service.submit(work); + public void execute(final AsyncTask work) { + work.preExecute(); + + service.submit(new FutureTask(work) { + @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. + */ + work.onResult(get()); + } catch (InterruptedException e) { + // should not occur + } catch (ExecutionException e) { + work.onError(e.getCause()); + } + } + }); } } diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java index a938628df..4a9976da1 100644 --- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java +++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java @@ -1,10 +1,11 @@ package com.iluwatar.halfsynchalfasync; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.fail; + import java.util.concurrent.ExecutionException; -import java.util.concurrent.Future; import org.junit.Test; -import static org.junit.Assert.*; public class AsynchronousServiceTest { @@ -14,32 +15,48 @@ public class AsynchronousServiceTest { * Addition service is asynchronous layer which does not block on single request, * and is always available for listening new requests. */ - ArithmeticSumService service = new ArithmeticSumService(); - Future output1 = service.execute(100L); - Future output2 = service.execute(50L); - Future output3 = service.execute(200L); - Future output4 = service.execute(5L); + QueuingLayer queuingLayer = new QueuingLayer(); + new SynchronousLayer(queuingLayer); + AsynchronousService service = new AsynchronousService(queuingLayer); - assertEquals(ap(100), output1.get().longValue()); - assertEquals(ap(50), output2.get().longValue()); - assertEquals(ap(200), output3.get().longValue()); - assertEquals(ap(5), output4.get().longValue()); + service.execute(new ArithmeticSumTask(100)); + service.execute(new ArithmeticSumTask(50)); + service.execute(new ArithmeticSumTask(200)); + service.execute(new ArithmeticSumTask(5)); } - /* - * This is an asynchronous service which computes arithmetic sum - */ - class ArithmeticSumService extends AsynchronousService { + class ArithmeticSumTask implements AsyncTask { + private long n; + + public ArithmeticSumTask(long n) { + this.n = n; + } + + @Override + public Long call() throws Exception { + return ap(n); + } @Override - protected Long doInBackground(Long n) { - return (n) * (n + 1) / 2; + public void preExecute() { + if (n < 0) { + throw new IllegalArgumentException("n is less than 0"); + } + } + + @Override + public void onResult(Long result) { + assertEquals(ap(n), result.longValue()); + } + + @Override + public void onError(Throwable throwable) { + fail("Should not occur"); } } - - private long ap(int i) { + + private long ap(long i) { long out = (i) * (i + 1) / 2; - System.out.println(out); return out; } } From eeef8bf4754864b16fe24c3cbdf64b3b947f4f80 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Mon, 27 Jul 2015 17:38:15 +0530 Subject: [PATCH 051/687] Refactored code --- .../iluwatar/halfsynchalfasync/AsyncTask.java | 26 +++++-- .../AsynchronousService.java | 76 ++++++++++++++----- .../halfsynchalfasync/QueuingLayer.java | 8 -- .../halfsynchalfasync/SynchronousLayer.java | 54 ------------- .../iluwatar/halfsynchalfasync/AppTest.java | 13 ++++ .../AsynchronousServiceTest.java | 62 --------------- 6 files changed, 90 insertions(+), 149 deletions(-) delete mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java delete mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java create mode 100644 half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java delete mode 100644 half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java index 1b9026c8b..d773ff93f 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java @@ -3,27 +3,39 @@ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.Callable; /** - * Represents some computation that is performed asynchronously. The computation is typically - * done is background threads and the result is posted back in form of callback. + * 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()}. - * Validations can be performed here so that the performance penalty of context - * switching is not incurred. + * Is called in context of caller thread before call to {@link #call()}. Large + * tasks should not be performed in this method. Validations can be performed here + * so that the performance penalty of context switching is not incurred in case of + * invalid requests. */ void preExecute(); /** - * Is a callback which is called after the result is successfully computed by - * {@link #call()}. + * A callback called after the result is successfully computed by {@link #call()}. */ void onResult(O result); + /** + * A callback called if computing the task resulted in some exception. This method + * is called when either of {@link #call()} or {@link #preExecute()} 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; } diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java index 1be5941c5..8b858747e 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java @@ -1,37 +1,77 @@ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.BlockingQueue; -import java.util.concurrent.Future; +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 threads one of the thread - * picks up the task and executes it in background and the result is posted back to the caller via - * {@link Future}. + * 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 is the synchronous layer to which request to do work is delegated. + * 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 SynchronousLayer syncLayer; - - public AsynchronousService(QueuingLayer queuingLayer) { - this.syncLayer = new SynchronousLayer(queuingLayer); + 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#onResult(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)}. + *

+ * 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 + *
+ *

+ * NOTE: The results are posted back in the context of background thread in this implementation. + * There is other variant possible where the result is posted back in the queue of caller thread + * and then the result is processed in context of caller thread. */ - public void execute(final AsyncTask task) { - /* - * This is the key part of this pattern where the caller thread does not block until - * the result of work is computed but is delegated to the synchronous layer which - * computes the task in background. This is useful if caller thread is an UI thread, - * which MUST remain responsive to user inputs. - */ - syncLayer.execute(task); + public void execute(final AsyncTask task) { + try { + // some small tasks such as validation can be performed here. + task.preExecute(); + } catch (Exception e) { + task.onError(e); + } + + 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.onResult(get()); + } catch (InterruptedException e) { + // should not occur + } catch (ExecutionException e) { + task.onError(e.getCause()); + } + } + }); } } diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java deleted file mode 100644 index 82515e393..000000000 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/QueuingLayer.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.iluwatar.halfsynchalfasync; - -import java.util.concurrent.BlockingQueue; -import java.util.concurrent.LinkedBlockingQueue; - -public class QueuingLayer { - BlockingQueue incomingQueue = new LinkedBlockingQueue<>(); -} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java deleted file mode 100644 index 42d329f8a..000000000 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/SynchronousLayer.java +++ /dev/null @@ -1,54 +0,0 @@ -package com.iluwatar.halfsynchalfasync; - -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 represents the Queuing and Synchronous layer of Half-Sync/Half-Async pattern. - * The {@link ThreadPoolExecutor} plays role of both Queuing layer as well as Synchronous layer - * of the pattern, where incoming tasks are queued if no worker is available. - */ -public class SynchronousLayer { - - /* - * This is the synchronous layer where background threads execute the work. - */ - private ExecutorService service; - - /** - * Creates synchronous layer which uses queuing layer to wait for incoming tasks to execute. - */ - public SynchronousLayer(QueuingLayer queuingLayer) { - service = new ThreadPoolExecutor(10, 10, 10, TimeUnit.SECONDS, queuingLayer.incomingQueue); - } - /** - * Submit new work for backgrounds threads to compute - * @return the result after executing the work - */ - public void execute(final AsyncTask work) { - work.preExecute(); - - service.submit(new FutureTask(work) { - @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. - */ - work.onResult(get()); - } catch (InterruptedException e) { - // should not occur - } catch (ExecutionException e) { - work.onError(e.getCause()); - } - } - }); - } -} diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java new file mode 100644 index 000000000..54f6ea5a7 --- /dev/null +++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java @@ -0,0 +1,13 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.ExecutionException; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() throws InterruptedException, ExecutionException { + App.main(null); + } +} diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java deleted file mode 100644 index 4a9976da1..000000000 --- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AsynchronousServiceTest.java +++ /dev/null @@ -1,62 +0,0 @@ -package com.iluwatar.halfsynchalfasync; - -import static org.junit.Assert.assertEquals; -import static org.junit.Assert.fail; - -import java.util.concurrent.ExecutionException; - -import org.junit.Test; - -public class AsynchronousServiceTest { - - @Test - public void test() throws InterruptedException, ExecutionException { - /* - * Addition service is asynchronous layer which does not block on single request, - * and is always available for listening new requests. - */ - QueuingLayer queuingLayer = new QueuingLayer(); - new SynchronousLayer(queuingLayer); - AsynchronousService service = new AsynchronousService(queuingLayer); - - service.execute(new ArithmeticSumTask(100)); - service.execute(new ArithmeticSumTask(50)); - service.execute(new ArithmeticSumTask(200)); - service.execute(new ArithmeticSumTask(5)); - } - - class ArithmeticSumTask implements AsyncTask { - private long n; - - public ArithmeticSumTask(long n) { - this.n = n; - } - - @Override - public Long call() throws Exception { - return ap(n); - } - - @Override - public void preExecute() { - if (n < 0) { - throw new IllegalArgumentException("n is less than 0"); - } - } - - @Override - public void onResult(Long result) { - assertEquals(ap(n), result.longValue()); - } - - @Override - public void onError(Throwable throwable) { - fail("Should not occur"); - } - } - - private long ap(long i) { - long out = (i) * (i + 1) / 2; - return out; - } -} From afd5612e17abeca9d41c8c0f71844613c1d09875 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Mon, 27 Jul 2015 20:52:00 +0300 Subject: [PATCH 052/687] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 753b500bb..f1522d25f 100644 --- a/README.md +++ b/README.md @@ -783,7 +783,7 @@ As for performance and scalability, pools can become bottlenecks, if all the poo # Versioning -Java-design-patterns project uses [semantic versioning](http://semver.org/) scheme. +Java-design-patterns project uses [semantic versioning](http://semver.org/) scheme. However, version numbers in this project do not signify binary releases (since we don't make any) but rather milestones achieved on the roadmap. In other words, version numbers are used only for project planning sake. From 3adffb62da865c887d8757d12214d98927f868cb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Mon, 27 Jul 2015 21:00:30 +0300 Subject: [PATCH 053/687] Update README.md --- README.md | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index f1522d25f..cd100d7c6 100644 --- a/README.md +++ b/README.md @@ -754,20 +754,23 @@ As for performance and scalability, pools can become bottlenecks, if all the poo # How to contribute -**To add a new pattern** you need to do the following steps: +**To work on a new pattern** you need to do the following steps: -1. Fork the repository. -2. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. -3. Create a simple class diagram from your example code. -4. Add description of the pattern in README.md and link to the class diagram. +1. If there is no issue for the new pattern yet, raise new issue. Comment on the issue that you are working on it so that others don't start work on the same thing. +2. Fork the repository. +3. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. +4. Create a simple class diagram from your example code. +5. Add description of the pattern in README.md and link to the class diagram. +6. Create a pull request. + +**To work on one of the non-pattern issues** you need to do the following steps: + +1. Check that the issue has "help wanted" badge +2. Comment on the issue that you are working on it +3. Fork the repository. +4. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. 5. Create a pull request. -**To work on one of the raised issues** you need to do the following steps: - -1. Fork the repository. -2. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. -3. Create a pull request. - **For creating/editing UML diagrams** you need [ObjectAid UML Explorer for Eclipse](http://www.objectaid.com/home). **For inspiration** check out the following sources: From f778b2cc04a4e0f72314a3277d6eea0dd791b756 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 29 Jul 2015 16:12:27 +0530 Subject: [PATCH 054/687] Changed method names and did proper documentation --- .../etc/half-sync-half-async.png | Bin 0 -> 32866 bytes .../etc/half-sync-half-async.ucls | 77 ++++++++++++ .../com/iluwatar/halfsynchalfasync/App.java | 118 ++++++++++++++++++ .../iluwatar/halfsynchalfasync/AsyncTask.java | 17 +-- .../AsynchronousService.java | 8 +- 5 files changed, 208 insertions(+), 12 deletions(-) create mode 100644 half-sync-half-async/etc/half-sync-half-async.png create mode 100644 half-sync-half-async/etc/half-sync-half-async.ucls create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java diff --git a/half-sync-half-async/etc/half-sync-half-async.png b/half-sync-half-async/etc/half-sync-half-async.png new file mode 100644 index 0000000000000000000000000000000000000000..84658dfdeafcdfd782629c4b55060404d04323a0 GIT binary patch literal 32866 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 literal 0 HcmV?d00001 diff --git a/half-sync-half-async/etc/half-sync-half-async.ucls b/half-sync-half-async/etc/half-sync-half-async.ucls new file mode 100644 index 000000000..5b9941872 --- /dev/null +++ b/half-sync-half-async/etc/half-sync-half-async.ucls @@ -0,0 +1,77 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java new file mode 100644 index 000000000..77b1988ba --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java @@ -0,0 +1,118 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.LinkedBlockingQueue; + +/** + * This application demonstrates Half-Sync/Half-Async pattern. Key parts of the pattern are + * {@link AsyncTask} and {@link AsynchronousService}. + * + *

+ * + *

+ * 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 { + + 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)); + } + + 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 + System.out.println(result); + } + + @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) { + } + return (i) * (i + 1) / 2; + } +} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java index d773ff93f..8ed7376b6 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java @@ -13,20 +13,23 @@ import java.util.concurrent.Callable; 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. Validations can be performed here - * so that the performance penalty of context switching is not incurred in case of - * invalid requests. + * 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 preExecute(); + void onPreCall(); /** - * A callback called after the result is successfully computed by {@link #call()}. + * 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 onResult(O result); + 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 #preExecute()} throw any exception. + * is called when either of {@link #call()} or {@link #onPreCall()} throw any exception. * * @param throwable error cause */ diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java index 8b858747e..6c36354d0 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java @@ -38,18 +38,16 @@ public class AsynchronousService { * 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#onResult(Object)}, if task execution is unable to complete normally + * {@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. - * There is other variant possible where the result is posted back in the queue of caller thread - * and then the result is processed in context of caller thread. */ public void execute(final AsyncTask task) { try { // some small tasks such as validation can be performed here. - task.preExecute(); + task.onPreCall(); } catch (Exception e) { task.onError(e); } @@ -65,7 +63,7 @@ public class AsynchronousService { * where the UI elements can only be updated using UI thread. So result must be * posted back in UI thread. */ - task.onResult(get()); + task.onPostCall(get()); } catch (InterruptedException e) { // should not occur } catch (ExecutionException e) { From 013386459a062c5037e39f685a81c8425cd9c159 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 29 Jul 2015 16:18:53 +0530 Subject: [PATCH 055/687] removed unnecessary dependency from pom --- half-sync-half-async/pom.xml | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml index a70b79ec8..edbc2e420 100644 --- a/half-sync-half-async/pom.xml +++ b/half-sync-half-async/pom.xml @@ -14,19 +14,5 @@ junit test - - org.mockito - mockito-all - test - - - - - org.mockito - mockito-all - 1.9.5 - - - From 88c2e7dacd0e646a27127ba50192d35d57900d39 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 29 Jul 2015 16:50:36 +0530 Subject: [PATCH 056/687] Changed improper description about double dispatch in FAQ section --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cd100d7c6..109428295 100644 --- a/README.md +++ b/README.md @@ -736,7 +736,7 @@ While the implementations look similar there are differences. The Chain of Respo **Q: What is the difference between Visitor and Double Dispatch patterns?** -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 support directly. +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. **Q: What are the differences between Flyweight and Object Pool patterns?** From 5978bbee51e49c1ebc698c67c1d3e2709a1da431 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Thu, 30 Jul 2015 10:48:17 +0530 Subject: [PATCH 057/687] Added description of Half-Sync/Half-Async pattern --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index cd100d7c6..3d64fc4c5 100644 --- a/README.md +++ b/README.md @@ -72,6 +72,7 @@ Concurrency patterns are those types of design patterns that deal with the multi * [Double Checked Locking](#double-checked-locking) * [Thread Pool](#thread-pool) * [Async Method Invocation](#async-method-invocation) +* [Half-Sync/Half-Async](#half-sync-half-async) ### Presentation Tier Patterns @@ -714,7 +715,22 @@ validation and for building to order * you want to orchestrate calls to multiple business services * you want to encapsulate service lookups and service calls +## Half-Sync/Half-Async [↑](#list-of-design-patterns) +**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](./half-sync-half-async/etc/half-sync-half-async.png) + +**Applicability:** Use Half-Sync/Half-Async pattern when +* A system possesses following characteristics: + * 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) # Frequently asked questions From b9b94f079dbe5c358ad27bfdc7ec42173c00c3da Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Thu, 30 Jul 2015 10:53:23 +0530 Subject: [PATCH 058/687] Updated pom to add half-sync-half-async module to parent pom --- pom.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index db468a2fb..13105f139 100644 --- a/pom.xml +++ b/pom.xml @@ -71,7 +71,8 @@ front-controller repository async-method-invocation - business-delegate + business-delegate + half-sync-half-async From 960fac5ea004489bd3b9ef8e8029c4f4dd7310d5 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sat, 25 Jul 2015 15:58:12 +0530 Subject: [PATCH 059/687] Implemented half sync half async pattern #109 --- README.md | 16 +++ .../etc/half-sync-half-async.png | Bin 0 -> 32866 bytes .../etc/half-sync-half-async.ucls | 77 ++++++++++++ half-sync-half-async/pom.xml | 18 +++ .../com/iluwatar/halfsynchalfasync/App.java | 118 ++++++++++++++++++ .../iluwatar/halfsynchalfasync/AsyncTask.java | 44 +++++++ .../AsynchronousService.java | 75 +++++++++++ .../iluwatar/halfsynchalfasync/AppTest.java | 13 ++ pom.xml | 3 +- 9 files changed, 363 insertions(+), 1 deletion(-) create mode 100644 half-sync-half-async/etc/half-sync-half-async.png create mode 100644 half-sync-half-async/etc/half-sync-half-async.ucls create mode 100644 half-sync-half-async/pom.xml create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java create mode 100644 half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java create mode 100644 half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java diff --git a/README.md b/README.md index 109428295..bf763787a 100644 --- a/README.md +++ b/README.md @@ -72,6 +72,7 @@ Concurrency patterns are those types of design patterns that deal with the multi * [Double Checked Locking](#double-checked-locking) * [Thread Pool](#thread-pool) * [Async Method Invocation](#async-method-invocation) +* [Half-Sync/Half-Async](#half-sync-half-async) ### Presentation Tier Patterns @@ -714,7 +715,22 @@ validation and for building to order * you want to orchestrate calls to multiple business services * you want to encapsulate service lookups and service calls +## Half-Sync/Half-Async [↑](#list-of-design-patterns) +**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](./half-sync-half-async/etc/half-sync-half-async.png) + +**Applicability:** Use Half-Sync/Half-Async pattern when +* A system possesses following characteristics: + * 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) # Frequently asked questions diff --git a/half-sync-half-async/etc/half-sync-half-async.png b/half-sync-half-async/etc/half-sync-half-async.png new file mode 100644 index 0000000000000000000000000000000000000000..84658dfdeafcdfd782629c4b55060404d04323a0 GIT binary patch literal 32866 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 literal 0 HcmV?d00001 diff --git a/half-sync-half-async/etc/half-sync-half-async.ucls b/half-sync-half-async/etc/half-sync-half-async.ucls new file mode 100644 index 000000000..5b9941872 --- /dev/null +++ b/half-sync-half-async/etc/half-sync-half-async.ucls @@ -0,0 +1,77 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml new file mode 100644 index 000000000..edbc2e420 --- /dev/null +++ b/half-sync-half-async/pom.xml @@ -0,0 +1,18 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.5.0 + + half-sync-half-async + + + junit + junit + test + + + diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java new file mode 100644 index 000000000..77b1988ba --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java @@ -0,0 +1,118 @@ +package com.iluwatar.halfsynchalfasync; + +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 + *
+ *

+ * + *

+ * 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 { + + 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)); + } + + 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 + System.out.println(result); + } + + @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) { + } + return (i) * (i + 1) / 2; + } +} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java new file mode 100644 index 000000000..8ed7376b6 --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java @@ -0,0 +1,44 @@ +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; +} diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java new file mode 100644 index 000000000..6c36354d0 --- /dev/null +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java @@ -0,0 +1,75 @@ +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); + } + + 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()); + } + } + }); + } +} diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java new file mode 100644 index 000000000..54f6ea5a7 --- /dev/null +++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java @@ -0,0 +1,13 @@ +package com.iluwatar.halfsynchalfasync; + +import java.util.concurrent.ExecutionException; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() throws InterruptedException, ExecutionException { + App.main(null); + } +} diff --git a/pom.xml b/pom.xml index db468a2fb..13105f139 100644 --- a/pom.xml +++ b/pom.xml @@ -71,7 +71,8 @@ front-controller repository async-method-invocation - business-delegate + business-delegate + half-sync-half-async From fba92e281d493561c668a37136c914160c61fbeb Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Thu, 30 Jul 2015 12:41:24 +0530 Subject: [PATCH 060/687] Changed the absolute links in README to relative links for issue #180 --- README.md | 106 +++++++++++++++++++++++++++--------------------------- 1 file changed, 53 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index 109428295..5f71b69ce 100644 --- a/README.md +++ b/README.md @@ -116,7 +116,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Abstract Factory [↑](#list-of-design-patterns) **Intent:** Provide an interface for creating families of related or dependent objects without specifying their concrete classes. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/abstract-factory/etc/abstract-factory_1.png "Abstract Factory") +![alt text](./abstract-factory/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 @@ -130,7 +130,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Builder [↑](#list-of-design-patterns) **Intent:** Separate the construction of a complex object from its representation so that the same construction process can create different representations. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/builder/etc/builder_1.png "Builder") +![alt text](./builder/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 @@ -143,7 +143,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Factory Method [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/factory-method/etc/factory-method_1.png "Factory Method") +![alt text](./factory-method/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 @@ -153,7 +153,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Prototype [↑](#list-of-design-patterns) **Intent:** Specify the kinds of objects to create using a prototypical instance, and create new objects by copying this prototype. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/prototype/etc/prototype_1.png "Prototype") +![alt text](./prototype/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 @@ -166,7 +166,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Singleton [↑](#list-of-design-patterns) **Intent:** Ensure a class only has one instance, and provide a global point of access to it. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/singleton/etc/singleton_1.png "Singleton") +![alt text](./singleton/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 @@ -183,7 +183,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Adapter [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/adapter/etc/adapter_1.png "Adapter") +![alt text](./adapter/etc/adapter_1.png "Adapter") **Applicability:** Use the Adapter pattern when * you want to use an existing class, and its interface does not match the one you need @@ -197,7 +197,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor **Intent:** Decouple an abstraction from its implementation so that the two can vary independently. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/bridge/etc/bridge_1.png "Bridge") +![alt text](./bridge/etc/bridge_1.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. @@ -209,7 +209,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Composite [↑](#list-of-design-patterns) **Intent:** Compose objects into tree structures to represent part-whole hierarchies. Composite lets clients treat individual objects and compositions of objects uniformly. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/composite/etc/composite_1.png "Composite") +![alt text](./composite/etc/composite_1.png "Composite") **Applicability:** Use the Composite pattern when * you want to represent part-whole hierarchies of objects @@ -222,7 +222,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Decorator [↑](#list-of-design-patterns) **Intent:** Attach additional responsibilities to an object dynamically. Decorators provide a flexible alternative to subclassing for extending functionality. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/decorator/etc/decorator_1.png "Decorator") +![alt text](./decorator/etc/decorator_1.png "Decorator") **Applicability:** Use Decorator * to add responsibilities to individual objects dynamically and transparently, that is, without affecting other objects @@ -232,7 +232,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Facade [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/facade/etc/facade_1.png "Facade") +![alt text](./facade/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. @@ -242,7 +242,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Flyweight [↑](#list-of-design-patterns) **Intent:** Use sharing to support large numbers of fine-grained objects efficiently. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/flyweight/etc/flyweight_1.png "Flyweight") +![alt text](./flyweight/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 @@ -257,7 +257,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Proxy [↑](#list-of-design-patterns) **Intent:** Provide a surrogate or placeholder for another object to control access to it. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/proxy/etc/proxy_1.png "Proxy") +![alt text](./proxy/etc/proxy_1.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 @@ -280,7 +280,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Service Locator [↑](#list-of-design-patterns) **Intent:** Encapsulate the processes involved in obtaining a service with a strong abstraction layer. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy") +![alt text](./service-locator/etc/service-locator.png "Proxy") **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 relavant 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. @@ -293,7 +293,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Chain of responsibility [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/chain/etc/chain_1.png "Chain of Responsibility") +![alt text](./chain/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 @@ -307,7 +307,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Command [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/command/etc/command.png "Command") +![alt text](./command/etc/command.png "Command") **Applicability:** Use the Command pattern when you want to @@ -329,7 +329,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Interpreter [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/interpreter/etc/interpreter_1.png "Interpreter") +![alt text](./interpreter/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 @@ -338,7 +338,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Iterator [↑](#list-of-design-patterns) **Intent:** Provide a way to access the elements of an aggregate object sequentially without exposing its underlying representation. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/iterator/etc/iterator_1.png "Iterator") +![alt text](./iterator/etc/iterator_1.png "Iterator") **Applicability:** Use the Iterator pattern * to access an aggregate object's contents without exposing its internal representation @@ -351,7 +351,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Mediator [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/mediator/etc/mediator_1.png "Mediator") +![alt text](./mediator/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 @@ -361,7 +361,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Memento [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/memento/etc/memento.png "Memento") +![alt text](./memento/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 @@ -373,7 +373,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Observer [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/observer/etc/observer_1.png "Observer") +![alt text](./observer/etc/observer_1.png "Observer") **Applicability:** Use the Observer pattern in any of the following situations @@ -391,7 +391,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## State [↑](#list-of-design-patterns) **Intent:** Allow an object to alter its behavior when its internal state changes. The object will appear to change its class. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/state/etc/state_1.png "State") +![alt text](./state/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 @@ -400,7 +400,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Strategy [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/strategy/etc/strategy_1.png "Strategy") +![alt text](./strategy/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 @@ -411,7 +411,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Template method [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/template-method/etc/template-method_1.png "Template Method") +![alt text](./template-method/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 @@ -421,7 +421,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Visitor [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/visitor/etc/visitor_1.png "Visitor") +![alt text](./visitor/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 @@ -434,7 +434,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Model-View-Presenter [↑](#list-of-design-patterns) **Intent:** Apply a "Separation of Concerns" principle in a way that allows developers to build and test user interfaces. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/model-view-presenter/etc/model-view-presenter_1.png "Model-View-Presenter") +![alt text](./model-view-presenter/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 @@ -443,7 +443,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Data Access Object [↑](#list-of-design-patterns) **Intent:** Object provides an abstract interface to some type of database or other persistence mechanism. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/dao/etc/dao.png "Data Access Object") +![alt text](./dao/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 @@ -452,7 +452,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Double Checked Locking [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/double-checked-locking/etc/double_checked_locking_1.png "Double Checked Locking") +![alt text](./double-checked-locking/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. @@ -461,7 +461,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Servant [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/servant/etc/servant-pattern.png "Servant") +![alt text](./servant/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. @@ -469,7 +469,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Null Object [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/null-object/etc/null-object.png "Null Object") +![alt text](./null-object/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. @@ -477,7 +477,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Event Aggregator [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/event-aggregator/etc/classes.png "Event Aggregator") +![alt text](./event-aggregator/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. @@ -485,7 +485,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Callback [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/callback/etc/callback.png "Callback") +![alt text](./callback/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. @@ -496,7 +496,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Intercepting Filter [↑](#list-of-design-patterns) **Intent:** Provide pluggable filters to conduct necessary pre-processing and post-processing to requests from a client to a target -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/intercepting-filter/etc/intercepting-filter.png "Intercepting Filter") +![alt text](./intercepting-filter/etc/intercepting-filter.png "Intercepting Filter") **Applicability:** Use the Intercepting Filter pattern when * a system uses pre-processing or post-processing requests @@ -506,7 +506,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Execute Around [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/execute-around/etc/execute-around.png "Execute Around") +![alt text](./execute-around/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. @@ -514,7 +514,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Property [↑](#list-of-design-patterns) **Intent:** Create hierarchy of objects and new objects using already existing objects as parents. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/property/etc/property.png "Property") +![alt text](./property/etc/property.png "Property") **Applicability:** Use the Property pattern when * when you like to have objects with dynamic set of fields and prototype inheritance @@ -525,7 +525,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Poison Pill [↑](#list-of-design-patterns) **Intent:** Poison Pill is known predefined data item that allows to provide graceful shutdown for separate distributed consumption process. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/poison-pill/etc/poison-pill.png "Poison Pill") +![alt text](./poison-pill/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 @@ -536,7 +536,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ## Lazy Loading [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/lazy-loading/etc/lazy-loading.png "Lazy Loading") +![alt text](./lazy-loading/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 @@ -548,7 +548,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor **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](https://github.com/iluwatar/java-design-patterns/blob/master/service-layer/etc/service-layer.png "Service Layer") +![alt text](./service-layer/etc/service-layer.png "Service Layer") **Applicability:** Use the Service Layer pattern when * you want to encapsulate domain logic under API @@ -559,7 +559,7 @@ they store and logic they implement: data loaders, user interfaces, integration 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](https://github.com/iluwatar/java-design-patterns/blob/master/specification/etc/specification.png "Specification") +![alt text](./specification/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 @@ -568,7 +568,7 @@ validation and for building to order ## Tolerant Reader [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/tolerant-reader/etc/tolerant-reader.png "Tolerant Reader") +![alt text](./tolerant-reader/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 @@ -576,7 +576,7 @@ validation and for building to order ## Model-View-Controller [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/model-view-controller/etc/model-view-controller.png "Model-View-Controller") +![alt text](./model-view-controller/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 @@ -584,7 +584,7 @@ validation and for building to order ## Flux [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/flux/etc/flux.png "Flux") +![alt text](./flux/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. @@ -592,7 +592,7 @@ validation and for building to order ## Double Dispatch [↑](#list-of-design-patterns) **Intent:** Double Dispatch pattern is a way to create maintainable dynamic behavior based on receiver and parameter types. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/double-dispatch/etc/double-dispatch.png "Double Dispatch") +![alt text](./double-dispatch/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. @@ -603,7 +603,7 @@ validation and for building to order ## Multiton [↑](#list-of-design-patterns) **Intent:** Ensure a class only has limited number of instances, and provide a global point of access to them. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/multiton/etc/multiton.png "Multiton") +![alt text](./multiton/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 @@ -611,7 +611,7 @@ validation and for building to order ## Resource Acquisition Is Initialization [↑](#list-of-design-patterns) **Intent:** Resource Acquisition Is Initialization pattern can be used to implement exception safe resource management. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/resource-acquisition-is-initialization/etc/resource-acquisition-is-initialization.png "Resource Acquisition Is Initialization") +![alt text](./resource-acquisition-is-initialization/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 @@ -619,7 +619,7 @@ validation and for building to order ## Thread Pool [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/thread-pool/etc/thread-pool.png "Thread Pool") +![alt text](./thread-pool/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 @@ -627,7 +627,7 @@ validation and for building to order ## Async Method Invocation [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/async-method-invocation/etc/async-method-invocation.png "Async Method Invocation") +![alt text](./async-method-invocation/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 @@ -641,7 +641,7 @@ validation and for building to order ## Private Class Data [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/private-class-data/etc/private-class-data.png "Private Class Data") +![alt text](./private-class-data/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 @@ -649,7 +649,7 @@ validation and for building to order ## Object Pool [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/object-pool/etc/object-pool.png "Object Pool") +![alt text](./object-pool/etc/object-pool.png "Object Pool") **Applicability:** Use the Object Pool pattern when * The objects are expensive to create (allocation cost) @@ -658,7 +658,7 @@ validation and for building to order ## Dependency Injection [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/dependency-injection/etc/dependency-injection.png "Dependency Injection") +![alt text](./dependency-injection/etc/dependency-injection.png "Dependency Injection") **Applicability:** Use the Dependency Injection pattern when * When you need to remove knowledge of concrete implementation from object @@ -667,7 +667,7 @@ validation and for building to order ## Naked Objects [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/naked-objects/etc/naked-objects.png "Naked Objects") +![alt text](./naked-objects/etc/naked-objects.png "Naked Objects") **Applicability:** Use the Naked Objects pattern when * You are prototyping and need fast development cycle @@ -680,7 +680,7 @@ validation and for building to order ## Front Controller [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/front-controller/etc/front-controller.png "Front Controller") +![alt text](./front-controller/etc/front-controller.png "Front Controller") **Applicability:** Use the Front Controller pattern when * you want to encapsulate common request handling functionality in single place @@ -693,7 +693,7 @@ validation and for building to order ## Repository [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/repository/etc/repository.png "Repository") +![alt text](./repository/etc/repository.png "Repository") **Applicability:** Use the Repository pattern when * the number of domain objects is large @@ -707,7 +707,7 @@ validation and for building to order ## Business Delegate [↑](#list-of-design-patterns) **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](https://github.com/iluwatar/java-design-patterns/blob/master/business-delegate/etc/business-delegate.png "Business Delegate") +![alt text](./business-delegate/etc/business-delegate.png "Business Delegate") **Applicability:** Use the Business Delegate pattern when * you want loose couping between presentation and business tiers From 65d43df29ab571c4dac2b690572a8d8234c0b1e6 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Tue, 4 Aug 2015 10:59:27 +0530 Subject: [PATCH 061/687] Migrate to container based infrastructure Updated travis.yml to migrate build process from legacy infrastructure to container based infrastructure --- .travis.yml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index 8ae7361f3..85253f00e 100644 --- a/.travis.yml +++ b/.travis.yml @@ -13,4 +13,7 @@ before_install: - "sh -e /etc/init.d/xvfb start" after_success: - - mvn clean test jacoco:report coveralls:report \ No newline at end of file + - mvn clean test jacoco:report coveralls:report + +# Parameter to run on container based infrastructure +sudo: false From e2ee541fdc43f2fb8bc711be7629a7d5df6b3858 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Tue, 4 Aug 2015 11:09:35 +0530 Subject: [PATCH 062/687] Migrate to container based infrastructure --- .travis.yml | 1 - 1 file changed, 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index 85253f00e..dcd2f214c 100644 --- a/.travis.yml +++ b/.travis.yml @@ -15,5 +15,4 @@ before_install: after_success: - mvn clean test jacoco:report coveralls:report -# Parameter to run on container based infrastructure sudo: false From 185f296a5b03f16edb62d0023441e89ad4365501 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 6 Aug 2015 20:17:26 +0300 Subject: [PATCH 063/687] #189 Updated Naked Objects example with the code generated by the latest Apache Isis snapshot --- naked-objects/dom/pom.xml | 2 +- .../dom/modules/simple/SimpleObjects.java | 2 +- .../fixture/DomainAppFixturesProvider.java | 44 ++++++++ .../fixture/DomainAppFixturesService.java | 76 ------------- .../modules/simple/SimpleObjectsTearDown.java | 2 +- naked-objects/integtests/pom.xml | 41 +++++-- naked-objects/pom.xml | 101 ++++++++---------- naked-objects/webapp/pom.xml | 9 +- 8 files changed, 127 insertions(+), 150 deletions(-) create mode 100644 naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java delete mode 100644 naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index 73cfd6a73..620efa9d7 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -72,7 +72,7 @@ true - 4.0.0-release + 4.0.1 diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java index 47ab6c160..0634dd16a 100644 --- a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java +++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java @@ -70,7 +70,7 @@ public class SimpleObjects { final String name ) { return container.allMatches( - new QueryDefault( + new QueryDefault<>( SimpleObject.class, "findByName", "name", name)); diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java new file mode 100644 index 000000000..ab6b6b4be --- /dev/null +++ b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java @@ -0,0 +1,44 @@ +/* + * 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(); + } +} diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java deleted file mode 100644 index 751bad316..000000000 --- a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesService.java +++ /dev/null @@ -1,76 +0,0 @@ -/* - * 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 java.util.List; - -import org.apache.isis.applib.annotation.Action; -import org.apache.isis.applib.annotation.ActionLayout; -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.RestrictTo; -import org.apache.isis.applib.fixturescripts.FixtureResult; -import org.apache.isis.applib.fixturescripts.FixtureScript; -import org.apache.isis.applib.fixturescripts.FixtureScripts; - -import domainapp.fixture.scenarios.RecreateSimpleObjects; - -/** - * Enables fixtures to be installed from the application. - */ -@DomainService -@DomainServiceLayout( - named="Prototyping", - menuBar = DomainServiceLayout.MenuBar.SECONDARY, - menuOrder = "500" -) -public class DomainAppFixturesService extends FixtureScripts { - - public DomainAppFixturesService() { - super(DomainAppFixturesService.class.getPackage().getName(), MultipleExecutionStrategy.EXECUTE); - } - - @Override - public FixtureScript default0RunFixtureScript() { - return findFixtureScriptFor(RecreateSimpleObjects.class); - } - - @Override - public List choices0RunFixtureScript() { - return super.choices0RunFixtureScript(); - } - - - // ////////////////////////////////////// - - @Action( - restrictTo = RestrictTo.PROTOTYPING - ) - @ActionLayout( - cssClassFa="fa fa-refresh" - ) - @MemberOrder(sequence="20") - public Object recreateObjectsAndReturnFirst() { - final List run = findFixtureScriptFor(RecreateSimpleObjects.class).run(null); - return run.get(0).getObject(); - } - - -} diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java index 8767b6fb8..cc06eb4ac 100644 --- a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java +++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java @@ -26,7 +26,7 @@ public class SimpleObjectsTearDown extends FixtureScript { @Override protected void execute(ExecutionContext executionContext) { - isisJdoSupport.executeUpdate("delete from simple.\"SimpleObject\""); + isisJdoSupport.executeUpdate("delete from \"simple\".\"SimpleObject\""); } diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index 9e595f7b9..f479896cc 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -84,17 +84,38 @@ hsqldb - - + + + net.masterthought + cucumber-reporting + 0.0.21 + + + net.masterthought + maven-cucumber-reporting + 0.0.4 + + --> + + + diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index 56acd4a15..8860815af 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -240,61 +240,52 @@ **/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), - - + + 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), + + diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index fb80173f2..9873589c7 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -236,8 +236,7 @@ - + @@ -303,10 +302,8 @@ - - + + From 8a4911a4eb335463b9f290ee7b22bd4056977acf Mon Sep 17 00:00:00 2001 From: Bernardo Sulzbach Date: Thu, 6 Aug 2015 20:04:13 -0300 Subject: [PATCH 064/687] Fixed several typos in the README. --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3ccdcc088..377cad846 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,7 @@ Structural patterns are concerned with how classes and objects are composed to f ### Behavioral Patterns -Behavioral patterns are concerned with algorithms and the assignment of responsibilites between objects. +Behavioral patterns are concerned with algorithms and the assignment of responsibilities between objects. * [Chain of responsibility](#chain-of-responsibility) * [Command](#command) @@ -228,7 +228,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor **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 sublasses to support every combination. Or a class definition may be hidden or otherwise unavailable for subclassing +* 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 ## Facade [↑](#list-of-design-patterns) **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. @@ -283,7 +283,7 @@ A programming idiom is a means of expressing a recurring construct in one or mor ![alt text](./service-locator/etc/service-locator.png "Proxy") -**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 relavant 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. +**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:** @@ -686,7 +686,7 @@ validation and for building to order **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 configution portable, you only need to register the handler web server specific way +* 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/) @@ -711,7 +711,7 @@ validation and for building to order ![alt text](./business-delegate/etc/business-delegate.png "Business Delegate") **Applicability:** Use the Business Delegate pattern when -* you want loose couping between presentation and business tiers +* 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 From 9825687e62c8d32c3403d1b939bf61efb055f785 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Fri, 7 Aug 2015 12:19:16 +0530 Subject: [PATCH 065/687] #181 migration to container based infrastrucure --- .travis.yml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.travis.yml b/.travis.yml index dcd2f214c..e69a17a4f 100644 --- a/.travis.yml +++ b/.travis.yml @@ -14,5 +14,6 @@ before_install: after_success: - mvn clean test jacoco:report coveralls:report - + +# Migration to container-based infrastructure sudo: false From f52d7d3dbcd9d1b2839769d1096058fbca596007 Mon Sep 17 00:00:00 2001 From: Dmitriy Zarubin Date: Fri, 7 Aug 2015 16:17:47 +0300 Subject: [PATCH 066/687] #111 Implementation of Step Builder pattern --- README.md | 9 + pom.xml | 1 + step-builder/etc/step-builder.png | Bin 0 -> 76038 bytes step-builder/etc/step-builder.ucls | 181 ++++++++++++++++++ step-builder/pom.xml | 19 ++ .../java/com/iluwatar/stepbuilder/App.java | 69 +++++++ .../com/iluwatar/stepbuilder/Character.java | 82 ++++++++ .../stepbuilder/CharacterStepBuilder.java | 168 ++++++++++++++++ .../com/iluwatar/stepbuilder/AppTest.java | 12 ++ 9 files changed, 541 insertions(+) create mode 100644 step-builder/etc/step-builder.png create mode 100644 step-builder/etc/step-builder.ucls create mode 100644 step-builder/pom.xml create mode 100644 step-builder/src/main/java/com/iluwatar/stepbuilder/App.java create mode 100644 step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java create mode 100644 step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java create mode 100644 step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java diff --git a/README.md b/README.md index 377cad846..3ae006ff8 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,7 @@ Creational design patterns abstract the instantiation process. They help make a * [Prototype](#prototype) * [Property](#property) * [Singleton](#singleton) +* [Step Builder](#step-builder) * [Multiton](#multiton) * [Object Pool](#object-pool) @@ -181,6 +182,14 @@ A programming idiom is a means of expressing a recurring construct in one or mor **Real world examples:** * [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29) +## Step Builder [↑](#list-of-design-patterns) +**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](./step-builder/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. + ## Adapter [↑](#list-of-design-patterns) **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. diff --git a/pom.xml b/pom.xml index 13105f139..1059edc58 100644 --- a/pom.xml +++ b/pom.xml @@ -73,6 +73,7 @@ async-method-invocation business-delegate half-sync-half-async + step-builder diff --git a/step-builder/etc/step-builder.png b/step-builder/etc/step-builder.png new file mode 100644 index 0000000000000000000000000000000000000000..b7b623657c589b4cf18160ec268733a3a16f69c2 GIT binary patch literal 76038 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/step-builder/pom.xml b/step-builder/pom.xml new file mode 100644 index 000000000..8466266a7 --- /dev/null +++ b/step-builder/pom.xml @@ -0,0 +1,19 @@ + + + 4.0.0 + + java-design-patterns + com.iluwatar + 1.5.0 + + step-builder + + + junit + junit + test + + + \ No newline at end of file diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java new file mode 100644 index 000000000..439c5bd11 --- /dev/null +++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java @@ -0,0 +1,69 @@ +package com.iluwatar.stepbuilder; + +/** + * 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 + *
+ *

+ * + *

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 { + public static void main(String[] args) { + + Character warrior = CharacterStepBuilder.newBuilder() + .name("Amberjill") + .fighterClass("Paladin") + .withWeapon("Sword") + .noAbilities() + .build(); + + System.out.println(warrior); + + Character mage = CharacterStepBuilder.newBuilder() + .name("Riobard") + .wizardClass("Sorcerer") + .withSpell("Fireball") + .withAbility("Fire Aura") + .withAbility("Teleport") + .noMoreAbilities() + .build(); + + System.out.println(mage); + + Character thief = CharacterStepBuilder.newBuilder() + .name("Desmond") + .fighterClass("Rogue") + .noWeapon() + .build(); + + System.out.println(thief); + } +} diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java new file mode 100644 index 000000000..4bd29227f --- /dev/null +++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java @@ -0,0 +1,82 @@ +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 "); + sb.append(fighterClass != null ? fighterClass : wizardClass); + sb.append(" named a "); + sb.append(name); + sb.append(" armed "); + sb.append(weapon != null ? weapon : spell != null ? spell : "with nothing"); + sb.append(abilities != null ? (" and wielding " + abilities + " abilities") : ""); + sb.append("."); + return sb.toString(); + } +} diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java new file mode 100644 index 000000000..e042758d9 --- /dev/null +++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java @@ -0,0 +1,168 @@ +package com.iluwatar.stepbuilder; + +import java.util.ArrayList; +import java.util.List; + +/** + * The Step Builder class. + */ + +public 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; + } + } +} diff --git a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java new file mode 100644 index 000000000..61fe82aaf --- /dev/null +++ b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java @@ -0,0 +1,12 @@ +package com.iluwatar.stepbuilder; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From e3f2da8544b23cc95579aa50da962c6ab15917eb Mon Sep 17 00:00:00 2001 From: Bernardo Sulzbach Date: Fri, 7 Aug 2015 10:29:09 -0300 Subject: [PATCH 067/687] Wrapping some parts of the README at 80. Notes: some lines had breaks at varying positions, fixed to 80. this improves readability to me immensely some stuff should not be wrapped and other parts are just hard to wrap, so I am satisfied with this for now. [ci skip] --- README.md | 344 ++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 257 insertions(+), 87 deletions(-) diff --git a/README.md b/README.md index 377cad846..a73903367 100644 --- a/README.md +++ b/README.md @@ -9,17 +9,22 @@ ## Introduction -Design patterns are formalized best practices that the programmer can use to solve common problems when designing an application or system. +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. +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. +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. ## List of Design Patterns ### Creational Patterns -Creational design patterns abstract the instantiation process. They help make a system independent of how its objects are created, composed, and represented. +Creational design patterns abstract the instantiation process. They help make a +system independent of how its objects are created, composed, and represented. * [Abstract Factory](#abstract-factory) * [Builder](#builder) @@ -32,7 +37,8 @@ Creational design patterns abstract the instantiation process. They help make a ### Structural Patterns -Structural patterns are concerned with how classes and objects are composed to form larger structures. +Structural patterns are concerned with how classes and objects are composed to +form larger structures. * [Adapter](#adapter) * [Bridge](#bridge) @@ -47,7 +53,8 @@ Structural patterns are concerned with how classes and objects are composed to f ### Behavioral Patterns -Behavioral patterns are concerned with algorithms and the assignment of responsibilities between objects. +Behavioral patterns are concerned with algorithms and the assignment of +responsibilities between objects. * [Chain of responsibility](#chain-of-responsibility) * [Command](#command) @@ -67,7 +74,8 @@ Behavioral patterns are concerned with algorithms and the assignment of responsi ### Concurrency Patterns -Concurrency patterns are those types of design patterns that deal with the multi-threaded programming paradigm. +Concurrency patterns are those types of design patterns that deal with the +multi-threaded programming paradigm. * [Double Checked Locking](#double-checked-locking) * [Thread Pool](#thread-pool) @@ -76,7 +84,9 @@ Concurrency patterns are those types of design patterns that deal with the multi ### Presentation Tier Patterns -Presentation Tier patterns are the top-most level of the application, this is concerned with translating tasks and results to something the user can understand. +Presentation Tier patterns are the top-most level of the application, this is +concerned with translating tasks and results to something the user can +understand. * [Model-View-Controller](#model-view-controller) * [Model-View-Presenter](#model-view-presenter) @@ -89,7 +99,8 @@ Presentation Tier patterns are the top-most level of the application, this is co ### Architectural Patterns -An architectural pattern is a general, reusable solution to a commonly occurring problem in software architecture within a given context. +An architectural pattern is a general, reusable solution to a commonly occurring +problem in software architecture within a given context. * [Data Access Object](#dao) * [Service Layer](#service-layer) @@ -98,13 +109,20 @@ An architectural pattern is a general, reusable solution to a commonly occurring ### Integration Patterns -Integration patterns are concerned with how software applications communicate and exchange data. +Integration patterns are concerned with how software applications communicate +and exchange data. * [Tolerant Reader](#tolerant-reader) ### Idioms -A programming idiom is a means of expressing a recurring construct in one or more programming languages. Generally speaking, a programming idiom is an expression of a simple task, algorithm, or data structure that is not a built-in feature in the programming language being used, or, conversely, the use of an unusual or notable feature that is built into a programming language. What distinguishes idioms from patterns is generally the size, the idioms tend to be something small while the patterns are larger. +A programming idiom is a means of expressing a recurring construct in one or +more programming languages. Generally speaking, a programming idiom is an +expression of a simple task, algorithm, or data structure that is not a built-in +feature in the programming language being used, or, conversely, the use of an +unusual or notable feature that is built into a programming language. What +distinguishes idioms from patterns is generally the size, the idioms tend to be +something small while the patterns are larger. * [Execute Around](#execute-around) * [Poison Pill](#poison-pill) @@ -115,7 +133,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [Private Class Data](#private-class-data) ## Abstract Factory [↑](#list-of-design-patterns) -**Intent:** Provide an interface for creating families of related or dependent objects without specifying their concrete classes. +**Intent:** Provide an interface for creating families of related or dependent +objects without specifying their concrete classes. ![alt text](./abstract-factory/etc/abstract-factory_1.png "Abstract Factory") @@ -129,7 +148,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html) ## Builder [↑](#list-of-design-patterns) -**Intent:** Separate the construction of a complex object from its representation so that the same construction process can create different representations. +**Intent:** Separate the construction of a complex object from its +representation so that the same construction process can create different +representations. ![alt text](./builder/etc/builder_1.png "Builder") @@ -142,7 +163,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) ## Factory Method [↑](#list-of-design-patterns) -**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. +**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](./factory-method/etc/factory-method_1.png "Factory Method") @@ -152,7 +175,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * classes delegate responsibility to one of several helper subclasses, and you want to localize the knowledge of which helper subclass is the delegate ## Prototype [↑](#list-of-design-patterns) -**Intent:** Specify the kinds of objects to create using a prototypical instance, and create new objects by copying this prototype. +**Intent:** Specify the kinds of objects to create using a prototypical +instance, and create new objects by copying this prototype. ![alt text](./prototype/etc/prototype_1.png "Prototype") @@ -165,7 +189,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.lang.Object#clone()](http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone%28%29) ## Singleton [↑](#list-of-design-patterns) -**Intent:** Ensure a class only has one instance, and provide a global point of access to it. +**Intent:** Ensure a class only has one instance, and provide a global point of +access to it. ![alt text](./singleton/etc/singleton_1.png "Singleton") @@ -182,7 +207,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29) ## Adapter [↑](#list-of-design-patterns) -**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. +**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](./adapter/etc/adapter_1.png "Adapter") @@ -195,7 +222,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29) ## Bridge [↑](#list-of-design-patterns) -**Intent:** Decouple an abstraction from its implementation so that the two can vary independently. +**Intent:** Decouple an abstraction from its implementation so that the two can +vary independently. ![alt text](./bridge/etc/bridge_1.png "Bridge") @@ -208,7 +236,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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. ## Composite [↑](#list-of-design-patterns) -**Intent:** Compose objects into tree structures to represent part-whole hierarchies. Composite lets clients treat individual objects and compositions of objects uniformly. +**Intent:** Compose objects into tree structures to represent part-whole +hierarchies. Composite lets clients treat individual objects and compositions +of objects uniformly. ![alt text](./composite/etc/composite_1.png "Composite") @@ -221,7 +251,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [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) ## Decorator [↑](#list-of-design-patterns) -**Intent:** Attach additional responsibilities to an object dynamically. Decorators provide a flexible alternative to subclassing for extending functionality. +**Intent:** Attach additional responsibilities to an object dynamically. +Decorators provide a flexible alternative to subclassing for extending +functionality. ![alt text](./decorator/etc/decorator_1.png "Decorator") @@ -231,7 +263,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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 ## Facade [↑](#list-of-design-patterns) -**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. +**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](./facade/etc/facade_1.png "Facade") @@ -241,11 +274,14 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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 ## Flyweight [↑](#list-of-design-patterns) -**Intent:** Use sharing to support large numbers of fine-grained objects efficiently. +**Intent:** Use sharing to support large numbers of fine-grained objects +efficiently. ![alt text](./flyweight/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 +**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 @@ -256,11 +292,14 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.lang.Integer#valueOf(int)](http://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html#valueOf%28int%29) ## Proxy [↑](#list-of-design-patterns) -**Intent:** Provide a surrogate or placeholder for another object to control access to it. +**Intent:** Provide a surrogate or placeholder for another object to control +access to it. ![alt text](./proxy/etc/proxy_1.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 +**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 * a remote proxy provides a local representative for an object in a different address space. * a virtual proxy creates expensive objects on demand. @@ -279,11 +318,19 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [Apache Commons Proxy](https://commons.apache.org/proper/commons-proxy/) ## Service Locator [↑](#list-of-design-patterns) -**Intent:** Encapsulate the processes involved in obtaining a service with a strong abstraction layer. +**Intent:** Encapsulate the processes involved in obtaining a service with a +strong abstraction layer. ![alt text](./service-locator/etc/service-locator.png "Proxy") -**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. +**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:** @@ -292,7 +339,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * large number of services are being used ## Chain of responsibility [↑](#list-of-design-patterns) -**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. +**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](./chain/etc/chain_1.png "Chain of Responsibility") @@ -306,7 +355,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [Apache Commons Chain](https://commons.apache.org/proper/commons-chain/index.html) ## Command [↑](#list-of-design-patterns) -**Intent:** Encapsulate a request as an object, thereby letting you parameterize clients with different requests, queue or log requests, and support undoable operations. +**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](./command/etc/command.png "Command") @@ -328,16 +379,21 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.lang.Runnable](http://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html) ## Interpreter [↑](#list-of-design-patterns) -**Intent:** Given a language, define a representation for its grammar along with an interpreter that uses the representation to interpret sentences in the language. +**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](./interpreter/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 +**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 ## Iterator [↑](#list-of-design-patterns) -**Intent:** Provide a way to access the elements of an aggregate object sequentially without exposing its underlying representation. +**Intent:** Provide a way to access the elements of an aggregate object +sequentially without exposing its underlying representation. ![alt text](./iterator/etc/iterator_1.png "Iterator") @@ -350,7 +406,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html) ## Mediator [↑](#list-of-design-patterns) -**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. +**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](./mediator/etc/mediator_1.png "Mediator") @@ -360,7 +418,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * a behavior that's distributed between several classes should be customizable without a lot of subclassing ## Memento [↑](#list-of-design-patterns) -**Intent:** Without violating encapsulation, capture and externalize an object's internal state so that the object can be restored to this state later. +**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](./memento/etc/memento.png "Memento") @@ -372,7 +431,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.util.Date](http://docs.oracle.com/javase/8/docs/api/java/util/Date.html) ## Observer [↑](#list-of-design-patterns) -**Intent:** Define a one-to-many dependency between objects so that when one object changes state, all its dependents are notified and updated automatically. +**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](./observer/etc/observer_1.png "Observer") @@ -390,7 +451,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html) ## State [↑](#list-of-design-patterns) -**Intent:** Allow an object to alter its behavior when its internal state changes. The object will appear to change its class. +**Intent:** Allow an object to alter its behavior when its internal state +changes. The object will appear to change its class. ![alt text](./state/etc/state_1.png "State") @@ -399,7 +461,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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. ## Strategy [↑](#list-of-design-patterns) -**Intent:** Define a family of algorithms, encapsulate each one, and make them interchangeable. Strategy lets the algorithm vary independently from clients that use it. +**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](./strategy/etc/strategy_1.png "Strategy") @@ -410,7 +474,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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 ## Template method [↑](#list-of-design-patterns) -**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. +**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](./template-method/etc/template-method_1.png "Template Method") @@ -420,7 +486,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * to control subclasses extensions. You can define a template method that calls "hook" operations at specific points, thereby permitting extensions only at those points ## Visitor [↑](#list-of-design-patterns) -**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. +**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](./visitor/etc/visitor_1.png "Visitor") @@ -433,16 +501,19 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [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) ## Model-View-Presenter [↑](#list-of-design-patterns) -**Intent:** Apply a "Separation of Concerns" principle in a way that allows developers to build and test user interfaces. +**Intent:** Apply a "Separation of Concerns" principle in a way that allows +developers to build and test user interfaces. ![alt text](./model-view-presenter/etc/model-view-presenter_1.png "Model-View-Presenter") -**Applicability:** Use the Model-View-Presenter in any of the following situations +**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. ## Data Access Object [↑](#list-of-design-patterns) -**Intent:** Object provides an abstract interface to some type of database or other persistence mechanism. +**Intent:** Object provides an abstract interface to some type of database or +other persistence mechanism. ![alt text](./dao/etc/dao.png "Data Access Object") @@ -451,7 +522,10 @@ A programming idiom is a means of expressing a recurring construct in one or mor * when you want to avoid writing multiple data retrieval/persistence layers ## Double Checked Locking [↑](#list-of-design-patterns) -**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. +**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](./double-checked-locking/etc/double_checked_locking_1.png "Double Checked Locking") @@ -460,7 +534,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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. ## Servant [↑](#list-of-design-patterns) -**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. +**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](./servant/etc/servant-pattern.png "Servant") @@ -468,7 +544,14 @@ A programming idiom is a means of expressing a recurring construct in one or mor * When we want some objects to perform a common action and don't want to define this action as a method in every class. ## Null Object [↑](#list-of-design-patterns) -**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. +**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](./null-object/etc/null-object.png "Null Object") @@ -476,7 +559,12 @@ A programming idiom is a means of expressing a recurring construct in one or mor * You want to avoid explicit null checks and keep the algorithm elegant and easy to read. ## Event Aggregator [↑](#list-of-design-patterns) -**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. +**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](./event-aggregator/etc/classes.png "Event Aggregator") @@ -484,7 +572,9 @@ A programming idiom is a means of expressing a recurring construct in one or mor * 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. ## Callback [↑](#list-of-design-patterns) -**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. +**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](./callback/etc/callback.png "Callback") @@ -495,7 +585,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [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. ## Intercepting Filter [↑](#list-of-design-patterns) -**Intent:** Provide pluggable filters to conduct necessary pre-processing and post-processing to requests from a client to a target +**Intent:** Provide pluggable filters to conduct necessary pre-processing and +post-processing to requests from a client to a target ![alt text](./intercepting-filter/etc/intercepting-filter.png "Intercepting Filter") @@ -505,7 +596,10 @@ A programming idiom is a means of expressing a recurring construct in one or mor * you want a modular approach to configuring pre-processing and post-processing schemes ## Execute Around [↑](#list-of-design-patterns) -**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. +**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](./execute-around/etc/execute-around.png "Execute Around") @@ -513,7 +607,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * You use an API that requires methods to be called in pairs such as open/close or allocate/deallocate. ## Property [↑](#list-of-design-patterns) -**Intent:** Create hierarchy of objects and new objects using already existing objects as parents. +**Intent:** Create hierarchy of objects and new objects using already existing +objects as parents. ![alt text](./property/etc/property.png "Property") @@ -524,7 +619,8 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Inheritance_and_the_prototype_chain) prototype inheritance ## Poison Pill [↑](#list-of-design-patterns) -**Intent:** Poison Pill is known predefined data item that allows to provide graceful shutdown for separate distributed consumption process. +**Intent:** Poison Pill is known predefined data item that allows to provide +graceful shutdown for separate distributed consumption process. ![alt text](./poison-pill/etc/poison-pill.png "Poison Pill") @@ -535,7 +631,10 @@ A programming idiom is a means of expressing a recurring construct in one or mor * [akka.actor.PoisonPill](http://doc.akka.io/docs/akka/2.1.4/java/untyped-actors.html) ## Lazy Loading [↑](#list-of-design-patterns) -**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. +**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](./lazy-loading/etc/lazy-loading.png "Lazy Loading") @@ -546,8 +645,12 @@ A programming idiom is a means of expressing a recurring construct in one or mor * JPA annotations @OneToOne, @OneToMany, @ManyToOne, @ManyToMany and fetch = FetchType.LAZY ## Service Layer [↑](#list-of-design-patterns) -**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. +**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](./service-layer/etc/service-layer.png "Service Layer") @@ -556,9 +659,10 @@ they store and logic they implement: data loaders, user interfaces, integration * you need to implement multiple interfaces with common logic and data ## Specification [↑](#list-of-design-patterns) -**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 +**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](./specification/etc/specification.png "Specification") @@ -567,7 +671,10 @@ validation and for building to order * You need to check that only suitable objects are used for a certain role (validation) ## Tolerant Reader [↑](#list-of-design-patterns) -**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. +**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](./tolerant-reader/etc/tolerant-reader.png "Tolerant Reader") @@ -575,7 +682,10 @@ validation and for building to order * The communication schema can evolve and change and yet the receiving side should not break ## Model-View-Controller [↑](#list-of-design-patterns) -**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. +**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](./model-view-controller/etc/model-view-controller.png "Model-View-Controller") @@ -583,7 +693,10 @@ validation and for building to order * you want to clearly separate the domain data from its user interface representation ## Flux [↑](#list-of-design-patterns) -**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. +**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](./flux/etc/flux.png "Flux") @@ -591,7 +704,8 @@ validation and for building to order * 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. ## Double Dispatch [↑](#list-of-design-patterns) -**Intent:** Double Dispatch pattern is a way to create maintainable dynamic behavior based on receiver and parameter types. +**Intent:** Double Dispatch pattern is a way to create maintainable dynamic +behavior based on receiver and parameter types. ![alt text](./double-dispatch/etc/double-dispatch.png "Double Dispatch") @@ -602,7 +716,8 @@ validation and for building to order * [ObjectOutputStream](https://docs.oracle.com/javase/8/docs/api/java/io/ObjectOutputStream.html) ## Multiton [↑](#list-of-design-patterns) -**Intent:** Ensure a class only has limited number of instances, and provide a global point of access to them. +**Intent:** Ensure a class only has limited number of instances, and provide a +global point of access to them. ![alt text](./multiton/etc/multiton.png "Multiton") @@ -615,10 +730,14 @@ validation and for building to order ![alt text](./resource-acquisition-is-initialization/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 +* you have resources that must be closed in every condition ## Thread Pool [↑](#list-of-design-patterns) -**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. +**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](./thread-pool/etc/thread-pool.png "Thread Pool") @@ -626,7 +745,10 @@ validation and for building to order * You have a large number of short-lived tasks to be executed in parallel ## Async Method Invocation [↑](#list-of-design-patterns) -**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. +**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](./async-method-invocation/etc/async-method-invocation.png "Async Method Invocation") @@ -640,7 +762,9 @@ validation and for building to order * [Task-based Asynchronous Pattern](https://msdn.microsoft.com/en-us/library/hh873175.aspx) (.NET) ## Private Class Data [↑](#list-of-design-patterns) -**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. +**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](./private-class-data/etc/private-class-data.png "Private Class Data") @@ -648,7 +772,10 @@ validation and for building to order * You want to prevent write access to class data members ## Object Pool [↑](#list-of-design-patterns) -**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. +**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](./object-pool/etc/object-pool.png "Object Pool") @@ -657,7 +784,12 @@ validation and for building to order * You need a large number of short-lived objects (memory fragmentation) ## Dependency Injection [↑](#list-of-design-patterns) -**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. +**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](./dependency-injection/etc/dependency-injection.png "Dependency Injection") @@ -666,7 +798,9 @@ validation and for building to order * To enable unit testing of classes in isolation using mock objects or stubs ## Naked Objects [↑](#list-of-design-patterns) -**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. +**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](./naked-objects/etc/naked-objects.png "Naked Objects") @@ -679,7 +813,9 @@ validation and for building to order * [Apache Isis](https://isis.apache.org/) ## Front Controller [↑](#list-of-design-patterns) -**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. +**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](./front-controller/etc/front-controller.png "Front Controller") @@ -692,7 +828,11 @@ validation and for building to order * [Apache Struts](https://struts.apache.org/) ## Repository [↑](#list-of-design-patterns) -**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. +**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](./repository/etc/repository.png "Repository") @@ -706,7 +846,10 @@ validation and for building to order * [Spring Data](http://projects.spring.io/spring-data/) ## Business Delegate [↑](#list-of-design-patterns) -**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. +**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](./business-delegate/etc/business-delegate.png "Business Delegate") @@ -716,7 +859,9 @@ validation and for building to order * you want to encapsulate service lookups and service calls ## Half-Sync/Half-Async [↑](#list-of-design-patterns) -**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. +**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](./half-sync-half-async/etc/half-sync-half-async.png) @@ -736,35 +881,59 @@ validation and for building to order **Q: What is the difference between State and Strategy patterns?** -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. +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. **Q: What is the difference between Strategy and Template Method patterns?** -In Template Method the algorithm is chosen at compile time via inheritance. With Strategy pattern the algorithm is chosen at runtime via composition. +In Template Method the algorithm is chosen at compile time via inheritance. +With Strategy pattern the algorithm is chosen at runtime via composition. **Q: What is the difference between Proxy and Decorator patterns?** -The difference is the intent of the patterns. While Proxy controls access to the object Decorator is used to add responsibilities to the object. +The difference is the intent of the patterns. While Proxy controls access to +the object Decorator is used to add responsibilities to the object. **Q: What is the difference between Chain of Responsibility and Intercepting Filter patterns?** -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. +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. **Q: What is the difference between Visitor and Double Dispatch patterns?** -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. +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. **Q: What are the differences between Flyweight and Object Pool patterns?** 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. +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. +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 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. +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. @@ -796,14 +965,16 @@ As for performance and scalability, pools can become bottlenecks, if all the poo * [pattern language for microservices](http://microservices.io/patterns/index.html) * Microsoft's [Cloud Design Patterns](http://download.microsoft.com/download/B/B/6/BB69622C-AB5D-4D5F-9A12-B81B952C1169/CloudDesignPatternsBook-PDF.pdf) -**Links to patterns applied in real world applications** are welcome. The links should be added to the corresponding section of the `README.md`. - +**Links to patterns applied in real world applications** are welcome. The links +should be added to the corresponding section of the `README.md`. # Versioning -Java-design-patterns project uses [semantic versioning](http://semver.org/) scheme. However, version numbers in this project do not signify binary releases (since we don't make any) but rather milestones achieved on the roadmap. In other words, version numbers are used only for project planning sake. - +Java-design-patterns project uses [semantic versioning](http://semver.org/) +scheme. However, version numbers in this project do not signify binary releases +(since we don't make any) but rather milestones achieved on the roadmap. In +other words, version numbers are used only for project planning sake. # Credits @@ -828,7 +999,6 @@ Java-design-patterns project uses [semantic versioning](http://semver.org/) sche * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) - # License This project is licensed under the terms of the MIT license. From 2238369fc0d61cf45b23a1db3c4ed82163d54219 Mon Sep 17 00:00:00 2001 From: Bernardo Sulzbach Date: Sat, 8 Aug 2015 10:27:50 -0300 Subject: [PATCH 068/687] Better capitalization in the readme. Also reworded some sentences and wrapped one or two huge lines I would need to change anyway. Closes #192 --- README.md | 77 +++++++++++++++++++++++++++++++------------------------ 1 file changed, 44 insertions(+), 33 deletions(-) diff --git a/README.md b/README.md index a73903367..910e9d485 100644 --- a/README.md +++ b/README.md @@ -307,8 +307,8 @@ are several common situations in which the Proxy pattern is applicable **Typical Use Case:** -* Control access to another object -* Lazy initialization +* control access to another object +* lazy initialization * implement logging * facilitate network connection * to count references to an object @@ -334,7 +334,7 @@ improves the performance of application to great extent. **Typical Use Case:** -* When network hits are expensive and time consuming +* when network hits are expensive and time consuming * lookups of services are done quite frequently * large number of services are being used @@ -541,7 +541,7 @@ this behavior in the common parent class - it is defined once in the Servant. ![alt text](./servant/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. +* when we want some objects to perform a common action and don't want to define this action as a method in every class. ## Null Object [↑](#list-of-design-patterns) **Intent:** In most object-oriented languages, such as Java or C#, references @@ -556,7 +556,7 @@ Object is very predictable and has no side effects: it does nothing. ![alt text](./null-object/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. +* you want to avoid explicit null checks and keep the algorithm elegant and easy to read. ## Event Aggregator [↑](#list-of-design-patterns) **Intent:** A system with lots of objects can lead to complexities when a @@ -569,7 +569,11 @@ allowing clients to register with just the aggregator. ![alt text](./event-aggregator/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. +* 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. ## Callback [↑](#list-of-design-patterns) **Intent:** Callback is a piece of executable code that is passed as an @@ -579,7 +583,7 @@ at some convenient time. ![alt text](./callback/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. +* 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. @@ -604,7 +608,7 @@ only what to do with the resource. ![alt text](./execute-around/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. +* you use an API that requires methods to be called in pairs such as open/close or allocate/deallocate. ## Property [↑](#list-of-design-patterns) **Intent:** Create hierarchy of objects and new objects using already existing @@ -667,8 +671,8 @@ order ![alt text](./specification/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) +* 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) ## Tolerant Reader [↑](#list-of-design-patterns) **Intent:** Tolerant Reader is an integration pattern that helps creating @@ -679,7 +683,7 @@ changes, the readers must not break. ![alt text](./tolerant-reader/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 +* the communication schema can evolve and change and yet the receiving side should not break ## Model-View-Controller [↑](#list-of-design-patterns) **Intent:** Separate the user interface into three interconnected components: @@ -701,7 +705,7 @@ logic, which updates all of the views that are affected. ![alt text](./flux/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. +* 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. ## Double Dispatch [↑](#list-of-design-patterns) **Intent:** Double Dispatch pattern is a way to create maintainable dynamic @@ -710,7 +714,7 @@ behavior based on receiver and parameter types. ![alt text](./double-dispatch/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. +* 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) @@ -742,7 +746,7 @@ and eliminating the latency of creating new threads. ![alt text](./thread-pool/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 +* you have a large number of short-lived tasks to be executed in parallel ## Async Method Invocation [↑](#list-of-design-patterns) **Intent:** Asynchronous method invocation is pattern where the calling thread @@ -753,9 +757,10 @@ callbacks or waiting until everything is done. ![alt text](./async-method-invocation/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 performance of running a group of sequential tasks -* You have limited number of processing capacity or long running tasks and the caller cannot wait the tasks to be ready +* 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) @@ -769,7 +774,7 @@ attributes by encapsulating them in single Data object. ![alt text](./private-class-data/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 +* you want to prevent write access to class data members ## Object Pool [↑](#list-of-design-patterns) **Intent:** When objects are expensive to create and they are needed only for @@ -780,8 +785,8 @@ are in use and which are available. ![alt text](./object-pool/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) +* the objects are expensive to create (allocation cost) +* you need a large number of short-lived objects (memory fragmentation) ## Dependency Injection [↑](#list-of-design-patterns) **Intent:** Dependency Injection is a software design pattern in which one or @@ -794,8 +799,8 @@ inversion of control and single responsibility principles. ![alt text](./dependency-injection/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 +* when you need to remove knowledge of concrete implementation from object +* to enable unit testing of classes in isolation using mock objects or stubs ## Naked Objects [↑](#list-of-design-patterns) **Intent:** The Naked Objects architectural pattern is well suited for rapid @@ -805,9 +810,9 @@ everything else is autogenerated by the framework. ![alt text](./naked-objects/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 +* 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/) @@ -866,11 +871,11 @@ degrading execution efficiency. ![Half-Sync/Half-Async class diagram](./half-sync-half-async/etc/half-sync-half-async.png) **Applicability:** Use Half-Sync/Half-Async pattern when -* A system possesses following characteristics: - * 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. +* 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) @@ -941,9 +946,13 @@ Flyweight. **To work on a new pattern** you need to do the following steps: -1. If there is no issue for the new pattern yet, raise new issue. Comment on the issue that you are working on it so that others don't start work on the same thing. +1. If there is no issue for the new pattern yet, raise new issue. Comment on + the issue that you are working on it so that others don't start work on the + same thing. 2. Fork the repository. -3. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. +3. Implement the code changes in your fork. Remember to add sufficient comments + documenting the implementation. Reference the issue id e.g. #52 in your + commit messages. 4. Create a simple class diagram from your example code. 5. Add description of the pattern in README.md and link to the class diagram. 6. Create a pull request. @@ -953,7 +962,9 @@ Flyweight. 1. Check that the issue has "help wanted" badge 2. Comment on the issue that you are working on it 3. Fork the repository. -4. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. +4. Implement the code changes in your fork. Remember to add sufficient comments + documenting the implementation. Reference the issue id e.g. #52 in your + commit messages. 5. Create a pull request. **For creating/editing UML diagrams** you need [ObjectAid UML Explorer for Eclipse](http://www.objectaid.com/home). From 1bcd822c58bbca40507011d818b3b8d8f227f9e0 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 14:00:27 +0300 Subject: [PATCH 069/687] #84 Skeleton for Layers architectural pattern --- layers/pom.xml | 20 +++++++++++++++++++ .../main/java/com/iluwatar/layers/App.java | 8 ++++++++ .../java/com/iluwatar/layers/AppTest.java | 12 +++++++++++ pom.xml | 1 + 4 files changed, 41 insertions(+) create mode 100644 layers/pom.xml create mode 100644 layers/src/main/java/com/iluwatar/layers/App.java create mode 100644 layers/src/test/java/com/iluwatar/layers/AppTest.java diff --git a/layers/pom.xml b/layers/pom.xml new file mode 100644 index 000000000..4f70ab1c9 --- /dev/null +++ b/layers/pom.xml @@ -0,0 +1,20 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.5.0 + + com.iluwatar.layers + layers + + + junit + junit + test + + + diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java new file mode 100644 index 000000000..c6c03d1dd --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -0,0 +1,8 @@ +package com.iluwatar.layers; + +public class App { + + public static void main(String[] args) { + System.out.println("Hello World!"); + } +} diff --git a/layers/src/test/java/com/iluwatar/layers/AppTest.java b/layers/src/test/java/com/iluwatar/layers/AppTest.java new file mode 100644 index 000000000..22c35267a --- /dev/null +++ b/layers/src/test/java/com/iluwatar/layers/AppTest.java @@ -0,0 +1,12 @@ +package com.iluwatar.layers; + +import org.junit.Test; + +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/pom.xml b/pom.xml index 13105f139..75bb842e9 100644 --- a/pom.xml +++ b/pom.xml @@ -73,6 +73,7 @@ async-method-invocation business-delegate half-sync-half-async + layers From d1bc28bb22e2e650ce56c4cd93fb6c001c570ee6 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 14:22:23 +0300 Subject: [PATCH 070/687] #84 Utilize Repository layer from another example --- layers/pom.xml | 16 +++++ .../main/java/com/iluwatar/layers/App.java | 42 +++++++++++++- .../main/java/com/iluwatar/layers/Person.java | 58 +++++++++++++++++++ .../java/com/iluwatar/layers/PersonDao.java | 17 ++++++ .../main/resources/META-INF/persistence.xml | 8 +++ .../src/main/resources/applicationContext.xml | 39 +++++++++++++ 6 files changed, 179 insertions(+), 1 deletion(-) create mode 100644 layers/src/main/java/com/iluwatar/layers/Person.java create mode 100644 layers/src/main/java/com/iluwatar/layers/PersonDao.java create mode 100644 layers/src/main/resources/META-INF/persistence.xml create mode 100644 layers/src/main/resources/applicationContext.xml diff --git a/layers/pom.xml b/layers/pom.xml index 4f70ab1c9..2027f6ae3 100644 --- a/layers/pom.xml +++ b/layers/pom.xml @@ -11,6 +11,22 @@ com.iluwatar.layers layers + + org.springframework.data + spring-data-jpa + + + org.hibernate + hibernate-entitymanager + + + commons-dbcp + commons-dbcp + + + com.h2database + h2 + junit junit diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index c6c03d1dd..b02dd561a 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -1,8 +1,48 @@ package com.iluwatar.layers; +import java.util.List; + +import org.springframework.context.support.ClassPathXmlApplicationContext; + public class App { public static void main(String[] args) { - System.out.println("Hello World!"); + ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( + "applicationContext.xml"); + PersonDao dao = context.getBean(PersonDao.class); + + Person peter = new Person("Peter", "Sagan"); + Person nasta = new Person("Nasta", "Kuzminova"); + + // Add new Person records + dao.save(peter); + dao.save(nasta); + + // Count Person records + System.out.println("Count Person records: " + dao.count()); + + // Print all records + List persons = (List) dao.findAll(); + for (Person person : persons) { + System.out.println(person); + } + + // Find Person by surname + System.out.println("Find by surname 'Sagan': " + dao.findBySurname("Sagan")); + + // Update Person + nasta.setName("Barbora"); + nasta.setSurname("Spotakova"); + dao.save(nasta); + + System.out.println("Find by id 2: " + dao.findOne(2L)); + + // Remove record from Person + dao.delete(2L); + + // And finally count records + System.out.println("Count Person records: " + dao.count()); + + context.close(); } } diff --git a/layers/src/main/java/com/iluwatar/layers/Person.java b/layers/src/main/java/com/iluwatar/layers/Person.java new file mode 100644 index 000000000..050fc1a28 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/Person.java @@ -0,0 +1,58 @@ +package com.iluwatar.layers; + +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; + + public Person() { + } + + public Person(String name, String surname) { + this.name = name; + this.surname = surname; + } + + 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; + } + + @Override + public String toString() { + return "Person [id=" + id + ", name=" + name + ", surname=" + surname + + "]"; + } +} diff --git a/layers/src/main/java/com/iluwatar/layers/PersonDao.java b/layers/src/main/java/com/iluwatar/layers/PersonDao.java new file mode 100644 index 000000000..34977a9d2 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/PersonDao.java @@ -0,0 +1,17 @@ +package com.iluwatar.layers; + +import java.util.List; + +import org.springframework.data.repository.CrudRepository; +import org.springframework.stereotype.Repository; + +/** + * + * Person repository + * + */ +@Repository +public interface PersonDao extends CrudRepository { + + public List findBySurname(String surname); +} diff --git a/layers/src/main/resources/META-INF/persistence.xml b/layers/src/main/resources/META-INF/persistence.xml new file mode 100644 index 000000000..0aded0dbd --- /dev/null +++ b/layers/src/main/resources/META-INF/persistence.xml @@ -0,0 +1,8 @@ + + + + + + diff --git a/layers/src/main/resources/applicationContext.xml b/layers/src/main/resources/applicationContext.xml new file mode 100644 index 000000000..3fe15b2f6 --- /dev/null +++ b/layers/src/main/resources/applicationContext.xml @@ -0,0 +1,39 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From a44f32a1e00ecceb5f5f4e961c2050c4e65d05fb Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 15:00:32 +0300 Subject: [PATCH 071/687] #84 Work on data layer --- .../main/java/com/iluwatar/layers/Cake.java | 28 +++++++++++++++++++ .../java/com/iluwatar/layers/CakeLayer.java | 25 +++++++++++++++++ .../java/com/iluwatar/layers/CakeTopping.java | 25 +++++++++++++++++ 3 files changed, 78 insertions(+) create mode 100644 layers/src/main/java/com/iluwatar/layers/Cake.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeLayer.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeTopping.java diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java new file mode 100644 index 000000000..e876a6e46 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/Cake.java @@ -0,0 +1,28 @@ +package com.iluwatar.layers; + +import java.util.ArrayList; +import java.util.List; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; +import javax.persistence.OneToMany; +import javax.persistence.OneToOne; + +@Entity +public class Cake { + + @Id + @GeneratedValue + private Long id; + + @OneToMany + private List layers; + + @OneToOne + private CakeTopping topping; + + public Cake() { + layers = new ArrayList<>(); + } +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java new file mode 100644 index 000000000..0e6309540 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java @@ -0,0 +1,25 @@ +package com.iluwatar.layers; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; + +@Entity +public class CakeLayer { + + @Id + @GeneratedValue + private Long id; + + private String name; + + private int calories; + + public CakeLayer() { + } + + public CakeLayer(String name, int calories) { + this.name = name; + this.calories = calories; + } +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java new file mode 100644 index 000000000..9fc6c86bd --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java @@ -0,0 +1,25 @@ +package com.iluwatar.layers; + +import javax.persistence.Entity; +import javax.persistence.GeneratedValue; +import javax.persistence.Id; + +@Entity +public class CakeTopping { + + @Id + @GeneratedValue + private Long id; + + private String name; + + private int calories; + + public CakeTopping() { + } + + public CakeTopping(String name, int calories) { + this.name = name; + this.calories = calories; + } +} From 6ed145c6ab6e45c16b3bec91a8982085a345fd52 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 19:01:25 +0300 Subject: [PATCH 072/687] #84 Added Repositories --- .../main/java/com/iluwatar/layers/App.java | 73 ++++++++++--------- .../java/com/iluwatar/layers/CakeDao.java | 9 +++ .../com/iluwatar/layers/CakeLayerDao.java | 9 +++ .../com/iluwatar/layers/CakeToppingDao.java | 9 +++ .../main/java/com/iluwatar/layers/Person.java | 58 --------------- .../java/com/iluwatar/layers/PersonDao.java | 17 ----- 6 files changed, 65 insertions(+), 110 deletions(-) create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeDao.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/Person.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/PersonDao.java diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index b02dd561a..6f939e4c3 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -1,7 +1,5 @@ package com.iluwatar.layers; -import java.util.List; - import org.springframework.context.support.ClassPathXmlApplicationContext; public class App { @@ -9,39 +7,44 @@ public class App { public static void main(String[] args) { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( "applicationContext.xml"); - PersonDao dao = context.getBean(PersonDao.class); - - Person peter = new Person("Peter", "Sagan"); - Person nasta = new Person("Nasta", "Kuzminova"); - - // Add new Person records - dao.save(peter); - dao.save(nasta); - - // Count Person records - System.out.println("Count Person records: " + dao.count()); - - // Print all records - List persons = (List) dao.findAll(); - for (Person person : persons) { - System.out.println(person); - } - - // Find Person by surname - System.out.println("Find by surname 'Sagan': " + dao.findBySurname("Sagan")); - - // Update Person - nasta.setName("Barbora"); - nasta.setSurname("Spotakova"); - dao.save(nasta); - - System.out.println("Find by id 2: " + dao.findOne(2L)); - - // Remove record from Person - dao.delete(2L); - - // And finally count records - System.out.println("Count Person records: " + dao.count()); + + CakeLayerDao cakeLayerDao = context.getBean(CakeLayerDao.class); + cakeLayerDao.save(new CakeLayer("strawberry", 1200)); + System.out.println("Count CakeLayer records: " + cakeLayerDao.count()); + +// PersonDao dao = context.getBean(PersonDao.class); +// +// Person peter = new Person("Peter", "Sagan"); +// Person nasta = new Person("Nasta", "Kuzminova"); +// +// // Add new Person records +// dao.save(peter); +// dao.save(nasta); +// +// // Count Person records +// System.out.println("Count Person records: " + dao.count()); +// +// // Print all records +// List persons = (List) dao.findAll(); +// for (Person person : persons) { +// System.out.println(person); +// } +// +// // Find Person by surname +// System.out.println("Find by surname 'Sagan': " + dao.findBySurname("Sagan")); +// +// // Update Person +// nasta.setName("Barbora"); +// nasta.setSurname("Spotakova"); +// dao.save(nasta); +// +// System.out.println("Find by id 2: " + dao.findOne(2L)); +// +// // Remove record from Person +// dao.delete(2L); +// +// // And finally count records +// System.out.println("Count Person records: " + dao.count()); context.close(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeDao.java b/layers/src/main/java/com/iluwatar/layers/CakeDao.java new file mode 100644 index 000000000..eb9e2fdaa --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeDao.java @@ -0,0 +1,9 @@ +package com.iluwatar.layers; + +import org.springframework.data.repository.CrudRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface CakeDao extends CrudRepository { + +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java new file mode 100644 index 000000000..c46aafaeb --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java @@ -0,0 +1,9 @@ +package com.iluwatar.layers; + +import org.springframework.data.repository.CrudRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface CakeLayerDao extends CrudRepository { + +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java new file mode 100644 index 000000000..81f371750 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java @@ -0,0 +1,9 @@ +package com.iluwatar.layers; + +import org.springframework.data.repository.CrudRepository; +import org.springframework.stereotype.Repository; + +@Repository +public interface CakeToppingDao extends CrudRepository { + +} diff --git a/layers/src/main/java/com/iluwatar/layers/Person.java b/layers/src/main/java/com/iluwatar/layers/Person.java deleted file mode 100644 index 050fc1a28..000000000 --- a/layers/src/main/java/com/iluwatar/layers/Person.java +++ /dev/null @@ -1,58 +0,0 @@ -package com.iluwatar.layers; - -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; - - public Person() { - } - - public Person(String name, String surname) { - this.name = name; - this.surname = surname; - } - - 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; - } - - @Override - public String toString() { - return "Person [id=" + id + ", name=" + name + ", surname=" + surname - + "]"; - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/PersonDao.java b/layers/src/main/java/com/iluwatar/layers/PersonDao.java deleted file mode 100644 index 34977a9d2..000000000 --- a/layers/src/main/java/com/iluwatar/layers/PersonDao.java +++ /dev/null @@ -1,17 +0,0 @@ -package com.iluwatar.layers; - -import java.util.List; - -import org.springframework.data.repository.CrudRepository; -import org.springframework.stereotype.Repository; - -/** - * - * Person repository - * - */ -@Repository -public interface PersonDao extends CrudRepository { - - public List findBySurname(String surname); -} From 8c48d9a9720cbdfc45784f87b669749af3cc062b Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 19:34:34 +0300 Subject: [PATCH 073/687] #84 Work on Service Layer --- .../main/java/com/iluwatar/layers/App.java | 34 ------------------- .../iluwatar/layers/CakeBakingService.java | 10 ++++++ .../layers/CakeBakingServiceImpl.java | 20 +++++++++++ .../java/com/iluwatar/layers/CakeInfo.java | 5 +++ .../com/iluwatar/layers/CakeLayerInfo.java | 5 +++ .../com/iluwatar/layers/CakeToppingInfo.java | 5 +++ 6 files changed, 45 insertions(+), 34 deletions(-) create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeBakingService.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeInfo.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 6f939e4c3..dc1595b3d 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -11,40 +11,6 @@ public class App { CakeLayerDao cakeLayerDao = context.getBean(CakeLayerDao.class); cakeLayerDao.save(new CakeLayer("strawberry", 1200)); System.out.println("Count CakeLayer records: " + cakeLayerDao.count()); - -// PersonDao dao = context.getBean(PersonDao.class); -// -// Person peter = new Person("Peter", "Sagan"); -// Person nasta = new Person("Nasta", "Kuzminova"); -// -// // Add new Person records -// dao.save(peter); -// dao.save(nasta); -// -// // Count Person records -// System.out.println("Count Person records: " + dao.count()); -// -// // Print all records -// List persons = (List) dao.findAll(); -// for (Person person : persons) { -// System.out.println(person); -// } -// -// // Find Person by surname -// System.out.println("Find by surname 'Sagan': " + dao.findBySurname("Sagan")); -// -// // Update Person -// nasta.setName("Barbora"); -// nasta.setSurname("Spotakova"); -// dao.save(nasta); -// -// System.out.println("Find by id 2: " + dao.findOne(2L)); -// -// // Remove record from Person -// dao.delete(2L); -// -// // And finally count records -// System.out.println("Count Person records: " + dao.count()); context.close(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java new file mode 100644 index 000000000..08902bf11 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java @@ -0,0 +1,10 @@ +package com.iluwatar.layers; + +public interface CakeBakingService { + + void bakeNewCake(String topping, String layer1, String layer2, String layer3); + + void addNewTopping(CakeTopping topping); + + void addNewLayer(CakeLayer layer); +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java new file mode 100644 index 000000000..f2d457437 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -0,0 +1,20 @@ +package com.iluwatar.layers; + +public class CakeBakingServiceImpl implements CakeBakingService { + + @Override + public void bakeNewCake(String topping, String layer1, String layer2, String layer3) { + } + + @Override + public void addNewTopping(CakeTopping topping) { + // TODO Auto-generated method stub + + } + + @Override + public void addNewLayer(CakeLayer layer) { + // TODO Auto-generated method stub + + } +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java new file mode 100644 index 000000000..797bb24a1 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java @@ -0,0 +1,5 @@ +package com.iluwatar.layers; + +public class CakeInfo { + +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java new file mode 100644 index 000000000..fa74cd5f4 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java @@ -0,0 +1,5 @@ +package com.iluwatar.layers; + +public class CakeLayerInfo { + +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java new file mode 100644 index 000000000..32aa690cf --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java @@ -0,0 +1,5 @@ +package com.iluwatar.layers; + +public class CakeToppingInfo { + +} From 981c5b31e1254ef810dcfa8ccabc18bad4ac15e3 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 21:35:51 +0300 Subject: [PATCH 074/687] #84 Added DTOs --- .../java/com/iluwatar/layers/CakeBakingService.java | 6 +++--- .../com/iluwatar/layers/CakeBakingServiceImpl.java | 10 +++------- layers/src/main/java/com/iluwatar/layers/CakeInfo.java | 9 +++++++++ .../main/java/com/iluwatar/layers/CakeLayerInfo.java | 7 +++++++ .../main/java/com/iluwatar/layers/CakeToppingInfo.java | 7 +++++++ 5 files changed, 29 insertions(+), 10 deletions(-) diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java index 08902bf11..4315e3519 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java @@ -2,9 +2,9 @@ package com.iluwatar.layers; public interface CakeBakingService { - void bakeNewCake(String topping, String layer1, String layer2, String layer3); + void bakeNewCake(CakeInfo cakeInfo); - void addNewTopping(CakeTopping topping); + void saveNewTopping(CakeToppingInfo toppingInfo); - void addNewLayer(CakeLayer layer); + void saveNewLayer(CakeLayerInfo layerInfo); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java index f2d457437..fa141b5dc 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -3,18 +3,14 @@ package com.iluwatar.layers; public class CakeBakingServiceImpl implements CakeBakingService { @Override - public void bakeNewCake(String topping, String layer1, String layer2, String layer3) { + public void bakeNewCake(CakeInfo cakeInfo) { } @Override - public void addNewTopping(CakeTopping topping) { - // TODO Auto-generated method stub - + public void saveNewTopping(CakeToppingInfo toppingInfo) { } @Override - public void addNewLayer(CakeLayer layer) { - // TODO Auto-generated method stub - + public void saveNewLayer(CakeLayerInfo layerInfo) { } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java index 797bb24a1..185192f50 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java @@ -1,5 +1,14 @@ package com.iluwatar.layers; +import java.util.List; + public class CakeInfo { + public final CakeToppingInfo cakeToppingInfo; + public final List cakeLayerInfos; + + public CakeInfo(CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { + this.cakeToppingInfo = cakeToppingInfo; + this.cakeLayerInfos = cakeLayerInfos; + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java index fa74cd5f4..f2e349fe6 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java @@ -2,4 +2,11 @@ package com.iluwatar.layers; public class CakeLayerInfo { + public final String name; + public final int calories; + + public CakeLayerInfo(String name, int calories) { + this.name = name; + this.calories = calories; + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java index 32aa690cf..04ba15d98 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java @@ -1,5 +1,12 @@ package com.iluwatar.layers; public class CakeToppingInfo { + + public final String name; + public final int calories; + public CakeToppingInfo(String name, int calories) { + this.name = name; + this.calories = calories; + } } From 2ca8ab09e0dd9f12897fe2929e3a56d7f9f1bd1a Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 9 Aug 2015 23:38:02 +0300 Subject: [PATCH 075/687] #84 Started work on cake baking --- .../main/java/com/iluwatar/layers/App.java | 17 +++-- .../main/java/com/iluwatar/layers/Cake.java | 32 +++++++-- .../iluwatar/layers/CakeBakingException.java | 11 ++++ .../iluwatar/layers/CakeBakingService.java | 8 ++- .../layers/CakeBakingServiceImpl.java | 65 ++++++++++++++++++- .../java/com/iluwatar/layers/CakeInfo.java | 9 +++ .../java/com/iluwatar/layers/CakeLayer.java | 29 +++++++++ .../com/iluwatar/layers/CakeLayerInfo.java | 17 ++++- .../java/com/iluwatar/layers/CakeTopping.java | 29 +++++++++ .../com/iluwatar/layers/CakeToppingInfo.java | 19 +++++- 10 files changed, 218 insertions(+), 18 deletions(-) create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeBakingException.java diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index dc1595b3d..67aeb45ac 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -1,17 +1,16 @@ package com.iluwatar.layers; -import org.springframework.context.support.ClassPathXmlApplicationContext; - public class App { public static void main(String[] args) { - ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( - "applicationContext.xml"); - - CakeLayerDao cakeLayerDao = context.getBean(CakeLayerDao.class); - cakeLayerDao.save(new CakeLayer("strawberry", 1200)); - System.out.println("Count CakeLayer records: " + cakeLayerDao.count()); - context.close(); + CakeBakingService service = new CakeBakingServiceImpl(); + service.saveNewLayer(new CakeLayerInfo("foo", 1)); + service.saveNewLayer(new CakeLayerInfo("bar", 2)); + service.getAllLayers().stream().forEach((layer) -> System.out.println(layer)); + + service.saveNewTopping(new CakeToppingInfo("hoi", 11)); + service.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java index e876a6e46..8d78d203f 100644 --- a/layers/src/main/java/com/iluwatar/layers/Cake.java +++ b/layers/src/main/java/com/iluwatar/layers/Cake.java @@ -15,14 +15,38 @@ public class Cake { @Id @GeneratedValue private Long id; - - @OneToMany - private List layers; @OneToOne private CakeTopping topping; + @OneToMany + private List layers; + public Cake() { - layers = new ArrayList<>(); + setLayers(new ArrayList<>()); + } + + 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 List getLayers() { + return layers; + } + + public void setLayers(List layers) { + this.layers = layers; } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java new file mode 100644 index 000000000..2b131da19 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java @@ -0,0 +1,11 @@ +package com.iluwatar.layers; + +public class CakeBakingException extends Exception { + + public CakeBakingException() { + } + + public CakeBakingException(String message) { + super(message); + } +} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java index 4315e3519..731650d7e 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java @@ -1,10 +1,16 @@ package com.iluwatar.layers; +import java.util.List; + public interface CakeBakingService { - void bakeNewCake(CakeInfo cakeInfo); + void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException; void saveNewTopping(CakeToppingInfo toppingInfo); + + List getAllToppings(); void saveNewLayer(CakeLayerInfo layerInfo); + + List getAllLayers(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java index fa141b5dc..6bf41c290 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -1,16 +1,79 @@ package com.iluwatar.layers; +import java.util.ArrayList; +import java.util.Iterator; +import java.util.List; +import java.util.Optional; +import java.util.stream.Collectors; + +import org.springframework.context.support.AbstractApplicationContext; +import org.springframework.context.support.ClassPathXmlApplicationContext; + public class CakeBakingServiceImpl implements CakeBakingService { + private AbstractApplicationContext context; + + public CakeBakingServiceImpl() { + this.context = new ClassPathXmlApplicationContext("applicationContext.xml"); + } + @Override - public void bakeNewCake(CakeInfo cakeInfo) { + public void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException { + List allToppings = getAllToppings(); + List matchingToppings = allToppings.stream() + .filter((t) -> t.name.equals(cakeInfo.cakeToppingInfo.name)).collect(Collectors.toList()); + if (!matchingToppings.isEmpty()) { +// CakeToppingDao toppingBean = context.getBean(CakeToppingDao.class); +// toppingBean.delete(matchingToppings.iterator().next().id.get()); + } else { + throw new CakeBakingException(String.format("Topping %s is not available", cakeInfo.cakeToppingInfo.name)); + } + List allLayers = getAllLayers(); + for (CakeLayerInfo info: cakeInfo.cakeLayerInfos) { + Optional found = allLayers.stream().filter((layer) -> layer.name.equals(info.name)).findFirst(); + if (found.isPresent()) { +// CakeLayerDao layerBean = context.getBean(CakeLayerDao.class); +// layerBean.delete(found.get().id.get()); + } else { + throw new CakeBakingException(String.format("Layer %s is not available", info.name)); + } + } + CakeDao cakeBean = context.getBean(CakeDao.class); } @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)); + } + + @Override + public List getAllToppings() { + CakeToppingDao bean = context.getBean(CakeToppingDao.class); + List result = new ArrayList<>(); + Iterator iterator = bean.findAll().iterator(); + while (iterator.hasNext()) { + CakeTopping next = iterator.next(); + result.add(new CakeToppingInfo(next.getId(), next.getName(), next.getCalories())); + } + return result; + } + + @Override + public List getAllLayers() { + CakeLayerDao bean = context.getBean(CakeLayerDao.class); + List result = new ArrayList<>(); + Iterator iterator = bean.findAll().iterator(); + while (iterator.hasNext()) { + CakeLayer next = iterator.next(); + result.add(new CakeLayerInfo(next.getId(), next.getName(), next.getCalories())); + } + return result; } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java index 185192f50..f5be954a7 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java @@ -1,13 +1,22 @@ package com.iluwatar.layers; import java.util.List; +import java.util.Optional; public class CakeInfo { + public final Optional id; public final CakeToppingInfo cakeToppingInfo; public final List cakeLayerInfos; + + public CakeInfo(Long id, CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { + this.id = Optional.of(id); + this.cakeToppingInfo = cakeToppingInfo; + this.cakeLayerInfos = cakeLayerInfos; + } public CakeInfo(CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { + this.id = Optional.empty(); this.cakeToppingInfo = cakeToppingInfo; this.cakeLayerInfos = cakeLayerInfos; } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java index 0e6309540..c547995b3 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java @@ -19,7 +19,36 @@ public class 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 void setName(String name) { this.name = name; + } + + public int getCalories() { + return calories; + } + + public void setCalories(int calories) { this.calories = calories; } + + @Override + public String toString() { + return String.format("name: %s calories: %d", name, calories); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java index f2e349fe6..6b2b5b9b4 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java @@ -1,12 +1,27 @@ package com.iluwatar.layers; +import java.util.Optional; + public class CakeLayerInfo { + public final Optional id; public final String name; public final int calories; - public CakeLayerInfo(String name, int calories) { + public CakeLayerInfo(Long id, String name, int calories) { + this.id = Optional.of(id); this.name = name; this.calories = calories; } + + public CakeLayerInfo(String name, int calories) { + this.id = Optional.empty(); + this.name = name; + this.calories = calories; + } + + @Override + public String toString() { + return String.format("name: %s calories: %d", name, calories); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java index 9fc6c86bd..38f61efca 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java @@ -19,7 +19,36 @@ public class 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 void setName(String name) { this.name = name; + } + + public int getCalories() { + return calories; + } + + public void setCalories(int calories) { this.calories = calories; } + + @Override + public String toString() { + return String.format("name: %s calories: %d", name, calories); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java index 04ba15d98..7e22f6eb1 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java @@ -1,12 +1,27 @@ package com.iluwatar.layers; +import java.util.Optional; + public class CakeToppingInfo { - + + public final Optional id; public final String name; public final int calories; - public CakeToppingInfo(String name, int calories) { + public CakeToppingInfo(Long id, String name, int calories) { + this.id = Optional.of(id); this.name = name; this.calories = calories; } + + public CakeToppingInfo(String name, int calories) { + this.id = Optional.empty(); + this.name = name; + this.calories = calories; + } + + @Override + public String toString() { + return String.format("name: %s calories: %d", name, calories); + } } From 0beb19426cba5eed1771006993fea1885dce2d2d Mon Sep 17 00:00:00 2001 From: Dmitriy Zarubin Date: Mon, 10 Aug 2015 10:20:13 +0300 Subject: [PATCH 076/687] Minor fixes in Step Builder --- README.md | 1 + .../src/main/java/com/iluwatar/stepbuilder/Character.java | 4 ++-- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3ae006ff8..f5a81bb15 100644 --- a/README.md +++ b/README.md @@ -835,6 +835,7 @@ Java-design-patterns project uses [semantic versioning](http://semver.org/) sche * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) * [Spring Data](http://www.amazon.com/Spring-Data-Mark-Pollack/dp/1449323952/ref=sr_1_1) * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) +* [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java index 4bd29227f..70727f386 100644 --- a/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java +++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/Character.java @@ -71,9 +71,9 @@ public class Character { StringBuilder sb = new StringBuilder(); sb.append("This is a "); sb.append(fighterClass != null ? fighterClass : wizardClass); - sb.append(" named a "); + sb.append(" named "); sb.append(name); - sb.append(" armed "); + sb.append(" armed with a "); sb.append(weapon != null ? weapon : spell != null ? spell : "with nothing"); sb.append(abilities != null ? (" and wielding " + abilities + " abilities") : ""); sb.append("."); From 41ab86763ead26ce734cd2e337f11fea8e2af29c Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Tue, 11 Aug 2015 11:58:02 +0530 Subject: [PATCH 077/687] Updated README for better navigational summary Links to various important sections of README is provided at the top so that it becomes easily navigable. --- README.md | 52 +++++++++++++++++++++++++++++++++++----------------- 1 file changed, 35 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 85a7aa1bf..c902cbc85 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,31 @@ # Design pattern samples in Java. -## Build status, coverage and static analysis: - ![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master) [![Coverage Status](https://coveralls.io/repos/iluwatar/java-design-patterns/badge.svg?branch=master)](https://coveralls.io/r/iluwatar/java-design-patterns?branch=master) Coverity Scan Build Status -## Introduction + - Introduction + - List of Design Patterns + - Creational Patterns + - Structural Patterns + - Behavioral Patterns + - Concurreny Patterns + - Presentation Tier Patterns + - Business Tier Patterns + - Architectural Patterns + - Integration Patterns + - Idioms + - Frequently Asked Questions + - How to contribute + - Contributing a new pattern + - Working on non-pattern issue + - Versioning + - Credits + - License + + +## Introduction Design patterns are formalized best practices that the programmer can use to solve common problems when designing an application or system. @@ -21,7 +39,7 @@ are familiar with the patterns. ## List of Design Patterns -### Creational Patterns +### Creational Patterns Creational design patterns abstract the instantiation process. They help make a system independent of how its objects are created, composed, and represented. @@ -36,7 +54,7 @@ system independent of how its objects are created, composed, and represented. * [Multiton](#multiton) * [Object Pool](#object-pool) -### Structural Patterns +### Structural Patterns Structural patterns are concerned with how classes and objects are composed to form larger structures. @@ -52,7 +70,7 @@ form larger structures. * [Servant](#servant) * [Event Aggregator](#event-aggregator) -### Behavioral Patterns +### Behavioral Patterns Behavioral patterns are concerned with algorithms and the assignment of responsibilities between objects. @@ -73,7 +91,7 @@ responsibilities between objects. * [Specification](#specification) * [Dependency Injection](#dependency-injection) -### Concurrency Patterns +### Concurrency Patterns Concurrency patterns are those types of design patterns that deal with the multi-threaded programming paradigm. @@ -83,7 +101,7 @@ multi-threaded programming paradigm. * [Async Method Invocation](#async-method-invocation) * [Half-Sync/Half-Async](#half-sync-half-async) -### Presentation Tier Patterns +### Presentation Tier Patterns Presentation Tier patterns are the top-most level of the application, this is concerned with translating tasks and results to something the user can @@ -94,11 +112,11 @@ understand. * [Flux](#flux) * [Front Controller](#front-controller) -### Business Tier Patterns +### Business Tier Patterns * [Business Delegate](#business-delegate) -### Architectural Patterns +### Architectural Patterns An architectural pattern is a general, reusable solution to a commonly occurring problem in software architecture within a given context. @@ -108,14 +126,14 @@ problem in software architecture within a given context. * [Naked Objects](#naked-objects) * [Repository](#repository) -### Integration Patterns +### Integration Patterns Integration patterns are concerned with how software applications communicate and exchange data. * [Tolerant Reader](#tolerant-reader) -### Idioms +### Idioms A programming idiom is a means of expressing a recurring construct in one or more programming languages. Generally speaking, a programming idiom is an @@ -891,7 +909,7 @@ degrading execution efficiency. * [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) -# Frequently asked questions +# Frequently asked questions **Q: What is the difference between State and Strategy patterns?** @@ -951,7 +969,7 @@ Flyweight. -# How to contribute +# How to contribute **To work on a new pattern** you need to do the following steps: @@ -989,7 +1007,7 @@ Flyweight. should be added to the corresponding section of the `README.md`. -# Versioning +# Versioning Java-design-patterns project uses [semantic versioning](http://semver.org/) scheme. However, version numbers in this project do not signify binary releases @@ -997,7 +1015,7 @@ scheme. However, version numbers in this project do not signify binary releases other words, version numbers are used only for project planning sake. -# Credits +# 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) @@ -1020,6 +1038,6 @@ other words, version numbers are used only for project planning sake. * [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) -# License +# License This project is licensed under the terms of the MIT license. From 8e1d0a642ea3d79021c47b0bff2242e8a55318f3 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Tue, 11 Aug 2015 12:10:58 +0530 Subject: [PATCH 078/687] Added go to top links in various sections --- README.md | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index c902cbc85..98506f13f 100644 --- a/README.md +++ b/README.md @@ -5,12 +5,13 @@ src="https://scan.coverity.com/projects/5634/badge.svg"/> + - Introduction - List of Design Patterns - Creational Patterns - Structural Patterns - Behavioral Patterns - - Concurreny Patterns + - Concurrency Patterns - Presentation Tier Patterns - Business Tier Patterns - Architectural Patterns @@ -37,9 +38,9 @@ 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. -## List of Design Patterns +## List of Design Patterns [↑](#top) -### Creational Patterns +### Creational Patterns [↑](#top) Creational design patterns abstract the instantiation process. They help make a system independent of how its objects are created, composed, and represented. @@ -54,7 +55,7 @@ system independent of how its objects are created, composed, and represented. * [Multiton](#multiton) * [Object Pool](#object-pool) -### Structural Patterns +### Structural Patterns [↑](#top) Structural patterns are concerned with how classes and objects are composed to form larger structures. @@ -70,7 +71,7 @@ form larger structures. * [Servant](#servant) * [Event Aggregator](#event-aggregator) -### Behavioral Patterns +### Behavioral Patterns [↑](#top) Behavioral patterns are concerned with algorithms and the assignment of responsibilities between objects. @@ -91,7 +92,7 @@ responsibilities between objects. * [Specification](#specification) * [Dependency Injection](#dependency-injection) -### Concurrency Patterns +### Concurrency Patterns [↑](#top) Concurrency patterns are those types of design patterns that deal with the multi-threaded programming paradigm. @@ -101,7 +102,7 @@ multi-threaded programming paradigm. * [Async Method Invocation](#async-method-invocation) * [Half-Sync/Half-Async](#half-sync-half-async) -### Presentation Tier Patterns +### Presentation Tier Patterns [↑](#top) Presentation Tier patterns are the top-most level of the application, this is concerned with translating tasks and results to something the user can @@ -112,11 +113,11 @@ understand. * [Flux](#flux) * [Front Controller](#front-controller) -### Business Tier Patterns +### Business Tier Patterns [↑](#top) * [Business Delegate](#business-delegate) -### Architectural Patterns +### Architectural Patterns [↑](#top) An architectural pattern is a general, reusable solution to a commonly occurring problem in software architecture within a given context. @@ -126,14 +127,14 @@ problem in software architecture within a given context. * [Naked Objects](#naked-objects) * [Repository](#repository) -### Integration Patterns +### Integration Patterns [↑](#top) Integration patterns are concerned with how software applications communicate and exchange data. * [Tolerant Reader](#tolerant-reader) -### Idioms +### Idioms [↑](#top) A programming idiom is a means of expressing a recurring construct in one or more programming languages. Generally speaking, a programming idiom is an @@ -909,7 +910,7 @@ degrading execution efficiency. * [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) -# Frequently asked questions +# Frequently asked questions [↑](#top) **Q: What is the difference between State and Strategy patterns?** @@ -969,7 +970,7 @@ Flyweight. -# How to contribute +# How to contribute [↑](#top) **To work on a new pattern** you need to do the following steps: @@ -1007,7 +1008,7 @@ Flyweight. should be added to the corresponding section of the `README.md`. -# Versioning +# Versioning [↑](#top) Java-design-patterns project uses [semantic versioning](http://semver.org/) scheme. However, version numbers in this project do not signify binary releases @@ -1015,7 +1016,7 @@ scheme. However, version numbers in this project do not signify binary releases other words, version numbers are used only for project planning sake. -# Credits +# Credits [↑](#top) * [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) @@ -1038,6 +1039,6 @@ other words, version numbers are used only for project planning sake. * [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) -# License +# License [↑](#top) This project is licensed under the terms of the MIT license. From 5d8ff14ffc95ca425d387b80e5db31012754f188 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Tue, 11 Aug 2015 12:16:51 +0530 Subject: [PATCH 079/687] Fixup --- README.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/README.md b/README.md index 98506f13f..358dfa3f3 100644 --- a/README.md +++ b/README.md @@ -19,8 +19,6 @@ - Idioms - Frequently Asked Questions - How to contribute - - Contributing a new pattern - - Working on non-pattern issue - Versioning - Credits - License From 5ecb6ce152158b4c260d768c1a1d2463bb6af1a4 Mon Sep 17 00:00:00 2001 From: The Gitter Badger Date: Tue, 11 Aug 2015 19:33:28 +0000 Subject: [PATCH 080/687] Added Gitter badge --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 358dfa3f3..b2b72a358 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # Design pattern samples in Java. +[![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) + ![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master) [![Coverage Status](https://coveralls.io/repos/iluwatar/java-design-patterns/badge.svg?branch=master)](https://coveralls.io/r/iluwatar/java-design-patterns?branch=master) Coverity Scan Build Status From 9ca69c72a37c5fc9eb96acc276b30664e8c542b1 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 12 Aug 2015 11:33:49 +0530 Subject: [PATCH 081/687] Added reference to POSA and white paper of pattern in README --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index b2b72a358..dc43a2dc5 100644 --- a/README.md +++ b/README.md @@ -1037,6 +1037,8 @@ other words, version numbers are used only for project planning sake. * [Spring Data](http://www.amazon.com/Spring-Data-Mark-Pollack/dp/1449323952/ref=sr_1_1) * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) * [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) +* [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) # License [↑](#top) From 913b4fa30c31451e3ffa93aca355109ad617712a Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 12 Aug 2015 23:13:10 +0300 Subject: [PATCH 082/687] #84 Work on cake baking --- layers/pom.xml | 2 +- .../main/java/com/iluwatar/layers/App.java | 17 ++++-- .../main/java/com/iluwatar/layers/Cake.java | 9 +++- .../layers/CakeBakingServiceImpl.java | 52 +++++++++++++++---- .../java/com/iluwatar/layers/CakeLayer.java | 13 +++++ .../com/iluwatar/layers/CakeLayerInfo.java | 2 +- .../java/com/iluwatar/layers/CakeTopping.java | 13 +++++ .../com/iluwatar/layers/CakeToppingInfo.java | 2 +- .../src/main/resources/applicationContext.xml | 5 +- 9 files changed, 96 insertions(+), 19 deletions(-) diff --git a/layers/pom.xml b/layers/pom.xml index 2027f6ae3..dd036e74c 100644 --- a/layers/pom.xml +++ b/layers/pom.xml @@ -14,7 +14,7 @@ org.springframework.data spring-data-jpa - + org.hibernate hibernate-entitymanager diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 67aeb45ac..239674d02 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -1,16 +1,27 @@ package com.iluwatar.layers; +import java.util.Arrays; + public class App { public static void main(String[] args) { CakeBakingService service = new CakeBakingServiceImpl(); - service.saveNewLayer(new CakeLayerInfo("foo", 1)); - service.saveNewLayer(new CakeLayerInfo("bar", 2)); + service.saveNewLayer(new CakeLayerInfo("chocolate", 1200)); + service.saveNewLayer(new CakeLayerInfo("banana", 900)); + service.saveNewLayer(new CakeLayerInfo("strawberry", 950)); service.getAllLayers().stream().forEach((layer) -> System.out.println(layer)); - service.saveNewTopping(new CakeToppingInfo("hoi", 11)); + service.saveNewTopping(new CakeToppingInfo("candies", 350)); service.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); + CakeInfo cakeInfo = new CakeInfo(new CakeToppingInfo("candies", 0), + Arrays.asList(new CakeLayerInfo("chocolate", 0), new CakeLayerInfo("chocolate", 0), + new CakeLayerInfo("chocolate", 0))); + try { + service.bakeNewCake(cakeInfo); + } catch (CakeBakingException e) { + e.printStackTrace(); + } } } diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java index 8d78d203f..5bdb4ae51 100644 --- a/layers/src/main/java/com/iluwatar/layers/Cake.java +++ b/layers/src/main/java/com/iluwatar/layers/Cake.java @@ -3,6 +3,7 @@ package com.iluwatar.layers; import java.util.ArrayList; import java.util.List; +import javax.persistence.CascadeType; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; @@ -16,10 +17,10 @@ public class Cake { @GeneratedValue private Long id; - @OneToOne + @OneToOne(cascade = CascadeType.ALL) private CakeTopping topping; - @OneToMany + @OneToMany(cascade = CascadeType.ALL) private List layers; public Cake() { @@ -49,4 +50,8 @@ public class Cake { public void setLayers(List layers) { this.layers = layers; } + + public void addLayer(CakeLayer layer) { + this.layers.add(layer); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java index 6bf41c290..419a31d4f 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -8,7 +8,11 @@ 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; +@Service +@Transactional public class CakeBakingServiceImpl implements CakeBakingService { private AbstractApplicationContext context; @@ -22,23 +26,31 @@ public class CakeBakingServiceImpl implements CakeBakingService { List allToppings = getAllToppings(); List matchingToppings = allToppings.stream() .filter((t) -> t.name.equals(cakeInfo.cakeToppingInfo.name)).collect(Collectors.toList()); - if (!matchingToppings.isEmpty()) { -// CakeToppingDao toppingBean = context.getBean(CakeToppingDao.class); -// toppingBean.delete(matchingToppings.iterator().next().id.get()); - } else { + if (matchingToppings.isEmpty()) { throw new CakeBakingException(String.format("Topping %s is not available", cakeInfo.cakeToppingInfo.name)); } - List allLayers = getAllLayers(); + List allLayers = getAllLayerEntities(); + List foundLayers = new ArrayList<>(); for (CakeLayerInfo info: cakeInfo.cakeLayerInfos) { - Optional found = allLayers.stream().filter((layer) -> layer.name.equals(info.name)).findFirst(); - if (found.isPresent()) { -// CakeLayerDao layerBean = context.getBean(CakeLayerDao.class); -// layerBean.delete(found.get().id.get()); - } else { + 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().id.get()); CakeDao cakeBean = context.getBean(CakeDao.class); + Cake cake = new Cake(); + cake = cakeBean.save(cake); + cake.setTopping(topping); + topping.setCake(cake); + cake.setLayers(foundLayers); + for (CakeLayer layer: foundLayers) { + layer.setCake(cake); + } + cakeBean.save(cake); } @Override @@ -53,6 +65,16 @@ public class CakeBakingServiceImpl implements CakeBakingService { bean.save(new CakeLayer(layerInfo.name, layerInfo.calories)); } + private List getAllToppingEntities() { + CakeToppingDao bean = context.getBean(CakeToppingDao.class); + List result = new ArrayList<>(); + Iterator iterator = bean.findAll().iterator(); + while (iterator.hasNext()) { + result.add(iterator.next()); + } + return result; + } + @Override public List getAllToppings() { CakeToppingDao bean = context.getBean(CakeToppingDao.class); @@ -65,6 +87,16 @@ public class CakeBakingServiceImpl implements CakeBakingService { return result; } + private List getAllLayerEntities() { + CakeLayerDao bean = context.getBean(CakeLayerDao.class); + List result = new ArrayList<>(); + Iterator iterator = bean.findAll().iterator(); + while (iterator.hasNext()) { + result.add(iterator.next()); + } + return result; + } + @Override public List getAllLayers() { CakeLayerDao bean = context.getBean(CakeLayerDao.class); diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java index c547995b3..00101a379 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java @@ -1,8 +1,10 @@ package com.iluwatar.layers; +import javax.persistence.CascadeType; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; +import javax.persistence.ManyToOne; @Entity public class CakeLayer { @@ -14,6 +16,9 @@ public class CakeLayer { private String name; private int calories; + + @ManyToOne(cascade = CascadeType.ALL) + private Cake cake; public CakeLayer() { } @@ -51,4 +56,12 @@ public class CakeLayer { public String toString() { return String.format("name: %s calories: %d", name, calories); } + + public Cake getCake() { + return cake; + } + + public void setCake(Cake cake) { + this.cake = cake; + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java index 6b2b5b9b4..6b59ebb06 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java @@ -22,6 +22,6 @@ public class CakeLayerInfo { @Override public String toString() { - return String.format("name: %s calories: %d", name, calories); + return String.format("CakeLayerInfo name: %s calories: %d", name, calories); } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java index 38f61efca..5aa861979 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java @@ -1,8 +1,10 @@ package com.iluwatar.layers; +import javax.persistence.CascadeType; import javax.persistence.Entity; import javax.persistence.GeneratedValue; import javax.persistence.Id; +import javax.persistence.OneToOne; @Entity public class CakeTopping { @@ -15,6 +17,9 @@ public class CakeTopping { private int calories; + @OneToOne(cascade = CascadeType.ALL) + private Cake cake; + public CakeTopping() { } @@ -51,4 +56,12 @@ public class CakeTopping { public String toString() { return String.format("name: %s calories: %d", name, calories); } + + public Cake getCake() { + return cake; + } + + public void setCake(Cake cake) { + this.cake = cake; + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java index 7e22f6eb1..829862b3d 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java @@ -22,6 +22,6 @@ public class CakeToppingInfo { @Override public String toString() { - return String.format("name: %s calories: %d", name, calories); + return String.format("CakeToppingInfo name: %s calories: %d", name, calories); } } diff --git a/layers/src/main/resources/applicationContext.xml b/layers/src/main/resources/applicationContext.xml index 3fe15b2f6..3de47a215 100644 --- a/layers/src/main/resources/applicationContext.xml +++ b/layers/src/main/resources/applicationContext.xml @@ -6,10 +6,12 @@ xmlns:jpa="http://www.springframework.org/schema/data/jpa" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd - http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.0.xsd"> + http://www.springframework.org/schema/data/jpa http://www.springframework.org/schema/data/jpa/spring-jpa-1.0.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd"> + + @@ -33,6 +35,7 @@ + From aa04e7c85664a4c077829eee7302baae15da1c7a Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 13 Aug 2015 20:35:13 +0300 Subject: [PATCH 083/687] #84 More work on cake baking --- .../main/java/com/iluwatar/layers/App.java | 5 +-- .../main/java/com/iluwatar/layers/Cake.java | 22 ++++++++----- .../iluwatar/layers/CakeBakingService.java | 2 ++ .../layers/CakeBakingServiceImpl.java | 31 ++++++++++++++++--- .../java/com/iluwatar/layers/CakeInfo.java | 5 +++ .../java/com/iluwatar/layers/CakeLayer.java | 2 +- .../com/iluwatar/layers/CakeLayerInfo.java | 2 +- .../java/com/iluwatar/layers/CakeTopping.java | 2 +- .../com/iluwatar/layers/CakeToppingInfo.java | 2 +- 9 files changed, 55 insertions(+), 18 deletions(-) diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 239674d02..c02d910cb 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -16,12 +16,13 @@ public class App { service.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); CakeInfo cakeInfo = new CakeInfo(new CakeToppingInfo("candies", 0), - Arrays.asList(new CakeLayerInfo("chocolate", 0), new CakeLayerInfo("chocolate", 0), - new CakeLayerInfo("chocolate", 0))); + Arrays.asList(new CakeLayerInfo("chocolate", 0), new CakeLayerInfo("banana", 0), + new CakeLayerInfo("strawberry", 0))); try { service.bakeNewCake(cakeInfo); } catch (CakeBakingException e) { e.printStackTrace(); } + service.getAllCakes().stream().forEach((cake) -> System.out.println(cake)); } } diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java index 5bdb4ae51..9b395557c 100644 --- a/layers/src/main/java/com/iluwatar/layers/Cake.java +++ b/layers/src/main/java/com/iluwatar/layers/Cake.java @@ -1,10 +1,11 @@ package com.iluwatar.layers; -import java.util.ArrayList; -import java.util.List; +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; @@ -17,14 +18,14 @@ public class Cake { @GeneratedValue private Long id; - @OneToOne(cascade = CascadeType.ALL) + @OneToOne(cascade=CascadeType.REMOVE) private CakeTopping topping; - @OneToMany(cascade = CascadeType.ALL) - private List layers; + @OneToMany(cascade=CascadeType.REMOVE, fetch=FetchType.EAGER) + private Set layers; public Cake() { - setLayers(new ArrayList<>()); + setLayers(new HashSet<>()); } public Long getId() { @@ -43,15 +44,20 @@ public class Cake { this.topping = topping; } - public List getLayers() { + public Set getLayers() { return layers; } - public void setLayers(List layers) { + public 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()); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java index 731650d7e..33a8c3a8b 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java @@ -5,6 +5,8 @@ import java.util.List; public interface CakeBakingService { void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException; + + List getAllCakes(); void saveNewTopping(CakeToppingInfo toppingInfo); diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java index 419a31d4f..0f80614dd 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -1,9 +1,11 @@ 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; @@ -30,7 +32,7 @@ public class CakeBakingServiceImpl implements CakeBakingService { throw new CakeBakingException(String.format("Topping %s is not available", cakeInfo.cakeToppingInfo.name)); } List allLayers = getAllLayerEntities(); - List foundLayers = new ArrayList<>(); + Set foundLayers = new HashSet<>(); for (CakeLayerInfo info: cakeInfo.cakeLayerInfos) { Optional found = allLayers.stream().filter((layer) -> layer.getName().equals(info.name)).findFirst(); if (!found.isPresent()) { @@ -43,14 +45,16 @@ public class CakeBakingServiceImpl implements CakeBakingService { CakeTopping topping = toppingBean.findOne(matchingToppings.iterator().next().id.get()); CakeDao cakeBean = context.getBean(CakeDao.class); Cake cake = new Cake(); - cake = cakeBean.save(cake); cake.setTopping(topping); - topping.setCake(cake); 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); } - cakeBean.save(cake); } @Override @@ -108,4 +112,23 @@ public class CakeBakingServiceImpl implements CakeBakingService { } 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()); + ArrayList 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; + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java index f5be954a7..1cd637119 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java @@ -20,4 +20,9 @@ public class CakeInfo { this.cakeToppingInfo = cakeToppingInfo; this.cakeLayerInfos = cakeLayerInfos; } + + @Override + public String toString() { + return String.format("CakeInfo id=%d topping=%s layers=%s", id.get(), cakeToppingInfo, cakeLayerInfos); + } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java index 00101a379..255569322 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java @@ -54,7 +54,7 @@ public class CakeLayer { @Override public String toString() { - return String.format("name: %s calories: %d", name, calories); + return String.format("id=%s name=%s calories=%d", id, name, calories); } public Cake getCake() { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java index 6b59ebb06..c7715b61c 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java @@ -22,6 +22,6 @@ public class CakeLayerInfo { @Override public String toString() { - return String.format("CakeLayerInfo name: %s calories: %d", name, calories); + return String.format("CakeLayerInfo id=%d name=%s calories=%d", id.get(), name, calories); } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java index 5aa861979..0e9d19192 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java @@ -54,7 +54,7 @@ public class CakeTopping { @Override public String toString() { - return String.format("name: %s calories: %d", name, calories); + return String.format("id=%s name=%s calories=%d", name, calories); } public Cake getCake() { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java index 829862b3d..316f8ec04 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java @@ -22,6 +22,6 @@ public class CakeToppingInfo { @Override public String toString() { - return String.format("CakeToppingInfo name: %s calories: %d", name, calories); + return String.format("CakeToppingInfo id=%d name=%s calories=%d", id.get(), name, calories); } } From ea524ee2c0ca2ec8706f62f3a38b814806c4dad5 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 13 Aug 2015 20:48:29 +0300 Subject: [PATCH 084/687] #84 Removed Layers stuff accidentally pushed to master --- layers/pom.xml | 36 ------ .../main/java/com/iluwatar/layers/App.java | 27 ----- .../main/java/com/iluwatar/layers/Cake.java | 57 --------- .../iluwatar/layers/CakeBakingException.java | 11 -- .../iluwatar/layers/CakeBakingService.java | 16 --- .../layers/CakeBakingServiceImpl.java | 111 ------------------ .../java/com/iluwatar/layers/CakeDao.java | 9 -- .../java/com/iluwatar/layers/CakeInfo.java | 23 ---- .../java/com/iluwatar/layers/CakeLayer.java | 67 ----------- .../com/iluwatar/layers/CakeLayerDao.java | 9 -- .../com/iluwatar/layers/CakeLayerInfo.java | 27 ----- .../java/com/iluwatar/layers/CakeTopping.java | 67 ----------- .../com/iluwatar/layers/CakeToppingDao.java | 9 -- .../com/iluwatar/layers/CakeToppingInfo.java | 27 ----- .../main/resources/META-INF/persistence.xml | 8 -- .../src/main/resources/applicationContext.xml | 42 ------- .../java/com/iluwatar/layers/AppTest.java | 12 -- pom.xml | 1 - 18 files changed, 559 deletions(-) delete mode 100644 layers/pom.xml delete mode 100644 layers/src/main/java/com/iluwatar/layers/App.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/Cake.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeBakingException.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeBakingService.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeDao.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeInfo.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeLayer.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeTopping.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java delete mode 100644 layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java delete mode 100644 layers/src/main/resources/META-INF/persistence.xml delete mode 100644 layers/src/main/resources/applicationContext.xml delete mode 100644 layers/src/test/java/com/iluwatar/layers/AppTest.java diff --git a/layers/pom.xml b/layers/pom.xml deleted file mode 100644 index dd036e74c..000000000 --- a/layers/pom.xml +++ /dev/null @@ -1,36 +0,0 @@ - - - 4.0.0 - - com.iluwatar - java-design-patterns - 1.5.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 - - - diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java deleted file mode 100644 index 239674d02..000000000 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ /dev/null @@ -1,27 +0,0 @@ -package com.iluwatar.layers; - -import java.util.Arrays; - -public class App { - - public static void main(String[] args) { - - CakeBakingService service = new CakeBakingServiceImpl(); - service.saveNewLayer(new CakeLayerInfo("chocolate", 1200)); - service.saveNewLayer(new CakeLayerInfo("banana", 900)); - service.saveNewLayer(new CakeLayerInfo("strawberry", 950)); - service.getAllLayers().stream().forEach((layer) -> System.out.println(layer)); - - service.saveNewTopping(new CakeToppingInfo("candies", 350)); - service.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); - - CakeInfo cakeInfo = new CakeInfo(new CakeToppingInfo("candies", 0), - Arrays.asList(new CakeLayerInfo("chocolate", 0), new CakeLayerInfo("chocolate", 0), - new CakeLayerInfo("chocolate", 0))); - try { - service.bakeNewCake(cakeInfo); - } catch (CakeBakingException e) { - e.printStackTrace(); - } - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java deleted file mode 100644 index 5bdb4ae51..000000000 --- a/layers/src/main/java/com/iluwatar/layers/Cake.java +++ /dev/null @@ -1,57 +0,0 @@ -package com.iluwatar.layers; - -import java.util.ArrayList; -import java.util.List; - -import javax.persistence.CascadeType; -import javax.persistence.Entity; -import javax.persistence.GeneratedValue; -import javax.persistence.Id; -import javax.persistence.OneToMany; -import javax.persistence.OneToOne; - -@Entity -public class Cake { - - @Id - @GeneratedValue - private Long id; - - @OneToOne(cascade = CascadeType.ALL) - private CakeTopping topping; - - @OneToMany(cascade = CascadeType.ALL) - private List layers; - - public Cake() { - setLayers(new ArrayList<>()); - } - - 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 List getLayers() { - return layers; - } - - public void setLayers(List layers) { - this.layers = layers; - } - - public void addLayer(CakeLayer layer) { - this.layers.add(layer); - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java deleted file mode 100644 index 2b131da19..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java +++ /dev/null @@ -1,11 +0,0 @@ -package com.iluwatar.layers; - -public class CakeBakingException extends Exception { - - public CakeBakingException() { - } - - public CakeBakingException(String message) { - super(message); - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java deleted file mode 100644 index 731650d7e..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java +++ /dev/null @@ -1,16 +0,0 @@ -package com.iluwatar.layers; - -import java.util.List; - -public interface CakeBakingService { - - void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException; - - void saveNewTopping(CakeToppingInfo toppingInfo); - - List getAllToppings(); - - void saveNewLayer(CakeLayerInfo layerInfo); - - List getAllLayers(); -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java deleted file mode 100644 index 419a31d4f..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ /dev/null @@ -1,111 +0,0 @@ -package com.iluwatar.layers; - -import java.util.ArrayList; -import java.util.Iterator; -import java.util.List; -import java.util.Optional; -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; - -@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 = getAllToppings(); - List matchingToppings = allToppings.stream() - .filter((t) -> t.name.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 = getAllLayerEntities(); - List foundLayers = new ArrayList<>(); - 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().id.get()); - CakeDao cakeBean = context.getBean(CakeDao.class); - Cake cake = new Cake(); - cake = cakeBean.save(cake); - cake.setTopping(topping); - topping.setCake(cake); - cake.setLayers(foundLayers); - for (CakeLayer layer: foundLayers) { - layer.setCake(cake); - } - cakeBean.save(cake); - } - - @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 getAllToppingEntities() { - CakeToppingDao bean = context.getBean(CakeToppingDao.class); - List result = new ArrayList<>(); - Iterator iterator = bean.findAll().iterator(); - while (iterator.hasNext()) { - result.add(iterator.next()); - } - return result; - } - - @Override - public List getAllToppings() { - CakeToppingDao bean = context.getBean(CakeToppingDao.class); - List result = new ArrayList<>(); - Iterator iterator = bean.findAll().iterator(); - while (iterator.hasNext()) { - CakeTopping next = iterator.next(); - result.add(new CakeToppingInfo(next.getId(), next.getName(), next.getCalories())); - } - return result; - } - - private List getAllLayerEntities() { - CakeLayerDao bean = context.getBean(CakeLayerDao.class); - List result = new ArrayList<>(); - Iterator iterator = bean.findAll().iterator(); - while (iterator.hasNext()) { - result.add(iterator.next()); - } - return result; - } - - @Override - public List getAllLayers() { - CakeLayerDao bean = context.getBean(CakeLayerDao.class); - List result = new ArrayList<>(); - Iterator iterator = bean.findAll().iterator(); - while (iterator.hasNext()) { - CakeLayer next = iterator.next(); - result.add(new CakeLayerInfo(next.getId(), next.getName(), next.getCalories())); - } - return result; - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeDao.java b/layers/src/main/java/com/iluwatar/layers/CakeDao.java deleted file mode 100644 index eb9e2fdaa..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeDao.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.iluwatar.layers; - -import org.springframework.data.repository.CrudRepository; -import org.springframework.stereotype.Repository; - -@Repository -public interface CakeDao extends CrudRepository { - -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java deleted file mode 100644 index f5be954a7..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java +++ /dev/null @@ -1,23 +0,0 @@ -package com.iluwatar.layers; - -import java.util.List; -import java.util.Optional; - -public class CakeInfo { - - public final Optional id; - public final CakeToppingInfo cakeToppingInfo; - public final List cakeLayerInfos; - - public CakeInfo(Long id, CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { - this.id = Optional.of(id); - this.cakeToppingInfo = cakeToppingInfo; - this.cakeLayerInfos = cakeLayerInfos; - } - - public CakeInfo(CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) { - this.id = Optional.empty(); - this.cakeToppingInfo = cakeToppingInfo; - this.cakeLayerInfos = cakeLayerInfos; - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java deleted file mode 100644 index 00101a379..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java +++ /dev/null @@ -1,67 +0,0 @@ -package com.iluwatar.layers; - -import javax.persistence.CascadeType; -import javax.persistence.Entity; -import javax.persistence.GeneratedValue; -import javax.persistence.Id; -import javax.persistence.ManyToOne; - -@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 void setName(String name) { - this.name = name; - } - - public int getCalories() { - return calories; - } - - public void setCalories(int calories) { - this.calories = calories; - } - - @Override - public String toString() { - return String.format("name: %s calories: %d", name, calories); - } - - public Cake getCake() { - return cake; - } - - public void setCake(Cake cake) { - this.cake = cake; - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java deleted file mode 100644 index c46aafaeb..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.iluwatar.layers; - -import org.springframework.data.repository.CrudRepository; -import org.springframework.stereotype.Repository; - -@Repository -public interface CakeLayerDao extends CrudRepository { - -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java deleted file mode 100644 index 6b59ebb06..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java +++ /dev/null @@ -1,27 +0,0 @@ -package com.iluwatar.layers; - -import java.util.Optional; - -public class CakeLayerInfo { - - public final Optional id; - public final String name; - public final int calories; - - public CakeLayerInfo(Long id, String name, int calories) { - this.id = Optional.of(id); - this.name = name; - this.calories = calories; - } - - public CakeLayerInfo(String name, int calories) { - this.id = Optional.empty(); - this.name = name; - this.calories = calories; - } - - @Override - public String toString() { - return String.format("CakeLayerInfo name: %s calories: %d", name, calories); - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java deleted file mode 100644 index 5aa861979..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java +++ /dev/null @@ -1,67 +0,0 @@ -package com.iluwatar.layers; - -import javax.persistence.CascadeType; -import javax.persistence.Entity; -import javax.persistence.GeneratedValue; -import javax.persistence.Id; -import javax.persistence.OneToOne; - -@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 void setName(String name) { - this.name = name; - } - - public int getCalories() { - return calories; - } - - public void setCalories(int calories) { - this.calories = calories; - } - - @Override - public String toString() { - return String.format("name: %s calories: %d", name, calories); - } - - public Cake getCake() { - return cake; - } - - public void setCake(Cake cake) { - this.cake = cake; - } -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java deleted file mode 100644 index 81f371750..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java +++ /dev/null @@ -1,9 +0,0 @@ -package com.iluwatar.layers; - -import org.springframework.data.repository.CrudRepository; -import org.springframework.stereotype.Repository; - -@Repository -public interface CakeToppingDao extends CrudRepository { - -} diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java deleted file mode 100644 index 829862b3d..000000000 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java +++ /dev/null @@ -1,27 +0,0 @@ -package com.iluwatar.layers; - -import java.util.Optional; - -public class CakeToppingInfo { - - public final Optional id; - public final String name; - public final int calories; - - public CakeToppingInfo(Long id, String name, int calories) { - this.id = Optional.of(id); - this.name = name; - this.calories = calories; - } - - public CakeToppingInfo(String name, int calories) { - this.id = Optional.empty(); - this.name = name; - this.calories = calories; - } - - @Override - public String toString() { - return String.format("CakeToppingInfo name: %s calories: %d", name, calories); - } -} diff --git a/layers/src/main/resources/META-INF/persistence.xml b/layers/src/main/resources/META-INF/persistence.xml deleted file mode 100644 index 0aded0dbd..000000000 --- a/layers/src/main/resources/META-INF/persistence.xml +++ /dev/null @@ -1,8 +0,0 @@ - - - - - - diff --git a/layers/src/main/resources/applicationContext.xml b/layers/src/main/resources/applicationContext.xml deleted file mode 100644 index 3de47a215..000000000 --- a/layers/src/main/resources/applicationContext.xml +++ /dev/null @@ -1,42 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/layers/src/test/java/com/iluwatar/layers/AppTest.java b/layers/src/test/java/com/iluwatar/layers/AppTest.java deleted file mode 100644 index 22c35267a..000000000 --- a/layers/src/test/java/com/iluwatar/layers/AppTest.java +++ /dev/null @@ -1,12 +0,0 @@ -package com.iluwatar.layers; - -import org.junit.Test; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} diff --git a/pom.xml b/pom.xml index 1296fc3d5..1059edc58 100644 --- a/pom.xml +++ b/pom.xml @@ -74,7 +74,6 @@ business-delegate half-sync-half-async step-builder - layers From 2a46b69178aa5c252f5df49cc1c951c4d08c05e4 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 13 Aug 2015 21:11:09 +0300 Subject: [PATCH 085/687] #84 Changed database name --- layers/src/main/resources/applicationContext.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/layers/src/main/resources/applicationContext.xml b/layers/src/main/resources/applicationContext.xml index 3de47a215..70cd34a37 100644 --- a/layers/src/main/resources/applicationContext.xml +++ b/layers/src/main/resources/applicationContext.xml @@ -19,7 +19,7 @@ - + From 84d14edc4a2592f50370842170b9c4bdc7ee62f1 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 13 Aug 2015 21:51:25 +0300 Subject: [PATCH 086/687] #84 Added view layer --- .../main/java/com/iluwatar/layers/App.java | 24 +++++++++++-------- .../java/com/iluwatar/layers/CakeView.java | 14 +++++++++++ 2 files changed, 28 insertions(+), 10 deletions(-) create mode 100644 layers/src/main/java/com/iluwatar/layers/CakeView.java diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index c02d910cb..6058d540e 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -5,24 +5,28 @@ import java.util.Arrays; public class App { public static void main(String[] args) { - - CakeBakingService service = new CakeBakingServiceImpl(); - service.saveNewLayer(new CakeLayerInfo("chocolate", 1200)); - service.saveNewLayer(new CakeLayerInfo("banana", 900)); - service.saveNewLayer(new CakeLayerInfo("strawberry", 950)); - service.getAllLayers().stream().forEach((layer) -> System.out.println(layer)); + CakeBakingService cakeBakingService = new CakeBakingServiceImpl(); + initializeData(cakeBakingService); + CakeView cakeView = new CakeView(cakeBakingService); + cakeView.render(); + } + + 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.getAllLayers().stream().forEach((layer) -> System.out.println(layer)); - service.saveNewTopping(new CakeToppingInfo("candies", 350)); - service.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); + cakeBakingService.saveNewTopping(new CakeToppingInfo("candies", 350)); + cakeBakingService.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); CakeInfo cakeInfo = new CakeInfo(new CakeToppingInfo("candies", 0), Arrays.asList(new CakeLayerInfo("chocolate", 0), new CakeLayerInfo("banana", 0), new CakeLayerInfo("strawberry", 0))); try { - service.bakeNewCake(cakeInfo); + cakeBakingService.bakeNewCake(cakeInfo); } catch (CakeBakingException e) { e.printStackTrace(); } - service.getAllCakes().stream().forEach((cake) -> System.out.println(cake)); } } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeView.java b/layers/src/main/java/com/iluwatar/layers/CakeView.java new file mode 100644 index 000000000..105c32d3b --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/CakeView.java @@ -0,0 +1,14 @@ +package com.iluwatar.layers; + +public class CakeView { + + private CakeBakingService cakeBakingService; + + public CakeView(CakeBakingService cakeBakingService) { + this.cakeBakingService = cakeBakingService; + } + + public void render() { + cakeBakingService.getAllCakes().stream().forEach((cake) -> System.out.println(cake)); + } +} From fbb12b53ba66ee62d561accb5e7a2b4e792a0112 Mon Sep 17 00:00:00 2001 From: Markus Date: Thu, 13 Aug 2015 23:54:40 +0200 Subject: [PATCH 087/687] Work towards #56: Splitting up the README I did the job and splitted up the readme, hopefully everything was splitted correctly... --- README.md | 760 +----------------- abstract-factory/index.md | 25 + adapter/index.md | 23 + async-method-invocation/index.md | 26 + bridge/index.md | 21 + builder/index.md | 23 + business-delegate/index.md | 20 + callback/index.md | 21 + chain-of-responsibility/index.md | 24 + command/index.md | 31 + composite/index.md | 23 + dao/index.md | 17 + decorator/index.md | 19 + dependency-injection/index.md | 21 + double-checked-locking/index.md | 19 + double-dispatch/index.md | 20 + event-aggregator/index.md | 24 + execute-around/index.md | 18 + facade/index.md | 18 + factory-method/index.md | 19 + flux/index.md | 18 + flyweight/index.md | 25 + front-controller/index.md | 23 + half-sync-half-async/index.md | 27 + idioms/index.md | 24 + intercepting-filter/index.md | 18 + interpreter/index.md | 19 + introduction/index.md | 18 + iterator/index.md | 22 + lazy-loading/index.md | 22 + mediator/index.md | 19 + memento/index.md | 21 + model-view-controller/index.md | 18 + model-view-presenter/index.md | 17 + multiton/index.md | 16 + naked-objects/index.md | 23 + null-object/index.md | 22 + object-pool/index.md | 19 + observer/index.md | 27 + poison-pill/index.md | 20 + private-class-data/index.md | 17 + property/index.md | 20 + prototype/index.md | 22 + proxy/index.md | 33 + repository/index.md | 26 + .../index.md | 15 + servant/index.md | 17 + service-layer/index.md | 21 + service-locator/index.md | 27 + singleton/index.md | 27 + specification/index.md | 19 + state/index.md | 17 + step-builder/index.md | 14 + strategy/index.md | 20 + template-method/index.md | 19 + thread-pool/index.md | 19 + tolerant-reader/index.md | 18 + visitor/index.md | 23 + 58 files changed, 1205 insertions(+), 759 deletions(-) create mode 100644 abstract-factory/index.md create mode 100644 adapter/index.md create mode 100644 async-method-invocation/index.md create mode 100644 bridge/index.md create mode 100644 builder/index.md create mode 100644 business-delegate/index.md create mode 100644 callback/index.md create mode 100644 chain-of-responsibility/index.md create mode 100644 command/index.md create mode 100644 composite/index.md create mode 100644 dao/index.md create mode 100644 decorator/index.md create mode 100644 dependency-injection/index.md create mode 100644 double-checked-locking/index.md create mode 100644 double-dispatch/index.md create mode 100644 event-aggregator/index.md create mode 100644 execute-around/index.md create mode 100644 facade/index.md create mode 100644 factory-method/index.md create mode 100644 flux/index.md create mode 100644 flyweight/index.md create mode 100644 front-controller/index.md create mode 100644 half-sync-half-async/index.md create mode 100644 idioms/index.md create mode 100644 intercepting-filter/index.md create mode 100644 interpreter/index.md create mode 100644 introduction/index.md create mode 100644 iterator/index.md create mode 100644 lazy-loading/index.md create mode 100644 mediator/index.md create mode 100644 memento/index.md create mode 100644 model-view-controller/index.md create mode 100644 model-view-presenter/index.md create mode 100644 multiton/index.md create mode 100644 naked-objects/index.md create mode 100644 null-object/index.md create mode 100644 object-pool/index.md create mode 100644 observer/index.md create mode 100644 poison-pill/index.md create mode 100644 private-class-data/index.md create mode 100644 property/index.md create mode 100644 prototype/index.md create mode 100644 proxy/index.md create mode 100644 repository/index.md create mode 100644 resource-acquisition-is-initialization/index.md create mode 100644 servant/index.md create mode 100644 service-layer/index.md create mode 100644 service-locator/index.md create mode 100644 singleton/index.md create mode 100644 specification/index.md create mode 100644 state/index.md create mode 100644 step-builder/index.md create mode 100644 strategy/index.md create mode 100644 template-method/index.md create mode 100644 thread-pool/index.md create mode 100644 tolerant-reader/index.md create mode 100644 visitor/index.md diff --git a/README.md b/README.md index dc43a2dc5..a1561b483 100644 --- a/README.md +++ b/README.md @@ -152,764 +152,6 @@ something small while the patterns are larger. * [Resource Acquisition Is Initialization](#resource-acquisition-is-initialization) * [Private Class Data](#private-class-data) -## Abstract Factory [↑](#list-of-design-patterns) -**Intent:** Provide an interface for creating families of related or dependent -objects without specifying their concrete classes. - -![alt text](./abstract-factory/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 - -**Real world examples:** -* [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html) - -## Builder [↑](#list-of-design-patterns) -**Intent:** Separate the construction of a complex object from its -representation so that the same construction process can create different -representations. - -![alt text](./builder/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) -* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) - -## Factory Method [↑](#list-of-design-patterns) -**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](./factory-method/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 - -## Prototype [↑](#list-of-design-patterns) -**Intent:** Specify the kinds of objects to create using a prototypical -instance, and create new objects by copying this prototype. - -![alt text](./prototype/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) - -## Singleton [↑](#list-of-design-patterns) -**Intent:** Ensure a class only has one instance, and provide a global point of -access to it. - -![alt text](./singleton/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) - -## Step Builder [↑](#list-of-design-patterns) -**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](./step-builder/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. - -## Adapter [↑](#list-of-design-patterns) -**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](./adapter/etc/adapter_1.png "Adapter") - -**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. - -**Real world examples:** -* [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29) - -## Bridge [↑](#list-of-design-patterns) -**Intent:** Decouple an abstraction from its implementation so that the two can -vary independently. - - -![alt text](./bridge/etc/bridge_1.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. - -## Composite [↑](#list-of-design-patterns) -**Intent:** Compose objects into tree structures to represent part-whole -hierarchies. Composite lets clients treat individual objects and compositions -of objects uniformly. - -![alt text](./composite/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) - -## Decorator [↑](#list-of-design-patterns) -**Intent:** Attach additional responsibilities to an object dynamically. -Decorators provide a flexible alternative to subclassing for extending -functionality. - -![alt text](./decorator/etc/decorator_1.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 - -## Facade [↑](#list-of-design-patterns) -**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](./facade/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 - -## Flyweight [↑](#list-of-design-patterns) -**Intent:** Use sharing to support large numbers of fine-grained objects -efficiently. - -![alt text](./flyweight/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) - -## Proxy [↑](#list-of-design-patterns) -**Intent:** Provide a surrogate or placeholder for another object to control -access to it. - -![alt text](./proxy/etc/proxy_1.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 - -* a remote proxy provides a local representative for an object in a different address space. -* a virtual proxy creates expensive objects on demand. -* a 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 -* to count references to an object - -**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/) - -## Service Locator [↑](#list-of-design-patterns) -**Intent:** Encapsulate the processes involved in obtaining a service with a -strong abstraction layer. - -![alt text](./service-locator/etc/service-locator.png "Proxy") - -**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 - -## Chain of responsibility [↑](#list-of-design-patterns) -**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](./chain/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) - -## Command [↑](#list-of-design-patterns) -**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](./command/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) - -## Interpreter [↑](#list-of-design-patterns) -**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](./interpreter/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 - -## Iterator [↑](#list-of-design-patterns) -**Intent:** Provide a way to access the elements of an aggregate object -sequentially without exposing its underlying representation. - -![alt text](./iterator/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) - -## Mediator [↑](#list-of-design-patterns) -**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](./mediator/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 - -## Memento [↑](#list-of-design-patterns) -**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](./memento/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) - -## Observer [↑](#list-of-design-patterns) -**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](./observer/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) - -## State [↑](#list-of-design-patterns) -**Intent:** Allow an object to alter its behavior when its internal state -changes. The object will appear to change its class. - -![alt text](./state/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. - -## Strategy [↑](#list-of-design-patterns) -**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](./strategy/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 - -## Template method [↑](#list-of-design-patterns) -**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](./template-method/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 - -## Visitor [↑](#list-of-design-patterns) -**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](./visitor/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) - -## Model-View-Presenter [↑](#list-of-design-patterns) -**Intent:** Apply a "Separation of Concerns" principle in a way that allows -developers to build and test user interfaces. - -![alt text](./model-view-presenter/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. - -## Data Access Object [↑](#list-of-design-patterns) -**Intent:** Object provides an abstract interface to some type of database or -other persistence mechanism. - -![alt text](./dao/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 - -## Double Checked Locking [↑](#list-of-design-patterns) -**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](./double-checked-locking/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. - -## Servant [↑](#list-of-design-patterns) -**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](./servant/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. - -## Null Object [↑](#list-of-design-patterns) -**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](./null-object/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. - -## Event Aggregator [↑](#list-of-design-patterns) -**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](./event-aggregator/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. - -## Callback [↑](#list-of-design-patterns) -**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](./callback/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. - -## Intercepting Filter [↑](#list-of-design-patterns) -**Intent:** Provide pluggable filters to conduct necessary pre-processing and -post-processing to requests from a client to a target - -![alt text](./intercepting-filter/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 - -## Execute Around [↑](#list-of-design-patterns) -**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](./execute-around/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. - -## Property [↑](#list-of-design-patterns) -**Intent:** Create hierarchy of objects and new objects using already existing -objects as parents. - -![alt text](./property/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 - -## Poison Pill [↑](#list-of-design-patterns) -**Intent:** Poison Pill is known predefined data item that allows to provide -graceful shutdown for separate distributed consumption process. - -![alt text](./poison-pill/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) - -## Lazy Loading [↑](#list-of-design-patterns) -**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](./lazy-loading/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 - -## Service Layer [↑](#list-of-design-patterns) -**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](./service-layer/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 - -## Specification [↑](#list-of-design-patterns) -**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](./specification/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) - -## Tolerant Reader [↑](#list-of-design-patterns) -**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](./tolerant-reader/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 - -## Model-View-Controller [↑](#list-of-design-patterns) -**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](./model-view-controller/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 - -## Flux [↑](#list-of-design-patterns) -**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](./flux/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. - -## Double Dispatch [↑](#list-of-design-patterns) -**Intent:** Double Dispatch pattern is a way to create maintainable dynamic -behavior based on receiver and parameter types. - -![alt text](./double-dispatch/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) - -## Multiton [↑](#list-of-design-patterns) -**Intent:** Ensure a class only has limited number of instances, and provide a -global point of access to them. - -![alt text](./multiton/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 - -## Resource Acquisition Is Initialization [↑](#list-of-design-patterns) -**Intent:** Resource Acquisition Is Initialization pattern can be used to implement exception safe resource management. - -![alt text](./resource-acquisition-is-initialization/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 - -## Thread Pool [↑](#list-of-design-patterns) -**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](./thread-pool/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 - -## Async Method Invocation [↑](#list-of-design-patterns) -**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](./async-method-invocation/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) - -## Private Class Data [↑](#list-of-design-patterns) -**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](./private-class-data/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 - -## Object Pool [↑](#list-of-design-patterns) -**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](./object-pool/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) - -## Dependency Injection [↑](#list-of-design-patterns) -**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](./dependency-injection/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 - -## Naked Objects [↑](#list-of-design-patterns) -**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](./naked-objects/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/) - -## Front Controller [↑](#list-of-design-patterns) -**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](./front-controller/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/) - -## Repository [↑](#list-of-design-patterns) -**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](./repository/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/) - -## Business Delegate [↑](#list-of-design-patterns) -**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](./business-delegate/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 - -## Half-Sync/Half-Async [↑](#list-of-design-patterns) -**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](./half-sync-half-async/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) - # Frequently asked questions [↑](#top) **Q: What is the difference between State and Strategy patterns?** @@ -1021,7 +263,7 @@ other words, version numbers are used only for project planning sake. * [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 Generics and Collections](http://www.amazon.com/Java-Generics-Collections-Maurice-Naftalin/dp/0596527756/) -* [Let’s Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf) +* [Let's Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf) * [Pattern Languages of Program Design](http://www.amazon.com/Pattern-Languages-Program-Design-Coplien/dp/0201607344/ref=sr_1_1) * [Martin Fowler - Event Aggregator](http://martinfowler.com/eaaDev/EventAggregator.html) * [TutorialsPoint - Intercepting Filter](http://www.tutorialspoint.com/design_pattern/intercepting_filter_pattern.htm) diff --git a/abstract-factory/index.md b/abstract-factory/index.md new file mode 100644 index 000000000..ae053b2a2 --- /dev/null +++ b/abstract-factory/index.md @@ -0,0 +1,25 @@ +--- +layout: pattern +title: Abstract Factory +folder: abstract-factory +categories: + - pattern_cat + - creational +tags: pattern_tag +--- + +**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 + +**Real world examples:** + +* [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html) \ No newline at end of file diff --git a/adapter/index.md b/adapter/index.md new file mode 100644 index 000000000..b8d2741cc --- /dev/null +++ b/adapter/index.md @@ -0,0 +1,23 @@ +--- +layout: pattern +title: Adapter +folder: adapter +categories: pattern_cat +tags: pattern_tag +--- + +**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_1.png "Adapter") + +**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. + +**Real world examples:** + +* [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29) \ No newline at end of file diff --git a/async-method-invocation/index.md b/async-method-invocation/index.md new file mode 100644 index 000000000..00812d310 --- /dev/null +++ b/async-method-invocation/index.md @@ -0,0 +1,26 @@ +--- +layout: pattern +title: Async Method Invocation +folder: async-method-invocation +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/bridge/index.md b/bridge/index.md new file mode 100644 index 000000000..d0a1e0ea1 --- /dev/null +++ b/bridge/index.md @@ -0,0 +1,21 @@ +--- +layout: pattern +title: Bridge +folder: bridge +categories: pattern_cat +tags: pattern_tag +--- + +**Intent:** Decouple an abstraction from its implementation so that the two can +vary independently. + + +![alt text](./etc/bridge_1.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. \ No newline at end of file diff --git a/builder/index.md b/builder/index.md new file mode 100644 index 000000000..0a5254ce1 --- /dev/null +++ b/builder/index.md @@ -0,0 +1,23 @@ +--- +layout: pattern +title: Builder +folder: builder +categories: creational +tags: pattern_tag +--- + +**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) +* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) \ No newline at end of file diff --git a/business-delegate/index.md b/business-delegate/index.md new file mode 100644 index 000000000..23c92b89e --- /dev/null +++ b/business-delegate/index.md @@ -0,0 +1,20 @@ +--- +layout: pattern +title: Business Delegate +folder: business-delegate +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/callback/index.md b/callback/index.md new file mode 100644 index 000000000..b8a4f2808 --- /dev/null +++ b/callback/index.md @@ -0,0 +1,21 @@ +--- +layout: pattern +title: Callback +folder: callback +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/chain-of-responsibility/index.md b/chain-of-responsibility/index.md new file mode 100644 index 000000000..234815506 --- /dev/null +++ b/chain-of-responsibility/index.md @@ -0,0 +1,24 @@ +--- +layout: pattern +title: Chain of responsibility +folder: chain-of-responsibility +categories: pattern_cat +tags: pattern_tag +--- + +**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](./chain/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) \ No newline at end of file diff --git a/command/index.md b/command/index.md new file mode 100644 index 000000000..21422da35 --- /dev/null +++ b/command/index.md @@ -0,0 +1,31 @@ +--- +layout: pattern +title: Command +folder: command +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/composite/index.md b/composite/index.md new file mode 100644 index 000000000..d987aa27c --- /dev/null +++ b/composite/index.md @@ -0,0 +1,23 @@ +--- +layout: pattern +title: Composite +folder: composite +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/dao/index.md b/dao/index.md new file mode 100644 index 000000000..3d6b10d3f --- /dev/null +++ b/dao/index.md @@ -0,0 +1,17 @@ +--- +layout: pattern +title: Data Access Object +folder: dao +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/decorator/index.md b/decorator/index.md new file mode 100644 index 000000000..3674e5d4a --- /dev/null +++ b/decorator/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Decorator +folder: decorator +categories: pattern_cat +tags: pattern_tag +--- + +**Intent:** Attach additional responsibilities to an object dynamically. +Decorators provide a flexible alternative to subclassing for extending +functionality. + +![alt text](./etc/decorator_1.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 \ No newline at end of file diff --git a/dependency-injection/index.md b/dependency-injection/index.md new file mode 100644 index 000000000..d0b238818 --- /dev/null +++ b/dependency-injection/index.md @@ -0,0 +1,21 @@ +--- +layout: pattern +title: Dependency Injection +folder: dependency-injection +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/double-checked-locking/index.md b/double-checked-locking/index.md new file mode 100644 index 000000000..8af9e6af0 --- /dev/null +++ b/double-checked-locking/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Double Checked Locking +folder: double-checked-locking +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/double-dispatch/index.md b/double-dispatch/index.md new file mode 100644 index 000000000..8c6586590 --- /dev/null +++ b/double-dispatch/index.md @@ -0,0 +1,20 @@ +--- +layout: pattern +title: Double Dispatch +folder: double-dispatch +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/event-aggregator/index.md b/event-aggregator/index.md new file mode 100644 index 000000000..a6fd9fb22 --- /dev/null +++ b/event-aggregator/index.md @@ -0,0 +1,24 @@ +--- +layout: pattern +title: Event Aggregator +folder: event-aggregator +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/execute-around/index.md b/execute-around/index.md new file mode 100644 index 000000000..949f424c3 --- /dev/null +++ b/execute-around/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Execute Around +folder: execute-around +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/facade/index.md b/facade/index.md new file mode 100644 index 000000000..8a9a9c1b9 --- /dev/null +++ b/facade/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Facade +folder: facade +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/factory-method/index.md b/factory-method/index.md new file mode 100644 index 000000000..e80382b9c --- /dev/null +++ b/factory-method/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Factory Method +folder: factory-method +categories: creational +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/flux/index.md b/flux/index.md new file mode 100644 index 000000000..f91c0ef00 --- /dev/null +++ b/flux/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Flux +folder: flux +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/flyweight/index.md b/flyweight/index.md new file mode 100644 index 000000000..c1d2439a7 --- /dev/null +++ b/flyweight/index.md @@ -0,0 +1,25 @@ +--- +layout: pattern +title: Flyweight +folder: flyweight +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/front-controller/index.md b/front-controller/index.md new file mode 100644 index 000000000..0a77a5ef3 --- /dev/null +++ b/front-controller/index.md @@ -0,0 +1,23 @@ +--- +layout: pattern +title: Front Controller +folder: front-controller +categories: pattern_cat +tags: pattern_tag +--- + +**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/) \ No newline at end of file diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md new file mode 100644 index 000000000..a9cd97698 --- /dev/null +++ b/half-sync-half-async/index.md @@ -0,0 +1,27 @@ +--- +layout: pattern +title: Half-Sync/Half-Async +folder: half-sync-half-async +categories: pattern_cat +tags: pattern_tag +--- + +**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](./half-sync-half-async/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) \ No newline at end of file diff --git a/idioms/index.md b/idioms/index.md new file mode 100644 index 000000000..68b689117 --- /dev/null +++ b/idioms/index.md @@ -0,0 +1,24 @@ +--- +layout: pattern +title: Idioms +folder: idioms +categories: pattern_cat +tags: pattern_tag +--- + + +A programming idiom is a means of expressing a recurring construct in one or +more programming languages. Generally speaking, a programming idiom is an +expression of a simple task, algorithm, or data structure that is not a built-in +feature in the programming language being used, or, conversely, the use of an +unusual or notable feature that is built into a programming language. What +distinguishes idioms from patterns is generally the size, the idioms tend to be +something small while the patterns are larger. + +* [Execute Around](#execute-around) +* [Poison Pill](#poison-pill) +* [Callback](#callback) +* [Lazy Loading](#lazy-loading) +* [Double Dispatch](#double-dispatch) +* [Resource Acquisition Is Initialization](#resource-acquisition-is-initialization) +* [Private Class Data](#private-class-data) \ No newline at end of file diff --git a/intercepting-filter/index.md b/intercepting-filter/index.md new file mode 100644 index 000000000..1badb0521 --- /dev/null +++ b/intercepting-filter/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Intercepting Filter +folder: intercepting-filter +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/interpreter/index.md b/interpreter/index.md new file mode 100644 index 000000000..dcd0d9f46 --- /dev/null +++ b/interpreter/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Interpreter +folder: interpreter +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/introduction/index.md b/introduction/index.md new file mode 100644 index 000000000..8ca2aea0e --- /dev/null +++ b/introduction/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Introduction +folder: introduction +categories: pattern_cat +tags: pattern_tag +--- + + +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. \ No newline at end of file diff --git a/iterator/index.md b/iterator/index.md new file mode 100644 index 000000000..75d9223d1 --- /dev/null +++ b/iterator/index.md @@ -0,0 +1,22 @@ +--- +layout: pattern +title: Iterator +folder: iterator +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/lazy-loading/index.md b/lazy-loading/index.md new file mode 100644 index 000000000..4a14d83d6 --- /dev/null +++ b/lazy-loading/index.md @@ -0,0 +1,22 @@ +--- +layout: pattern +title: Lazy Loading +folder: lazy-loading +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/mediator/index.md b/mediator/index.md new file mode 100644 index 000000000..f112d68ff --- /dev/null +++ b/mediator/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Mediator +folder: mediator +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/memento/index.md b/memento/index.md new file mode 100644 index 000000000..5c7bbb618 --- /dev/null +++ b/memento/index.md @@ -0,0 +1,21 @@ +--- +layout: pattern +title: Memento +folder: memento +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/model-view-controller/index.md b/model-view-controller/index.md new file mode 100644 index 000000000..39a370258 --- /dev/null +++ b/model-view-controller/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Model-View-Controller +folder: model-view-controller +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/model-view-presenter/index.md b/model-view-presenter/index.md new file mode 100644 index 000000000..85b72029b --- /dev/null +++ b/model-view-presenter/index.md @@ -0,0 +1,17 @@ +--- +layout: pattern +title: Model-View-Presenter +folder: model-view-presenter +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/multiton/index.md b/multiton/index.md new file mode 100644 index 000000000..23ddc714a --- /dev/null +++ b/multiton/index.md @@ -0,0 +1,16 @@ +--- +layout: pattern +title: Multiton +folder: multiton +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/naked-objects/index.md b/naked-objects/index.md new file mode 100644 index 000000000..db7a48b48 --- /dev/null +++ b/naked-objects/index.md @@ -0,0 +1,23 @@ +--- +layout: pattern +title: Naked Objects +folder: naked-objects +categories: pattern_cat +tags: pattern_tag +--- + +**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/) \ No newline at end of file diff --git a/null-object/index.md b/null-object/index.md new file mode 100644 index 000000000..0ffb4395f --- /dev/null +++ b/null-object/index.md @@ -0,0 +1,22 @@ +--- +layout: pattern +title: Null Object +folder: null-object +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/object-pool/index.md b/object-pool/index.md new file mode 100644 index 000000000..7521ce66f --- /dev/null +++ b/object-pool/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Object Pool +folder: object-pool +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/observer/index.md b/observer/index.md new file mode 100644 index 000000000..16bcfcd67 --- /dev/null +++ b/observer/index.md @@ -0,0 +1,27 @@ +--- +layout: pattern +title: Observer +folder: observer +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/poison-pill/index.md b/poison-pill/index.md new file mode 100644 index 000000000..ab151dc5d --- /dev/null +++ b/poison-pill/index.md @@ -0,0 +1,20 @@ +--- +layout: pattern +title: Poison Pill +folder: poison-pill +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/private-class-data/index.md b/private-class-data/index.md new file mode 100644 index 000000000..4f83a0c32 --- /dev/null +++ b/private-class-data/index.md @@ -0,0 +1,17 @@ +--- +layout: pattern +title: Private Class Data +folder: private-class-data +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/property/index.md b/property/index.md new file mode 100644 index 000000000..6e92c35f8 --- /dev/null +++ b/property/index.md @@ -0,0 +1,20 @@ +--- +layout: pattern +title: Property +folder: property +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/prototype/index.md b/prototype/index.md new file mode 100644 index 000000000..aeb4b69b0 --- /dev/null +++ b/prototype/index.md @@ -0,0 +1,22 @@ +--- +layout: pattern +title: Prototype +folder: prototype +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/proxy/index.md b/proxy/index.md new file mode 100644 index 000000000..8f907d563 --- /dev/null +++ b/proxy/index.md @@ -0,0 +1,33 @@ +--- +layout: pattern +title: Proxy +folder: proxy +categories: pattern_cat +tags: pattern_tag +--- + +**Intent:** Provide a surrogate or placeholder for another object to control +access to it. + +![alt text](./etc/proxy_1.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 + +* a remote proxy provides a local representative for an object in a different address space. +* a virtual proxy creates expensive objects on demand. +* a 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 +* to count references to an object + +**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/) \ No newline at end of file diff --git a/repository/index.md b/repository/index.md new file mode 100644 index 000000000..0fbd39d30 --- /dev/null +++ b/repository/index.md @@ -0,0 +1,26 @@ +--- +layout: pattern +title: Repository +folder: repository +categories: pattern_cat +tags: pattern_tag +--- + +**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/) \ No newline at end of file diff --git a/resource-acquisition-is-initialization/index.md b/resource-acquisition-is-initialization/index.md new file mode 100644 index 000000000..d5fb509c6 --- /dev/null +++ b/resource-acquisition-is-initialization/index.md @@ -0,0 +1,15 @@ +--- +layout: pattern +title: Resource Acquisition Is Initialization +folder: resource-acquisition-is-initialization +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/servant/index.md b/servant/index.md new file mode 100644 index 000000000..ff0339d00 --- /dev/null +++ b/servant/index.md @@ -0,0 +1,17 @@ +--- +layout: pattern +title: Servant +folder: servant +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/service-layer/index.md b/service-layer/index.md new file mode 100644 index 000000000..0c1a09163 --- /dev/null +++ b/service-layer/index.md @@ -0,0 +1,21 @@ +--- +layout: pattern +title: Service Layer +folder: service-layer +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/service-locator/index.md b/service-locator/index.md new file mode 100644 index 000000000..c091b3440 --- /dev/null +++ b/service-locator/index.md @@ -0,0 +1,27 @@ +--- +layout: pattern +title: Service Locator +folder: service-locator +categories: pattern_cat +tags: pattern_tag +--- + +**Intent:** Encapsulate the processes involved in obtaining a service with a +strong abstraction layer. + +![alt text](./etc/service-locator.png "Proxy") + +**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 \ No newline at end of file diff --git a/singleton/index.md b/singleton/index.md new file mode 100644 index 000000000..a06b4efcc --- /dev/null +++ b/singleton/index.md @@ -0,0 +1,27 @@ +--- +layout: pattern +title: Singleton +folder: singleton +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/specification/index.md b/specification/index.md new file mode 100644 index 000000000..1ad6cd3f7 --- /dev/null +++ b/specification/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Specification +folder: specification +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file diff --git a/state/index.md b/state/index.md new file mode 100644 index 000000000..8bafb0fe1 --- /dev/null +++ b/state/index.md @@ -0,0 +1,17 @@ +--- +layout: pattern +title: State +folder: state +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/step-builder/index.md b/step-builder/index.md new file mode 100644 index 000000000..ce805fe07 --- /dev/null +++ b/step-builder/index.md @@ -0,0 +1,14 @@ +--- +layout: pattern +title: Step Builder +folder: step-builder +categories: pattern_cat +tags: pattern_tag +--- + +**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. \ No newline at end of file diff --git a/strategy/index.md b/strategy/index.md new file mode 100644 index 000000000..ecd6623fa --- /dev/null +++ b/strategy/index.md @@ -0,0 +1,20 @@ +--- +layout: pattern +title: Strategy +folder: strategy +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/template-method/index.md b/template-method/index.md new file mode 100644 index 000000000..42f22f46f --- /dev/null +++ b/template-method/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Template method +folder: template-method +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/thread-pool/index.md b/thread-pool/index.md new file mode 100644 index 000000000..70ccd2231 --- /dev/null +++ b/thread-pool/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Thread Pool +folder: thread-pool +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/tolerant-reader/index.md b/tolerant-reader/index.md new file mode 100644 index 000000000..3c04840b2 --- /dev/null +++ b/tolerant-reader/index.md @@ -0,0 +1,18 @@ +--- +layout: pattern +title: Tolerant Reader +folder: tolerant-reader +categories: pattern_cat +tags: pattern_tag +--- + +**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 \ No newline at end of file diff --git a/visitor/index.md b/visitor/index.md new file mode 100644 index 000000000..d263fb80c --- /dev/null +++ b/visitor/index.md @@ -0,0 +1,23 @@ +--- +layout: pattern +title: Visitor +folder: visitor +categories: pattern_cat +tags: pattern_tag +--- + +**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) \ No newline at end of file From 89cb234be94157a3ac57240a21f668163d1c164f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 15 Aug 2015 18:05:35 +0300 Subject: [PATCH 088/687] #84 Added interface for view layer --- layers/src/main/java/com/iluwatar/layers/App.java | 9 +++++++-- .../iluwatar/layers/{CakeView.java => CakeViewImpl.java} | 4 ++-- layers/src/main/java/com/iluwatar/layers/View.java | 7 +++++++ 3 files changed, 16 insertions(+), 4 deletions(-) rename layers/src/main/java/com/iluwatar/layers/{CakeView.java => CakeViewImpl.java} (70%) create mode 100644 layers/src/main/java/com/iluwatar/layers/View.java diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 6058d540e..266977c89 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -3,11 +3,16 @@ package com.iluwatar.layers; import java.util.Arrays; public class App { + + private static CakeBakingService cakeBakingService = new CakeBakingServiceImpl(); public static void main(String[] args) { - CakeBakingService cakeBakingService = new CakeBakingServiceImpl(); + + // initialize example data initializeData(cakeBakingService); - CakeView cakeView = new CakeView(cakeBakingService); + + // create view and render it + CakeViewImpl cakeView = new CakeViewImpl(cakeBakingService); cakeView.render(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeView.java b/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java similarity index 70% rename from layers/src/main/java/com/iluwatar/layers/CakeView.java rename to layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java index 105c32d3b..a974d0672 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeView.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java @@ -1,10 +1,10 @@ package com.iluwatar.layers; -public class CakeView { +public class CakeViewImpl implements View { private CakeBakingService cakeBakingService; - public CakeView(CakeBakingService cakeBakingService) { + public CakeViewImpl(CakeBakingService cakeBakingService) { this.cakeBakingService = cakeBakingService; } diff --git a/layers/src/main/java/com/iluwatar/layers/View.java b/layers/src/main/java/com/iluwatar/layers/View.java new file mode 100644 index 000000000..4e89ca0b7 --- /dev/null +++ b/layers/src/main/java/com/iluwatar/layers/View.java @@ -0,0 +1,7 @@ +package com.iluwatar.layers; + +public interface View { + + void render(); + +} From 9aa831d688822185b42bccf1f9188ad31e4abf85 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 15 Aug 2015 18:35:16 +0300 Subject: [PATCH 089/687] #84 Example improvements. Instead of all toppings and all layers the service returns available toppings and layers. --- .../main/java/com/iluwatar/layers/App.java | 18 ++++++++--- .../iluwatar/layers/CakeBakingService.java | 4 +-- .../layers/CakeBakingServiceImpl.java | 30 ++++++++++++------- .../java/com/iluwatar/layers/CakeInfo.java | 9 +++++- .../src/main/resources/applicationContext.xml | 2 +- 5 files changed, 45 insertions(+), 18 deletions(-) diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 266977c89..5a5bde483 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -20,16 +20,26 @@ public class App { cakeBakingService.saveNewLayer(new CakeLayerInfo("chocolate", 1200)); cakeBakingService.saveNewLayer(new CakeLayerInfo("banana", 900)); cakeBakingService.saveNewLayer(new CakeLayerInfo("strawberry", 950)); - cakeBakingService.getAllLayers().stream().forEach((layer) -> System.out.println(layer)); + 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.getAllToppings().stream().forEach((topping) -> System.out.println(topping)); + cakeBakingService.saveNewTopping(new CakeToppingInfo("cherry", 350)); - CakeInfo cakeInfo = new CakeInfo(new CakeToppingInfo("candies", 0), + 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(cakeInfo); + 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(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java index 33a8c3a8b..c90b0de91 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java @@ -10,9 +10,9 @@ public interface CakeBakingService { void saveNewTopping(CakeToppingInfo toppingInfo); - List getAllToppings(); + List getAvailableToppings(); void saveNewLayer(CakeLayerInfo layerInfo); - List getAllLayers(); + List getAvailableLayers(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java index 0f80614dd..ff2ad6598 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -25,13 +25,13 @@ public class CakeBakingServiceImpl implements CakeBakingService { @Override public void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException { - List allToppings = getAllToppings(); + List allToppings = getAvailableToppings(); List matchingToppings = allToppings.stream() .filter((t) -> t.name.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 = getAllLayerEntities(); + List allLayers = getAvailableLayerEntities(); Set foundLayers = new HashSet<>(); for (CakeLayerInfo info: cakeInfo.cakeLayerInfos) { Optional found = allLayers.stream().filter((layer) -> layer.getName().equals(info.name)).findFirst(); @@ -69,46 +69,56 @@ public class CakeBakingServiceImpl implements CakeBakingService { bean.save(new CakeLayer(layerInfo.name, layerInfo.calories)); } - private List getAllToppingEntities() { + private List getAvailableToppingEntities() { CakeToppingDao bean = context.getBean(CakeToppingDao.class); List result = new ArrayList<>(); Iterator iterator = bean.findAll().iterator(); while (iterator.hasNext()) { - result.add(iterator.next()); + CakeTopping topping = iterator.next(); + if (topping.getCake() == null) { + result.add(topping); + } } return result; } @Override - public List getAllToppings() { + 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(); - result.add(new CakeToppingInfo(next.getId(), next.getName(), next.getCalories())); + if (next.getCake() == null) { + result.add(new CakeToppingInfo(next.getId(), next.getName(), next.getCalories())); + } } return result; } - private List getAllLayerEntities() { + private List getAvailableLayerEntities() { CakeLayerDao bean = context.getBean(CakeLayerDao.class); List result = new ArrayList<>(); Iterator iterator = bean.findAll().iterator(); while (iterator.hasNext()) { - result.add(iterator.next()); + CakeLayer next = iterator.next(); + if (next.getCake() == null) { + result.add(next); + } } return result; } @Override - public List getAllLayers() { + 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(); - result.add(new CakeLayerInfo(next.getId(), next.getName(), next.getCalories())); + if (next.getCake() == null) { + result.add(new CakeLayerInfo(next.getId(), next.getName(), next.getCalories())); + } } return result; } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java index 1cd637119..9487b0064 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java @@ -21,8 +21,15 @@ public class CakeInfo { this.cakeLayerInfos = cakeLayerInfos; } + 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", id.get(), cakeToppingInfo, cakeLayerInfos); + return String.format("CakeInfo id=%d topping=%s layers=%s totalCalories=%d", id.get(), cakeToppingInfo, + cakeLayerInfos, calculateTotalCalories()); } } diff --git a/layers/src/main/resources/applicationContext.xml b/layers/src/main/resources/applicationContext.xml index 70cd34a37..0c908ad2e 100644 --- a/layers/src/main/resources/applicationContext.xml +++ b/layers/src/main/resources/applicationContext.xml @@ -35,7 +35,7 @@ - + From fdb9be1e7698f60aa230aa7006be8301144bc74b Mon Sep 17 00:00:00 2001 From: Markus Date: Sat, 15 Aug 2015 18:03:05 +0200 Subject: [PATCH 090/687] Work towards #56: Add permalink to every pattern This makes cleaner URLs thanks to jekyll --- abstract-factory/index.md | 3 ++- adapter/index.md | 3 ++- async-method-invocation/index.md | 3 ++- bridge/index.md | 3 ++- builder/index.md | 3 ++- business-delegate/index.md | 3 ++- callback/index.md | 3 ++- chain-of-responsibility/index.md | 3 ++- command/index.md | 3 ++- composite/index.md | 3 ++- dao/index.md | 3 ++- decorator/index.md | 3 ++- dependency-injection/index.md | 3 ++- double-checked-locking/index.md | 3 ++- double-dispatch/index.md | 3 ++- event-aggregator/index.md | 3 ++- execute-around/index.md | 3 ++- facade/index.md | 3 ++- factory-method/index.md | 3 ++- flux/index.md | 3 ++- flyweight/index.md | 3 ++- front-controller/index.md | 3 ++- half-sync-half-async/index.md | 3 ++- idioms/index.md | 24 ------------------- intercepting-filter/index.md | 3 ++- interpreter/index.md | 3 ++- introduction/index.md | 4 +++- iterator/index.md | 3 ++- lazy-loading/index.md | 3 ++- mediator/index.md | 3 ++- memento/index.md | 3 ++- model-view-controller/index.md | 3 ++- model-view-presenter/index.md | 3 ++- multiton/index.md | 3 ++- naked-objects/index.md | 3 ++- null-object/index.md | 3 ++- object-pool/index.md | 3 ++- observer/index.md | 3 ++- poison-pill/index.md | 3 ++- private-class-data/index.md | 3 ++- property/index.md | 3 ++- prototype/index.md | 3 ++- proxy/index.md | 3 ++- repository/index.md | 3 ++- .../index.md | 3 ++- servant/index.md | 3 ++- service-layer/index.md | 3 ++- service-locator/index.md | 3 ++- singleton/index.md | 3 ++- specification/index.md | 3 ++- state/index.md | 3 ++- step-builder/index.md | 3 ++- strategy/index.md | 3 ++- template-method/index.md | 3 ++- thread-pool/index.md | 3 ++- tolerant-reader/index.md | 3 ++- visitor/index.md | 3 ++- 57 files changed, 113 insertions(+), 80 deletions(-) delete mode 100644 idioms/index.md diff --git a/abstract-factory/index.md b/abstract-factory/index.md index ae053b2a2..412e16009 100644 --- a/abstract-factory/index.md +++ b/abstract-factory/index.md @@ -2,6 +2,7 @@ layout: pattern title: Abstract Factory folder: abstract-factory +permalink: /patterns/abstract-factory/ categories: - pattern_cat - creational @@ -22,4 +23,4 @@ objects without specifying their concrete classes. **Real world examples:** -* [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html) \ No newline at end of file +* [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html) diff --git a/adapter/index.md b/adapter/index.md index b8d2741cc..f1e4043b6 100644 --- a/adapter/index.md +++ b/adapter/index.md @@ -2,6 +2,7 @@ layout: pattern title: Adapter folder: adapter +permalink: /patterns/adapter/ categories: pattern_cat tags: pattern_tag --- @@ -20,4 +21,4 @@ incompatible interfaces. **Real world examples:** -* [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29) \ No newline at end of file +* [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29) diff --git a/async-method-invocation/index.md b/async-method-invocation/index.md index 00812d310..0ea60c168 100644 --- a/async-method-invocation/index.md +++ b/async-method-invocation/index.md @@ -2,6 +2,7 @@ layout: pattern title: Async Method Invocation folder: async-method-invocation +permalink: /patterns/async-method-invocation/ categories: pattern_cat tags: pattern_tag --- @@ -23,4 +24,4 @@ callbacks or waiting until everything is done. **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) \ No newline at end of file +* [Task-based Asynchronous Pattern](https://msdn.microsoft.com/en-us/library/hh873175.aspx) (.NET) diff --git a/bridge/index.md b/bridge/index.md index d0a1e0ea1..b2319e22e 100644 --- a/bridge/index.md +++ b/bridge/index.md @@ -2,6 +2,7 @@ layout: pattern title: Bridge folder: bridge +permalink: /patterns/bridge/ categories: pattern_cat tags: pattern_tag --- @@ -18,4 +19,4 @@ vary independently. * 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. \ No newline at end of file +* 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. diff --git a/builder/index.md b/builder/index.md index 0a5254ce1..78fb61fea 100644 --- a/builder/index.md +++ b/builder/index.md @@ -2,6 +2,7 @@ layout: pattern title: Builder folder: builder +permalink: /patterns/builder/ categories: creational tags: pattern_tag --- @@ -20,4 +21,4 @@ representations. **Real world examples:** * [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html) -* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) \ No newline at end of file +* [Apache Camel builders](https://github.com/apache/camel/tree/0e195428ee04531be27a0b659005e3aa8d159d23/camel-core/src/main/java/org/apache/camel/builder) diff --git a/business-delegate/index.md b/business-delegate/index.md index 23c92b89e..37b118e15 100644 --- a/business-delegate/index.md +++ b/business-delegate/index.md @@ -2,6 +2,7 @@ layout: pattern title: Business Delegate folder: business-delegate +permalink: /patterns/business-delegate/ categories: pattern_cat tags: pattern_tag --- @@ -17,4 +18,4 @@ and interact with the business objects that make up the application. * 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 \ No newline at end of file +* you want to encapsulate service lookups and service calls diff --git a/callback/index.md b/callback/index.md index b8a4f2808..1d65e1514 100644 --- a/callback/index.md +++ b/callback/index.md @@ -2,6 +2,7 @@ layout: pattern title: Callback folder: callback +permalink: /patterns/callback/ categories: pattern_cat tags: pattern_tag --- @@ -18,4 +19,4 @@ at some convenient time. **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. \ No newline at end of file +* [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. diff --git a/chain-of-responsibility/index.md b/chain-of-responsibility/index.md index 234815506..3ee2a3c64 100644 --- a/chain-of-responsibility/index.md +++ b/chain-of-responsibility/index.md @@ -2,6 +2,7 @@ layout: pattern title: Chain of responsibility folder: chain-of-responsibility +permalink: /patterns/chain-of-responsibility/ categories: pattern_cat tags: pattern_tag --- @@ -21,4 +22,4 @@ objects and pass the request along the chain until an object handles it. **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) \ No newline at end of file +* [Apache Commons Chain](https://commons.apache.org/proper/commons-chain/index.html) diff --git a/command/index.md b/command/index.md index 21422da35..a675a30c7 100644 --- a/command/index.md +++ b/command/index.md @@ -2,6 +2,7 @@ layout: pattern title: Command folder: command +permalink: /patterns/command/ categories: pattern_cat tags: pattern_tag --- @@ -28,4 +29,4 @@ support undoable operations. **Real world examples:** -* [java.lang.Runnable](http://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html) \ No newline at end of file +* [java.lang.Runnable](http://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html) diff --git a/composite/index.md b/composite/index.md index d987aa27c..f50c32dd3 100644 --- a/composite/index.md +++ b/composite/index.md @@ -2,6 +2,7 @@ layout: pattern title: Composite folder: composite +permalink: /patterns/composite/ categories: pattern_cat tags: pattern_tag --- @@ -20,4 +21,4 @@ of objects 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) \ No newline at end of file +* [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) diff --git a/dao/index.md b/dao/index.md index 3d6b10d3f..8058f7c7c 100644 --- a/dao/index.md +++ b/dao/index.md @@ -2,6 +2,7 @@ layout: pattern title: Data Access Object folder: dao +permalink: /patterns/dao/ categories: pattern_cat tags: pattern_tag --- @@ -14,4 +15,4 @@ other persistence mechanism. **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 \ No newline at end of file +* when you want to avoid writing multiple data retrieval/persistence layers diff --git a/decorator/index.md b/decorator/index.md index 3674e5d4a..95ad2dced 100644 --- a/decorator/index.md +++ b/decorator/index.md @@ -2,6 +2,7 @@ layout: pattern title: Decorator folder: decorator +permalink: /patterns/decorator/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ functionality. * 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 \ No newline at end of file +* 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 diff --git a/dependency-injection/index.md b/dependency-injection/index.md index d0b238818..3b2853c75 100644 --- a/dependency-injection/index.md +++ b/dependency-injection/index.md @@ -2,6 +2,7 @@ layout: pattern title: Dependency Injection folder: dependency-injection +permalink: /patterns/dependency-injection/ categories: pattern_cat tags: pattern_tag --- @@ -18,4 +19,4 @@ inversion of control and single responsibility principles. **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 \ No newline at end of file +* to enable unit testing of classes in isolation using mock objects or stubs diff --git a/double-checked-locking/index.md b/double-checked-locking/index.md index 8af9e6af0..92fb22b01 100644 --- a/double-checked-locking/index.md +++ b/double-checked-locking/index.md @@ -2,6 +2,7 @@ layout: pattern title: Double Checked Locking folder: double-checked-locking +permalink: /patterns/double-checked-locking/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ actual locking logic proceed. **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. \ No newline at end of file +* 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. diff --git a/double-dispatch/index.md b/double-dispatch/index.md index 8c6586590..842913738 100644 --- a/double-dispatch/index.md +++ b/double-dispatch/index.md @@ -2,6 +2,7 @@ layout: pattern title: Double Dispatch folder: double-dispatch +permalink: /patterns/double-dispatch/ categories: pattern_cat tags: pattern_tag --- @@ -17,4 +18,4 @@ behavior based on receiver and parameter types. **Real world examples:** -* [ObjectOutputStream](https://docs.oracle.com/javase/8/docs/api/java/io/ObjectOutputStream.html) \ No newline at end of file +* [ObjectOutputStream](https://docs.oracle.com/javase/8/docs/api/java/io/ObjectOutputStream.html) diff --git a/event-aggregator/index.md b/event-aggregator/index.md index a6fd9fb22..d4a2395bd 100644 --- a/event-aggregator/index.md +++ b/event-aggregator/index.md @@ -2,6 +2,7 @@ layout: pattern title: Event Aggregator folder: event-aggregator +permalink: /patterns/event-aggregator/ categories: pattern_cat tags: pattern_tag --- @@ -21,4 +22,4 @@ allowing clients to register with just the aggregator. 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. \ No newline at end of file + simplifies the memory management issues in using observers. diff --git a/execute-around/index.md b/execute-around/index.md index 949f424c3..ec4c040bf 100644 --- a/execute-around/index.md +++ b/execute-around/index.md @@ -2,6 +2,7 @@ layout: pattern title: Execute Around folder: execute-around +permalink: /patterns/execute-around/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +16,4 @@ only what to do with the resource. **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. \ No newline at end of file +* you use an API that requires methods to be called in pairs such as open/close or allocate/deallocate. diff --git a/facade/index.md b/facade/index.md index 8a9a9c1b9..7e0d3100a 100644 --- a/facade/index.md +++ b/facade/index.md @@ -2,6 +2,7 @@ layout: pattern title: Facade folder: facade +permalink: /patterns/facade/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +16,4 @@ Facade defines a higher-level interface that makes the subsystem easier to use. * 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 \ No newline at end of file +* 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 diff --git a/factory-method/index.md b/factory-method/index.md index e80382b9c..11ad77dda 100644 --- a/factory-method/index.md +++ b/factory-method/index.md @@ -2,6 +2,7 @@ layout: pattern title: Factory Method folder: factory-method +permalink: /patterns/factory-method/ categories: creational tags: pattern_tag --- @@ -16,4 +17,4 @@ instantiation to subclasses. * 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 \ No newline at end of file +* classes delegate responsibility to one of several helper subclasses, and you want to localize the knowledge of which helper subclass is the delegate diff --git a/flux/index.md b/flux/index.md index f91c0ef00..fec262dce 100644 --- a/flux/index.md +++ b/flux/index.md @@ -2,6 +2,7 @@ layout: pattern title: Flux folder: flux +permalink: /patterns/flux/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +16,4 @@ logic, which updates all of the views that are affected. **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. \ No newline at end of file +* 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. diff --git a/flyweight/index.md b/flyweight/index.md index c1d2439a7..a2a4ca575 100644 --- a/flyweight/index.md +++ b/flyweight/index.md @@ -2,6 +2,7 @@ layout: pattern title: Flyweight folder: flyweight +permalink: /patterns/flyweight/ categories: pattern_cat tags: pattern_tag --- @@ -22,4 +23,4 @@ true **Real world examples:** -* [java.lang.Integer#valueOf(int)](http://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html#valueOf%28int%29) \ No newline at end of file +* [java.lang.Integer#valueOf(int)](http://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html#valueOf%28int%29) diff --git a/front-controller/index.md b/front-controller/index.md index 0a77a5ef3..221da0404 100644 --- a/front-controller/index.md +++ b/front-controller/index.md @@ -2,6 +2,7 @@ layout: pattern title: Front Controller folder: front-controller +permalink: /patterns/front-controller/ categories: pattern_cat tags: pattern_tag --- @@ -20,4 +21,4 @@ internationalization, routing and logging in a single place. **Real world examples:** -* [Apache Struts](https://struts.apache.org/) \ No newline at end of file +* [Apache Struts](https://struts.apache.org/) diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md index a9cd97698..ef3677fce 100644 --- a/half-sync-half-async/index.md +++ b/half-sync-half-async/index.md @@ -2,6 +2,7 @@ layout: pattern title: Half-Sync/Half-Async folder: half-sync-half-async +permalink: /patterns/half-sync-half-async/ categories: pattern_cat tags: pattern_tag --- @@ -24,4 +25,4 @@ degrading execution efficiency. * [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) \ No newline at end of file +* [Android AsyncTask framework](http://developer.android.com/reference/android/os/AsyncTask.html) diff --git a/idioms/index.md b/idioms/index.md deleted file mode 100644 index 68b689117..000000000 --- a/idioms/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -layout: pattern -title: Idioms -folder: idioms -categories: pattern_cat -tags: pattern_tag ---- - - -A programming idiom is a means of expressing a recurring construct in one or -more programming languages. Generally speaking, a programming idiom is an -expression of a simple task, algorithm, or data structure that is not a built-in -feature in the programming language being used, or, conversely, the use of an -unusual or notable feature that is built into a programming language. What -distinguishes idioms from patterns is generally the size, the idioms tend to be -something small while the patterns are larger. - -* [Execute Around](#execute-around) -* [Poison Pill](#poison-pill) -* [Callback](#callback) -* [Lazy Loading](#lazy-loading) -* [Double Dispatch](#double-dispatch) -* [Resource Acquisition Is Initialization](#resource-acquisition-is-initialization) -* [Private Class Data](#private-class-data) \ No newline at end of file diff --git a/intercepting-filter/index.md b/intercepting-filter/index.md index 1badb0521..6ceb97277 100644 --- a/intercepting-filter/index.md +++ b/intercepting-filter/index.md @@ -2,6 +2,7 @@ layout: pattern title: Intercepting Filter folder: intercepting-filter +permalink: /patterns/intercepting-filter/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +16,4 @@ post-processing to requests from a client to a target * 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 \ No newline at end of file +* you want a modular approach to configuring pre-processing and post-processing schemes diff --git a/interpreter/index.md b/interpreter/index.md index dcd0d9f46..d1d0babaf 100644 --- a/interpreter/index.md +++ b/interpreter/index.md @@ -2,6 +2,7 @@ layout: pattern title: Interpreter folder: interpreter +permalink: /patterns/interpreter/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ language. 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 \ No newline at end of file +* 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 diff --git a/introduction/index.md b/introduction/index.md index 8ca2aea0e..14df55cee 100644 --- a/introduction/index.md +++ b/introduction/index.md @@ -2,6 +2,8 @@ layout: pattern title: Introduction folder: introduction +permalink: /patterns/introduction/ +permalink: /patterns/introduction/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +17,4 @@ 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. \ No newline at end of file +are familiar with the patterns. diff --git a/iterator/index.md b/iterator/index.md index 75d9223d1..d8005cc23 100644 --- a/iterator/index.md +++ b/iterator/index.md @@ -2,6 +2,7 @@ layout: pattern title: Iterator folder: iterator +permalink: /patterns/iterator/ categories: pattern_cat tags: pattern_tag --- @@ -19,4 +20,4 @@ sequentially without exposing its underlying representation. **Real world examples:** -* [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html) \ No newline at end of file +* [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html) diff --git a/lazy-loading/index.md b/lazy-loading/index.md index 4a14d83d6..c1ecc1cf5 100644 --- a/lazy-loading/index.md +++ b/lazy-loading/index.md @@ -2,6 +2,7 @@ layout: pattern title: Lazy Loading folder: lazy-loading +permalink: /patterns/lazy-loading/ categories: pattern_cat tags: pattern_tag --- @@ -19,4 +20,4 @@ appropriately used. **Real world examples:** -* JPA annotations @OneToOne, @OneToMany, @ManyToOne, @ManyToMany and fetch = FetchType.LAZY \ No newline at end of file +* JPA annotations @OneToOne, @OneToMany, @ManyToOne, @ManyToMany and fetch = FetchType.LAZY diff --git a/mediator/index.md b/mediator/index.md index f112d68ff..ce1119eab 100644 --- a/mediator/index.md +++ b/mediator/index.md @@ -2,6 +2,7 @@ layout: pattern title: Mediator folder: mediator +permalink: /patterns/mediator/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ other explicitly, and it lets you vary their interaction independently. * 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 \ No newline at end of file +* a behavior that's distributed between several classes should be customizable without a lot of subclassing diff --git a/memento/index.md b/memento/index.md index 5c7bbb618..beb447fc9 100644 --- a/memento/index.md +++ b/memento/index.md @@ -2,6 +2,7 @@ layout: pattern title: Memento folder: memento +permalink: /patterns/memento/ categories: pattern_cat tags: pattern_tag --- @@ -18,4 +19,4 @@ object's internal state so that the object can be restored to this state later. **Real world examples:** -* [java.util.Date](http://docs.oracle.com/javase/8/docs/api/java/util/Date.html) \ No newline at end of file +* [java.util.Date](http://docs.oracle.com/javase/8/docs/api/java/util/Date.html) diff --git a/model-view-controller/index.md b/model-view-controller/index.md index 39a370258..cb85bad19 100644 --- a/model-view-controller/index.md +++ b/model-view-controller/index.md @@ -2,6 +2,7 @@ layout: pattern title: Model-View-Controller folder: model-view-controller +permalink: /patterns/model-view-controller/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +16,4 @@ display. **Applicability:** Use the Model-View-Controller pattern when -* you want to clearly separate the domain data from its user interface representation \ No newline at end of file +* you want to clearly separate the domain data from its user interface representation diff --git a/model-view-presenter/index.md b/model-view-presenter/index.md index 85b72029b..35b62a391 100644 --- a/model-view-presenter/index.md +++ b/model-view-presenter/index.md @@ -2,6 +2,7 @@ layout: pattern title: Model-View-Presenter folder: model-view-presenter +permalink: /patterns/model-view-presenter/ categories: pattern_cat tags: pattern_tag --- @@ -14,4 +15,4 @@ developers to build and test user interfaces. **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. \ No newline at end of file +* when a user interface development and testing is necessary. diff --git a/multiton/index.md b/multiton/index.md index 23ddc714a..854d75de3 100644 --- a/multiton/index.md +++ b/multiton/index.md @@ -2,6 +2,7 @@ layout: pattern title: Multiton folder: multiton +permalink: /patterns/multiton/ categories: pattern_cat tags: pattern_tag --- @@ -13,4 +14,4 @@ global point of access to them. **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 \ No newline at end of file +* there must be specific number of instances of a class, and they must be accessible to clients from a well-known access point diff --git a/naked-objects/index.md b/naked-objects/index.md index db7a48b48..160e68add 100644 --- a/naked-objects/index.md +++ b/naked-objects/index.md @@ -2,6 +2,7 @@ layout: pattern title: Naked Objects folder: naked-objects +permalink: /patterns/naked-objects/ categories: pattern_cat tags: pattern_tag --- @@ -20,4 +21,4 @@ everything else is autogenerated by the framework. **Real world examples:** -* [Apache Isis](https://isis.apache.org/) \ No newline at end of file +* [Apache Isis](https://isis.apache.org/) diff --git a/null-object/index.md b/null-object/index.md index 0ffb4395f..9888eeaf7 100644 --- a/null-object/index.md +++ b/null-object/index.md @@ -2,6 +2,7 @@ layout: pattern title: Null Object folder: null-object +permalink: /patterns/null-object/ categories: pattern_cat tags: pattern_tag --- @@ -19,4 +20,4 @@ Object is very predictable and has no side effects: it does nothing. **Applicability:** Use the Null Object pattern when -* you want to avoid explicit null checks and keep the algorithm elegant and easy to read. \ No newline at end of file +* you want to avoid explicit null checks and keep the algorithm elegant and easy to read. diff --git a/object-pool/index.md b/object-pool/index.md index 7521ce66f..a812d3fa1 100644 --- a/object-pool/index.md +++ b/object-pool/index.md @@ -2,6 +2,7 @@ layout: pattern title: Object Pool folder: object-pool +permalink: /patterns/object-pool/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ are in use and which are available. **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) \ No newline at end of file +* you need a large number of short-lived objects (memory fragmentation) diff --git a/observer/index.md b/observer/index.md index 16bcfcd67..ea6de55ae 100644 --- a/observer/index.md +++ b/observer/index.md @@ -2,6 +2,7 @@ layout: pattern title: Observer folder: observer +permalink: /patterns/observer/ categories: pattern_cat tags: pattern_tag --- @@ -24,4 +25,4 @@ automatically. **Real world examples:** -* [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html) \ No newline at end of file +* [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html) diff --git a/poison-pill/index.md b/poison-pill/index.md index ab151dc5d..7d3b02bf4 100644 --- a/poison-pill/index.md +++ b/poison-pill/index.md @@ -2,6 +2,7 @@ layout: pattern title: Poison Pill folder: poison-pill +permalink: /patterns/poison-pill/ categories: pattern_cat tags: pattern_tag --- @@ -17,4 +18,4 @@ graceful shutdown for separate distributed consumption process. **Real world examples:** -* [akka.actor.PoisonPill](http://doc.akka.io/docs/akka/2.1.4/java/untyped-actors.html) \ No newline at end of file +* [akka.actor.PoisonPill](http://doc.akka.io/docs/akka/2.1.4/java/untyped-actors.html) diff --git a/private-class-data/index.md b/private-class-data/index.md index 4f83a0c32..b90ae654d 100644 --- a/private-class-data/index.md +++ b/private-class-data/index.md @@ -2,6 +2,7 @@ layout: pattern title: Private Class Data folder: private-class-data +permalink: /patterns/private-class-data/ categories: pattern_cat tags: pattern_tag --- @@ -14,4 +15,4 @@ attributes by encapsulating them in single Data object. **Applicability:** Use the Private Class Data pattern when -* you want to prevent write access to class data members \ No newline at end of file +* you want to prevent write access to class data members diff --git a/property/index.md b/property/index.md index 6e92c35f8..4ebb3e74a 100644 --- a/property/index.md +++ b/property/index.md @@ -2,6 +2,7 @@ layout: pattern title: Property folder: property +permalink: /patterns/property/ categories: pattern_cat tags: pattern_tag --- @@ -17,4 +18,4 @@ objects as parents. **Real world examples:** -* [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Inheritance_and_the_prototype_chain) prototype inheritance \ No newline at end of file +* [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Inheritance_and_the_prototype_chain) prototype inheritance diff --git a/prototype/index.md b/prototype/index.md index aeb4b69b0..e0b500188 100644 --- a/prototype/index.md +++ b/prototype/index.md @@ -2,6 +2,7 @@ layout: pattern title: Prototype folder: prototype +permalink: /patterns/prototype/ categories: pattern_cat tags: pattern_tag --- @@ -19,4 +20,4 @@ instance, and create new objects by copying this prototype. **Real world examples:** -* [java.lang.Object#clone()](http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone%28%29) \ No newline at end of file +* [java.lang.Object#clone()](http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#clone%28%29) diff --git a/proxy/index.md b/proxy/index.md index 8f907d563..54d16b37c 100644 --- a/proxy/index.md +++ b/proxy/index.md @@ -2,6 +2,7 @@ layout: pattern title: Proxy folder: proxy +permalink: /patterns/proxy/ categories: pattern_cat tags: pattern_tag --- @@ -30,4 +31,4 @@ are several common situations in which the Proxy pattern is applicable **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/) \ No newline at end of file +* [Apache Commons Proxy](https://commons.apache.org/proper/commons-proxy/) diff --git a/repository/index.md b/repository/index.md index 0fbd39d30..320509f5e 100644 --- a/repository/index.md +++ b/repository/index.md @@ -2,6 +2,7 @@ layout: pattern title: Repository folder: repository +permalink: /patterns/repository/ categories: pattern_cat tags: pattern_tag --- @@ -23,4 +24,4 @@ querying is utilized. **Real world examples:** -* [Spring Data](http://projects.spring.io/spring-data/) \ No newline at end of file +* [Spring Data](http://projects.spring.io/spring-data/) diff --git a/resource-acquisition-is-initialization/index.md b/resource-acquisition-is-initialization/index.md index d5fb509c6..7b283ab8c 100644 --- a/resource-acquisition-is-initialization/index.md +++ b/resource-acquisition-is-initialization/index.md @@ -2,6 +2,7 @@ layout: pattern title: Resource Acquisition Is Initialization folder: resource-acquisition-is-initialization +permalink: /patterns/resource-acquisition-is-initialization/ categories: pattern_cat tags: pattern_tag --- @@ -12,4 +13,4 @@ tags: pattern_tag **Applicability:** Use the Resource Acquisition Is Initialization pattern when -* you have resources that must be closed in every condition \ No newline at end of file +* you have resources that must be closed in every condition diff --git a/servant/index.md b/servant/index.md index ff0339d00..3d2d6ead2 100644 --- a/servant/index.md +++ b/servant/index.md @@ -2,6 +2,7 @@ layout: pattern title: Servant folder: servant +permalink: /patterns/servant/ categories: pattern_cat tags: pattern_tag --- @@ -14,4 +15,4 @@ this behavior in the common parent class - it is defined once in the 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. \ No newline at end of file +* when we want some objects to perform a common action and don't want to define this action as a method in every class. diff --git a/service-layer/index.md b/service-layer/index.md index 0c1a09163..1ce533b37 100644 --- a/service-layer/index.md +++ b/service-layer/index.md @@ -2,6 +2,7 @@ layout: pattern title: Service Layer folder: service-layer +permalink: /patterns/service-layer/ categories: pattern_cat tags: pattern_tag --- @@ -18,4 +19,4 @@ its business logic. The Service Layer fulfills this role. **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 \ No newline at end of file +* you need to implement multiple interfaces with common logic and data diff --git a/service-locator/index.md b/service-locator/index.md index c091b3440..5e002fe67 100644 --- a/service-locator/index.md +++ b/service-locator/index.md @@ -2,6 +2,7 @@ layout: pattern title: Service Locator folder: service-locator +permalink: /patterns/service-locator/ categories: pattern_cat tags: pattern_tag --- @@ -24,4 +25,4 @@ improves the performance of application to great extent. * when network hits are expensive and time consuming * lookups of services are done quite frequently -* large number of services are being used \ No newline at end of file +* large number of services are being used diff --git a/singleton/index.md b/singleton/index.md index a06b4efcc..dad14ecd4 100644 --- a/singleton/index.md +++ b/singleton/index.md @@ -2,6 +2,7 @@ layout: pattern title: Singleton folder: singleton +permalink: /patterns/singleton/ categories: pattern_cat tags: pattern_tag --- @@ -24,4 +25,4 @@ access to it. **Real world examples:** -* [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29) \ No newline at end of file +* [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29) diff --git a/specification/index.md b/specification/index.md index 1ad6cd3f7..9c4d1c2f6 100644 --- a/specification/index.md +++ b/specification/index.md @@ -2,6 +2,7 @@ layout: pattern title: Specification folder: specification +permalink: /patterns/specification/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ order **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) \ No newline at end of file +* you need to check that only suitable objects are used for a certain role (validation) diff --git a/state/index.md b/state/index.md index 8bafb0fe1..5142645fa 100644 --- a/state/index.md +++ b/state/index.md @@ -2,6 +2,7 @@ layout: pattern title: State folder: state +permalink: /patterns/state/ categories: pattern_cat tags: pattern_tag --- @@ -14,4 +15,4 @@ changes. The object will appear to change its class. **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. \ No newline at end of file +* 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. diff --git a/step-builder/index.md b/step-builder/index.md index ce805fe07..5a7a42246 100644 --- a/step-builder/index.md +++ b/step-builder/index.md @@ -2,6 +2,7 @@ layout: pattern title: Step Builder folder: step-builder +permalink: /patterns/step-builder/ categories: pattern_cat tags: pattern_tag --- @@ -11,4 +12,4 @@ The user experience will be much more improved by the fact that he will only see ![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. \ No newline at end of file +**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. diff --git a/strategy/index.md b/strategy/index.md index ecd6623fa..0cc720138 100644 --- a/strategy/index.md +++ b/strategy/index.md @@ -2,6 +2,7 @@ layout: pattern title: Strategy folder: strategy +permalink: /patterns/strategy/ categories: pattern_cat tags: pattern_tag --- @@ -17,4 +18,4 @@ that use it. * 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 \ No newline at end of file +* 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 diff --git a/template-method/index.md b/template-method/index.md index 42f22f46f..ff4c14332 100644 --- a/template-method/index.md +++ b/template-method/index.md @@ -2,6 +2,7 @@ layout: pattern title: Template method folder: template-method +permalink: /patterns/template-method/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ an algorithm without changing the algorithm's structure. * 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 \ No newline at end of file +* to control subclasses extensions. You can define a template method that calls "hook" operations at specific points, thereby permitting extensions only at those points diff --git a/thread-pool/index.md b/thread-pool/index.md index 70ccd2231..107d07850 100644 --- a/thread-pool/index.md +++ b/thread-pool/index.md @@ -2,6 +2,7 @@ layout: pattern title: Thread Pool folder: thread-pool +permalink: /patterns/thread-pool/ categories: pattern_cat tags: pattern_tag --- @@ -16,4 +17,4 @@ and eliminating the latency of creating new threads. **Applicability:** Use the Thread Pool pattern when -* you have a large number of short-lived tasks to be executed in parallel \ No newline at end of file +* you have a large number of short-lived tasks to be executed in parallel diff --git a/tolerant-reader/index.md b/tolerant-reader/index.md index 3c04840b2..f8d4d77df 100644 --- a/tolerant-reader/index.md +++ b/tolerant-reader/index.md @@ -2,6 +2,7 @@ layout: pattern title: Tolerant Reader folder: tolerant-reader +permalink: /patterns/tolerant-reader/ categories: pattern_cat tags: pattern_tag --- @@ -15,4 +16,4 @@ changes, the readers must not break. **Applicability:** Use the Tolerant Reader pattern when -* the communication schema can evolve and change and yet the receiving side should not break \ No newline at end of file +* the communication schema can evolve and change and yet the receiving side should not break diff --git a/visitor/index.md b/visitor/index.md index d263fb80c..6b1516135 100644 --- a/visitor/index.md +++ b/visitor/index.md @@ -2,6 +2,7 @@ layout: pattern title: Visitor folder: visitor +permalink: /patterns/visitor/ categories: pattern_cat tags: pattern_tag --- @@ -20,4 +21,4 @@ of the elements on which it operates. **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) \ No newline at end of file +* [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) From db9a00ebb1a703765ec236fcb04a15f72d64c263 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 15 Aug 2015 19:27:53 +0300 Subject: [PATCH 091/687] #84 Documented the Layers example --- .../main/java/com/iluwatar/layers/App.java | 61 +++++++++++++++++++ .../main/java/com/iluwatar/layers/Cake.java | 5 ++ .../iluwatar/layers/CakeBakingException.java | 7 +++ .../iluwatar/layers/CakeBakingService.java | 30 +++++++++ .../layers/CakeBakingServiceImpl.java | 5 ++ .../java/com/iluwatar/layers/CakeDao.java | 5 ++ .../java/com/iluwatar/layers/CakeInfo.java | 5 ++ .../java/com/iluwatar/layers/CakeLayer.java | 5 ++ .../com/iluwatar/layers/CakeLayerDao.java | 5 ++ .../com/iluwatar/layers/CakeLayerInfo.java | 5 ++ .../java/com/iluwatar/layers/CakeTopping.java | 5 ++ .../com/iluwatar/layers/CakeToppingDao.java | 5 ++ .../com/iluwatar/layers/CakeToppingInfo.java | 5 ++ .../com/iluwatar/layers/CakeViewImpl.java | 5 ++ .../main/java/com/iluwatar/layers/View.java | 5 ++ 15 files changed, 158 insertions(+) diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 5a5bde483..b7407b681 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -2,10 +2,67 @@ package com.iluwatar.layers; import java.util.Arrays; +/** + * + *

+ * Multilayered architecture 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 @@ -16,6 +73,10 @@ public class App { cakeView.render(); } + /** + * Initializes the example data + * @param cakeBakingService + */ private static void initializeData(CakeBakingService cakeBakingService) { cakeBakingService.saveNewLayer(new CakeLayerInfo("chocolate", 1200)); cakeBakingService.saveNewLayer(new CakeLayerInfo("banana", 900)); diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java index 9b395557c..193ba5e3f 100644 --- a/layers/src/main/java/com/iluwatar/layers/Cake.java +++ b/layers/src/main/java/com/iluwatar/layers/Cake.java @@ -11,6 +11,11 @@ import javax.persistence.Id; import javax.persistence.OneToMany; import javax.persistence.OneToOne; +/** + * + * Cake entity + * + */ @Entity public class Cake { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java index 2b131da19..0a44d56f9 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java @@ -1,7 +1,14 @@ package com.iluwatar.layers; +/** + * + * Custom exception used in cake baking + * + */ public class CakeBakingException extends Exception { + private static final long serialVersionUID = 1L; + public CakeBakingException() { } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java index c90b0de91..fec16b494 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java @@ -2,17 +2,47 @@ package com.iluwatar.layers; import java.util.List; +/** + * + * Service for cake baking operations + * + */ public interface CakeBakingService { + /** + * Bakes new cake according to parameters + * @param cakeInfo + * @throws CakeBakingException + */ void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException; + /** + * Get all cakes + * @return + */ List getAllCakes(); + /** + * Store new cake topping + * @param toppingInfo + */ void saveNewTopping(CakeToppingInfo toppingInfo); + /** + * Get available cake toppings + * @return + */ List getAvailableToppings(); + /** + * Add new cake layer + * @param layerInfo + */ void saveNewLayer(CakeLayerInfo layerInfo); + /** + * Get available cake layers + * @return + */ List getAvailableLayers(); } diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java index ff2ad6598..7e5e3dcff 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java @@ -13,6 +13,11 @@ 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 { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeDao.java b/layers/src/main/java/com/iluwatar/layers/CakeDao.java index eb9e2fdaa..075e75d31 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeDao.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeDao.java @@ -3,6 +3,11 @@ 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 { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java index 9487b0064..335ce5f4f 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java @@ -3,6 +3,11 @@ package com.iluwatar.layers; import java.util.List; import java.util.Optional; +/** + * + * DTO for cakes + * + */ public class CakeInfo { public final Optional id; diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java index 255569322..2f8649c18 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java @@ -6,6 +6,11 @@ import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.ManyToOne; +/** + * + * CakeLayer entity + * + */ @Entity public class CakeLayer { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java index c46aafaeb..9e1d035a8 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerDao.java @@ -3,6 +3,11 @@ 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 { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java index c7715b61c..9aa7ff7f6 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java @@ -2,6 +2,11 @@ package com.iluwatar.layers; import java.util.Optional; +/** + * + * DTO for cake layers + * + */ public class CakeLayerInfo { public final Optional id; diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java index 0e9d19192..f0e30997a 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java @@ -6,6 +6,11 @@ import javax.persistence.GeneratedValue; import javax.persistence.Id; import javax.persistence.OneToOne; +/** + * + * CakeTopping entity + * + */ @Entity public class CakeTopping { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java index 81f371750..3ddcf53ec 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingDao.java @@ -3,6 +3,11 @@ 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 { diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java index 316f8ec04..152b0ff85 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java @@ -2,6 +2,11 @@ package com.iluwatar.layers; import java.util.Optional; +/** + * + * DTO for cake toppings + * + */ public class CakeToppingInfo { public final Optional id; diff --git a/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java index a974d0672..5fed15c3a 100644 --- a/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java +++ b/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java @@ -1,5 +1,10 @@ package com.iluwatar.layers; +/** + * + * View implementation for displaying cakes + * + */ public class CakeViewImpl implements View { private CakeBakingService cakeBakingService; diff --git a/layers/src/main/java/com/iluwatar/layers/View.java b/layers/src/main/java/com/iluwatar/layers/View.java index 4e89ca0b7..123d4ecbf 100644 --- a/layers/src/main/java/com/iluwatar/layers/View.java +++ b/layers/src/main/java/com/iluwatar/layers/View.java @@ -1,5 +1,10 @@ package com.iluwatar.layers; +/** + * + * View interface + * + */ public interface View { void render(); From 2bf00fba70b2537b317b983dd2456e70e3c9d54e Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 15 Aug 2015 20:30:54 +0300 Subject: [PATCH 092/687] #84 Added class diagram --- layers/etc/layers.png | Bin 0 -> 97428 bytes layers/etc/layers.ucls | 256 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 256 insertions(+) create mode 100644 layers/etc/layers.png create mode 100644 layers/etc/layers.ucls diff --git a/layers/etc/layers.png b/layers/etc/layers.png new file mode 100644 index 0000000000000000000000000000000000000000..a4bd8b19ddad1cac0134b6fd8aec15d9697039d3 GIT binary patch literal 97428 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

4nMzkVrZ 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%0A7q{J_-UOqLOp3(!|U1qV;lIx<) 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 PE-^e^{an^LB{Ts5#7Ir7 literal 0 HcmV?d00001 diff --git a/layers/etc/layers.ucls b/layers/etc/layers.ucls new file mode 100644 index 000000000..060b391c0 --- /dev/null +++ b/layers/etc/layers.ucls @@ -0,0 +1,256 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file From 61b1c426ef0a955dbaa5997d7df8741858740606 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 15 Aug 2015 21:06:31 +0300 Subject: [PATCH 093/687] #84 Fix merge errors --- layers/pom.xml | 36 +++++++++++++++++++ .../main/resources/META-INF/persistence.xml | 8 +++++ pom.xml | 1 + 3 files changed, 45 insertions(+) create mode 100644 layers/pom.xml create mode 100644 layers/src/main/resources/META-INF/persistence.xml diff --git a/layers/pom.xml b/layers/pom.xml new file mode 100644 index 000000000..dd036e74c --- /dev/null +++ b/layers/pom.xml @@ -0,0 +1,36 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.5.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 + + + diff --git a/layers/src/main/resources/META-INF/persistence.xml b/layers/src/main/resources/META-INF/persistence.xml new file mode 100644 index 000000000..d94d8582b --- /dev/null +++ b/layers/src/main/resources/META-INF/persistence.xml @@ -0,0 +1,8 @@ + + + + + + \ No newline at end of file diff --git a/pom.xml b/pom.xml index 1059edc58..de87da567 100644 --- a/pom.xml +++ b/pom.xml @@ -74,6 +74,7 @@ business-delegate half-sync-half-async step-builder + layers From 39e10d7502df361d085e6605ac2cf7940281475e Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 15 Aug 2015 21:44:08 +0300 Subject: [PATCH 094/687] #84 Added pattern description --- layers/index.md | 19 +++++++++++++++++++ .../main/java/com/iluwatar/layers/App.java | 2 +- 2 files changed, 20 insertions(+), 1 deletion(-) create mode 100644 layers/index.md diff --git a/layers/index.md b/layers/index.md new file mode 100644 index 000000000..d97406672 --- /dev/null +++ b/layers/index.md @@ -0,0 +1,19 @@ +--- +layout: pattern +title: Layers +folder: layers +permalink: /patterns/layers/ +categories: pattern_cat +tags: pattern_tag +--- + +**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 diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index b7407b681..3ab5e211e 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -5,7 +5,7 @@ import java.util.Arrays; /** * *

- * Multilayered architecture is an architectural style where software responsibilities are + * Layers is an architectural style where software responsibilities are * divided among the different layers of the application. *

* From 86b85623f3645b8aa4b594ba97716811af9a2731 Mon Sep 17 00:00:00 2001 From: Markus Date: Sat, 15 Aug 2015 20:50:03 +0200 Subject: [PATCH 095/687] Updated 'How to Contribute' Instructions --- README.md | 48 +++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 45 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a1561b483..0f374e9de 100644 --- a/README.md +++ b/README.md @@ -220,13 +220,55 @@ Flyweight. the issue that you are working on it so that others don't start work on the same thing. 2. Fork the repository. +3. Create a new folder for the pattern. The rough structure of the new folder would be as follows: + * etc (every resource related to the pattern, like diagrams) + * src (the source code of the pattern) + * index.md (the description of the pattern) + * pom.xml (the maven pom.xml) 3. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. -4. Create a simple class diagram from your example code. -5. Add description of the pattern in README.md and link to the class diagram. +4. Create a simple class diagram from your example code and put it inside of the etc folder. +5. Add description of the pattern in index.md and link to the class diagram. + (Attention, all internal links must be relative to the pattern subdirectory, else the links dont link properly on the website) 6. Create a pull request. +**Structure of the index.md file** + +```markdown +--- # this is so called 'Yaml Front Matter', read up on it here: http://jekyllrb.com/docs/frontmatter/ +layout: pattern # layout must allways be pattern +title: Best Pattern Ever # the properly formatted title +folder: best-pattern-ever # the folder name in which this pattern lies +permalink: /patterns/best-pattern-ever/ # the permalink to the pattern, to keep this uniform please stick to /patterns/FOLDER/ + +# both categories and tags are Yaml Lists +# you can either just pick one or write a list with '-'s +# usable categories and tags are listed here: https://github.com/iluwatar/java-design-patterns/blob/gh-pages/_config.yml +categories: creational # categories of the pattern +tags: # tags of the pattern + - best + - ever + - awesome +--- + +**Intent:** Makes your code awesome + +![alt text](./etc/best_pattern.png "Best Pattern Ever") + +**Applicability:** Use the Best Pattern Ever pattern when + +* you want to be the best +* you need to ... + +**Real world examples:** + +* [Nowhere](http://no.where.com) +``` + +**To add a new category or tag** you need to edit the _config.yml file of the gh-pages branch. +In there you should find 2 yaml lists with the respective names 'category-list' and 'tag-list' + **To work on one of the non-pattern issues** you need to do the following steps: 1. Check that the issue has "help wanted" badge @@ -247,7 +289,7 @@ Flyweight. * Microsoft's [Cloud Design Patterns](http://download.microsoft.com/download/B/B/6/BB69622C-AB5D-4D5F-9A12-B81B952C1169/CloudDesignPatternsBook-PDF.pdf) **Links to patterns applied in real world applications** are welcome. The links -should be added to the corresponding section of the `README.md`. +should be added to the corresponding section of the `index.md`. # Versioning [↑](#top) From c438f59c60cdcdac583adc987a5171cc29e32455 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 16 Aug 2015 10:00:17 +0300 Subject: [PATCH 096/687] Update Travis configuration to build all branches --- .travis.yml | 5 ----- 1 file changed, 5 deletions(-) diff --git a/.travis.yml b/.travis.yml index e69a17a4f..af275508b 100644 --- a/.travis.yml +++ b/.travis.yml @@ -3,11 +3,6 @@ language: java jdk: - oraclejdk8 -# whitelist -branches: - only: - - master - before_install: - "export DISPLAY=:99.0" - "sh -e /etc/init.d/xvfb start" From c672fd6ebe971639cf637d3ea1497531c38a1cef Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sun, 16 Aug 2015 13:09:16 +0530 Subject: [PATCH 097/687] Added pattern category to adapter pattern --- adapter/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/adapter/index.md b/adapter/index.md index f1e4043b6..ee94ef47c 100644 --- a/adapter/index.md +++ b/adapter/index.md @@ -3,7 +3,7 @@ layout: pattern title: Adapter folder: adapter permalink: /patterns/adapter/ -categories: pattern_cat +categories: structural tags: pattern_tag --- From adbb4ac4dedf54a13c5d70589c33bcab7d103dad Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sun, 16 Aug 2015 17:07:36 +0530 Subject: [PATCH 098/687] Added categories to all patterns for website --- async-method-invocation/index.md | 2 +- bridge/index.md | 2 +- business-delegate/index.md | 2 +- chain-of-responsibility/index.md | 2 +- command/index.md | 2 +- dao/index.md | 2 +- decorator/index.md | 2 +- dependency-injection/index.md | 2 +- double-checked-locking/index.md | 2 +- event-aggregator/index.md | 2 +- facade/index.md | 2 +- flux/index.md | 2 +- flyweight/index.md | 2 +- front-controller/index.md | 2 +- half-sync-half-async/index.md | 2 +- intercepting-filter/index.md | 2 +- interpreter/index.md | 2 +- iterator/index.md | 2 +- layers/index.md | 2 +- mediator/index.md | 2 +- memento/index.md | 2 +- model-view-controller/index.md | 2 +- model-view-presenter/index.md | 2 +- multiton/index.md | 2 +- naked-objects/index.md | 2 +- null-object/index.md | 2 +- object-pool/index.md | 2 +- observer/index.md | 2 +- property/index.md | 2 +- prototype/index.md | 2 +- proxy/index.md | 2 +- repository/index.md | 2 +- servant/index.md | 2 +- service-layer/index.md | 2 +- service-locator/index.md | 2 +- singleton/index.md | 2 +- specification/index.md | 2 +- state/index.md | 2 +- step-builder/index.md | 2 +- strategy/index.md | 2 +- template-method/index.md | 2 +- thread-pool/index.md | 2 +- tolerant-reader/index.md | 2 +- visitor/index.md | 2 +- 44 files changed, 44 insertions(+), 44 deletions(-) diff --git a/async-method-invocation/index.md b/async-method-invocation/index.md index 0ea60c168..fdc30606e 100644 --- a/async-method-invocation/index.md +++ b/async-method-invocation/index.md @@ -3,7 +3,7 @@ layout: pattern title: Async Method Invocation folder: async-method-invocation permalink: /patterns/async-method-invocation/ -categories: pattern_cat +categories: concurrency tags: pattern_tag --- diff --git a/bridge/index.md b/bridge/index.md index b2319e22e..9983dab40 100644 --- a/bridge/index.md +++ b/bridge/index.md @@ -3,7 +3,7 @@ layout: pattern title: Bridge folder: bridge permalink: /patterns/bridge/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/business-delegate/index.md b/business-delegate/index.md index 37b118e15..af3c2108d 100644 --- a/business-delegate/index.md +++ b/business-delegate/index.md @@ -3,7 +3,7 @@ layout: pattern title: Business Delegate folder: business-delegate permalink: /patterns/business-delegate/ -categories: pattern_cat +categories: business_tier tags: pattern_tag --- diff --git a/chain-of-responsibility/index.md b/chain-of-responsibility/index.md index 3ee2a3c64..0dd250cbd 100644 --- a/chain-of-responsibility/index.md +++ b/chain-of-responsibility/index.md @@ -3,7 +3,7 @@ layout: pattern title: Chain of responsibility folder: chain-of-responsibility permalink: /patterns/chain-of-responsibility/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/command/index.md b/command/index.md index a675a30c7..df512d023 100644 --- a/command/index.md +++ b/command/index.md @@ -3,7 +3,7 @@ layout: pattern title: Command folder: command permalink: /patterns/command/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/dao/index.md b/dao/index.md index 8058f7c7c..de481b3a5 100644 --- a/dao/index.md +++ b/dao/index.md @@ -3,7 +3,7 @@ layout: pattern title: Data Access Object folder: dao permalink: /patterns/dao/ -categories: pattern_cat +categories: architectural tags: pattern_tag --- diff --git a/decorator/index.md b/decorator/index.md index 95ad2dced..0570935ca 100644 --- a/decorator/index.md +++ b/decorator/index.md @@ -3,7 +3,7 @@ layout: pattern title: Decorator folder: decorator permalink: /patterns/decorator/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/dependency-injection/index.md b/dependency-injection/index.md index 3b2853c75..884fdb502 100644 --- a/dependency-injection/index.md +++ b/dependency-injection/index.md @@ -3,7 +3,7 @@ layout: pattern title: Dependency Injection folder: dependency-injection permalink: /patterns/dependency-injection/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/double-checked-locking/index.md b/double-checked-locking/index.md index 92fb22b01..371048b12 100644 --- a/double-checked-locking/index.md +++ b/double-checked-locking/index.md @@ -3,7 +3,7 @@ layout: pattern title: Double Checked Locking folder: double-checked-locking permalink: /patterns/double-checked-locking/ -categories: pattern_cat +categories: concurrency tags: pattern_tag --- diff --git a/event-aggregator/index.md b/event-aggregator/index.md index d4a2395bd..d27d3423e 100644 --- a/event-aggregator/index.md +++ b/event-aggregator/index.md @@ -3,7 +3,7 @@ layout: pattern title: Event Aggregator folder: event-aggregator permalink: /patterns/event-aggregator/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/facade/index.md b/facade/index.md index 7e0d3100a..a2aba225f 100644 --- a/facade/index.md +++ b/facade/index.md @@ -3,7 +3,7 @@ layout: pattern title: Facade folder: facade permalink: /patterns/facade/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/flux/index.md b/flux/index.md index fec262dce..970ef051c 100644 --- a/flux/index.md +++ b/flux/index.md @@ -3,7 +3,7 @@ layout: pattern title: Flux folder: flux permalink: /patterns/flux/ -categories: pattern_cat +categories: presentation_tier tags: pattern_tag --- diff --git a/flyweight/index.md b/flyweight/index.md index a2a4ca575..2a804e769 100644 --- a/flyweight/index.md +++ b/flyweight/index.md @@ -3,7 +3,7 @@ layout: pattern title: Flyweight folder: flyweight permalink: /patterns/flyweight/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/front-controller/index.md b/front-controller/index.md index 221da0404..9c73ddb95 100644 --- a/front-controller/index.md +++ b/front-controller/index.md @@ -3,7 +3,7 @@ layout: pattern title: Front Controller folder: front-controller permalink: /patterns/front-controller/ -categories: pattern_cat +categories: presentation_tier tags: pattern_tag --- diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md index ef3677fce..025ba605f 100644 --- a/half-sync-half-async/index.md +++ b/half-sync-half-async/index.md @@ -3,7 +3,7 @@ layout: pattern title: Half-Sync/Half-Async folder: half-sync-half-async permalink: /patterns/half-sync-half-async/ -categories: pattern_cat +categories: concurrency tags: pattern_tag --- diff --git a/intercepting-filter/index.md b/intercepting-filter/index.md index 6ceb97277..b8fa2a7f6 100644 --- a/intercepting-filter/index.md +++ b/intercepting-filter/index.md @@ -3,7 +3,7 @@ layout: pattern title: Intercepting Filter folder: intercepting-filter permalink: /patterns/intercepting-filter/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/interpreter/index.md b/interpreter/index.md index d1d0babaf..d1ca73955 100644 --- a/interpreter/index.md +++ b/interpreter/index.md @@ -3,7 +3,7 @@ layout: pattern title: Interpreter folder: interpreter permalink: /patterns/interpreter/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/iterator/index.md b/iterator/index.md index d8005cc23..8b185ff83 100644 --- a/iterator/index.md +++ b/iterator/index.md @@ -3,7 +3,7 @@ layout: pattern title: Iterator folder: iterator permalink: /patterns/iterator/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/layers/index.md b/layers/index.md index d97406672..bec7a5f14 100644 --- a/layers/index.md +++ b/layers/index.md @@ -3,7 +3,7 @@ layout: pattern title: Layers folder: layers permalink: /patterns/layers/ -categories: pattern_cat +categories: architectural tags: pattern_tag --- diff --git a/mediator/index.md b/mediator/index.md index ce1119eab..735024298 100644 --- a/mediator/index.md +++ b/mediator/index.md @@ -3,7 +3,7 @@ layout: pattern title: Mediator folder: mediator permalink: /patterns/mediator/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/memento/index.md b/memento/index.md index beb447fc9..99dd9fad4 100644 --- a/memento/index.md +++ b/memento/index.md @@ -3,7 +3,7 @@ layout: pattern title: Memento folder: memento permalink: /patterns/memento/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/model-view-controller/index.md b/model-view-controller/index.md index cb85bad19..f6390225e 100644 --- a/model-view-controller/index.md +++ b/model-view-controller/index.md @@ -3,7 +3,7 @@ layout: pattern title: Model-View-Controller folder: model-view-controller permalink: /patterns/model-view-controller/ -categories: pattern_cat +categories: presentation_tier tags: pattern_tag --- diff --git a/model-view-presenter/index.md b/model-view-presenter/index.md index 35b62a391..d1ba373e3 100644 --- a/model-view-presenter/index.md +++ b/model-view-presenter/index.md @@ -3,7 +3,7 @@ layout: pattern title: Model-View-Presenter folder: model-view-presenter permalink: /patterns/model-view-presenter/ -categories: pattern_cat +categories: presentation_tier tags: pattern_tag --- diff --git a/multiton/index.md b/multiton/index.md index 854d75de3..47b9582b8 100644 --- a/multiton/index.md +++ b/multiton/index.md @@ -3,7 +3,7 @@ layout: pattern title: Multiton folder: multiton permalink: /patterns/multiton/ -categories: pattern_cat +categories: creational tags: pattern_tag --- diff --git a/naked-objects/index.md b/naked-objects/index.md index 160e68add..45f5bec86 100644 --- a/naked-objects/index.md +++ b/naked-objects/index.md @@ -3,7 +3,7 @@ layout: pattern title: Naked Objects folder: naked-objects permalink: /patterns/naked-objects/ -categories: pattern_cat +categories: architectural tags: pattern_tag --- diff --git a/null-object/index.md b/null-object/index.md index 9888eeaf7..c7e89272b 100644 --- a/null-object/index.md +++ b/null-object/index.md @@ -3,7 +3,7 @@ layout: pattern title: Null Object folder: null-object permalink: /patterns/null-object/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/object-pool/index.md b/object-pool/index.md index a812d3fa1..ac08006f7 100644 --- a/object-pool/index.md +++ b/object-pool/index.md @@ -3,7 +3,7 @@ layout: pattern title: Object Pool folder: object-pool permalink: /patterns/object-pool/ -categories: pattern_cat +categories: creational tags: pattern_tag --- diff --git a/observer/index.md b/observer/index.md index ea6de55ae..10036336c 100644 --- a/observer/index.md +++ b/observer/index.md @@ -3,7 +3,7 @@ layout: pattern title: Observer folder: observer permalink: /patterns/observer/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/property/index.md b/property/index.md index 4ebb3e74a..802940f84 100644 --- a/property/index.md +++ b/property/index.md @@ -3,7 +3,7 @@ layout: pattern title: Property folder: property permalink: /patterns/property/ -categories: pattern_cat +categories: creational tags: pattern_tag --- diff --git a/prototype/index.md b/prototype/index.md index e0b500188..7db6e8513 100644 --- a/prototype/index.md +++ b/prototype/index.md @@ -3,7 +3,7 @@ layout: pattern title: Prototype folder: prototype permalink: /patterns/prototype/ -categories: pattern_cat +categories: creational tags: pattern_tag --- diff --git a/proxy/index.md b/proxy/index.md index 54d16b37c..4c29877f6 100644 --- a/proxy/index.md +++ b/proxy/index.md @@ -3,7 +3,7 @@ layout: pattern title: Proxy folder: proxy permalink: /patterns/proxy/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/repository/index.md b/repository/index.md index 320509f5e..3421a2075 100644 --- a/repository/index.md +++ b/repository/index.md @@ -3,7 +3,7 @@ layout: pattern title: Repository folder: repository permalink: /patterns/repository/ -categories: pattern_cat +categories: architectural tags: pattern_tag --- diff --git a/servant/index.md b/servant/index.md index 3d2d6ead2..a4205b9c0 100644 --- a/servant/index.md +++ b/servant/index.md @@ -3,7 +3,7 @@ layout: pattern title: Servant folder: servant permalink: /patterns/servant/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/service-layer/index.md b/service-layer/index.md index 1ce533b37..d041c71ab 100644 --- a/service-layer/index.md +++ b/service-layer/index.md @@ -3,7 +3,7 @@ layout: pattern title: Service Layer folder: service-layer permalink: /patterns/service-layer/ -categories: pattern_cat +categories: architectural tags: pattern_tag --- diff --git a/service-locator/index.md b/service-locator/index.md index 5e002fe67..8bb12c01b 100644 --- a/service-locator/index.md +++ b/service-locator/index.md @@ -3,7 +3,7 @@ layout: pattern title: Service Locator folder: service-locator permalink: /patterns/service-locator/ -categories: pattern_cat +categories: structural tags: pattern_tag --- diff --git a/singleton/index.md b/singleton/index.md index dad14ecd4..b7aed47bb 100644 --- a/singleton/index.md +++ b/singleton/index.md @@ -3,7 +3,7 @@ layout: pattern title: Singleton folder: singleton permalink: /patterns/singleton/ -categories: pattern_cat +categories: creational tags: pattern_tag --- diff --git a/specification/index.md b/specification/index.md index 9c4d1c2f6..81ed15e11 100644 --- a/specification/index.md +++ b/specification/index.md @@ -3,7 +3,7 @@ layout: pattern title: Specification folder: specification permalink: /patterns/specification/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/state/index.md b/state/index.md index 5142645fa..b2e4cc2c7 100644 --- a/state/index.md +++ b/state/index.md @@ -3,7 +3,7 @@ layout: pattern title: State folder: state permalink: /patterns/state/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/step-builder/index.md b/step-builder/index.md index 5a7a42246..f3a7f2413 100644 --- a/step-builder/index.md +++ b/step-builder/index.md @@ -3,7 +3,7 @@ layout: pattern title: Step Builder folder: step-builder permalink: /patterns/step-builder/ -categories: pattern_cat +categories: creational tags: pattern_tag --- diff --git a/strategy/index.md b/strategy/index.md index 0cc720138..0f3dcd144 100644 --- a/strategy/index.md +++ b/strategy/index.md @@ -3,7 +3,7 @@ layout: pattern title: Strategy folder: strategy permalink: /patterns/strategy/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/template-method/index.md b/template-method/index.md index ff4c14332..e0d1ceb14 100644 --- a/template-method/index.md +++ b/template-method/index.md @@ -3,7 +3,7 @@ layout: pattern title: Template method folder: template-method permalink: /patterns/template-method/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- diff --git a/thread-pool/index.md b/thread-pool/index.md index 107d07850..092c8b8a8 100644 --- a/thread-pool/index.md +++ b/thread-pool/index.md @@ -3,7 +3,7 @@ layout: pattern title: Thread Pool folder: thread-pool permalink: /patterns/thread-pool/ -categories: pattern_cat +categories: concurrency tags: pattern_tag --- diff --git a/tolerant-reader/index.md b/tolerant-reader/index.md index f8d4d77df..75fa6ec70 100644 --- a/tolerant-reader/index.md +++ b/tolerant-reader/index.md @@ -3,7 +3,7 @@ layout: pattern title: Tolerant Reader folder: tolerant-reader permalink: /patterns/tolerant-reader/ -categories: pattern_cat +categories: integration tags: pattern_tag --- diff --git a/visitor/index.md b/visitor/index.md index 6b1516135..f9f5c87f8 100644 --- a/visitor/index.md +++ b/visitor/index.md @@ -3,7 +3,7 @@ layout: pattern title: Visitor folder: visitor permalink: /patterns/visitor/ -categories: pattern_cat +categories: behavioral tags: pattern_tag --- From 0d2df990135adab31ffcadd0d08ba4604d72bad2 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 17 Aug 2015 18:34:17 +0300 Subject: [PATCH 099/687] #216 Improve naming in Repository example --- repository/etc/repository.png | Bin 8827 -> 9683 bytes repository/etc/repository.ucls | 6 +++--- .../java/com/iluwatar/repository/App.java | 20 +++++++++--------- .../{PersonDao.java => PersonRepository.java} | 2 +- 4 files changed, 14 insertions(+), 14 deletions(-) rename repository/src/main/java/com/iluwatar/repository/{PersonDao.java => PersonRepository.java} (78%) diff --git a/repository/etc/repository.png b/repository/etc/repository.png index 76adc34c4bb9ba8fcdf95f39c017f9499a3b8e0b..1e031f3ae327d8dd20c46ea0b0fa69a0333efc27 100644 GIT binary patch literal 9683 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 diff --git a/repository/etc/repository.ucls b/repository/etc/repository.ucls index 6fcdb4e31..6c42019e1 100644 --- a/repository/etc/repository.ucls +++ b/repository/etc/repository.ucls @@ -3,15 +3,15 @@ realizations="true" associations="true" dependencies="false" nesting-relationships="true"> - + - + diff --git a/repository/src/main/java/com/iluwatar/repository/App.java b/repository/src/main/java/com/iluwatar/repository/App.java index 8dd568d51..3e4d46d00 100644 --- a/repository/src/main/java/com/iluwatar/repository/App.java +++ b/repository/src/main/java/com/iluwatar/repository/App.java @@ -24,39 +24,39 @@ public class App { public static void main(String[] args) { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( "applicationContext.xml"); - PersonDao dao = context.getBean(PersonDao.class); + PersonRepository repository = context.getBean(PersonRepository.class); Person peter = new Person("Peter", "Sagan"); Person nasta = new Person("Nasta", "Kuzminova"); // Add new Person records - dao.save(peter); - dao.save(nasta); + repository.save(peter); + repository.save(nasta); // Count Person records - System.out.println("Count Person records: " + dao.count()); + System.out.println("Count Person records: " + repository.count()); // Print all records - List persons = (List) dao.findAll(); + List persons = (List) repository.findAll(); for (Person person : persons) { System.out.println(person); } // Find Person by surname - System.out.println("Find by surname 'Sagan': " + dao.findBySurname("Sagan")); + System.out.println("Find by surname 'Sagan': " + repository.findBySurname("Sagan")); // Update Person nasta.setName("Barbora"); nasta.setSurname("Spotakova"); - dao.save(nasta); + repository.save(nasta); - System.out.println("Find by id 2: " + dao.findOne(2L)); + System.out.println("Find by id 2: " + repository.findOne(2L)); // Remove record from Person - dao.delete(2L); + repository.delete(2L); // And finally count records - System.out.println("Count Person records: " + dao.count()); + System.out.println("Count Person records: " + repository.count()); context.close(); } diff --git a/repository/src/main/java/com/iluwatar/repository/PersonDao.java b/repository/src/main/java/com/iluwatar/repository/PersonRepository.java similarity index 78% rename from repository/src/main/java/com/iluwatar/repository/PersonDao.java rename to repository/src/main/java/com/iluwatar/repository/PersonRepository.java index bb8ba854b..fd20bc94c 100644 --- a/repository/src/main/java/com/iluwatar/repository/PersonDao.java +++ b/repository/src/main/java/com/iluwatar/repository/PersonRepository.java @@ -11,7 +11,7 @@ import org.springframework.stereotype.Repository; * */ @Repository -public interface PersonDao extends CrudRepository { +public interface PersonRepository extends CrudRepository { public List findBySurname(String surname); } From fd85a2f848f02ac103efd670ef4c62774533e1a1 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 17 Aug 2015 23:06:44 +0300 Subject: [PATCH 100/687] #107 JavaDoc improvements for Abstract Factory example --- .../com/iluwatar/abstractfactory/App.java | 66 +++++++++++-------- .../com/iluwatar/abstractfactory/Army.java | 15 +++-- .../com/iluwatar/abstractfactory/Castle.java | 15 +++-- .../com/iluwatar/abstractfactory/ElfArmy.java | 25 ++++--- .../iluwatar/abstractfactory/ElfCastle.java | 25 ++++--- .../com/iluwatar/abstractfactory/ElfKing.java | 25 ++++--- .../abstractfactory/ElfKingdomFactory.java | 44 ++++++------- .../com/iluwatar/abstractfactory/King.java | 15 +++-- .../abstractfactory/KingdomFactory.java | 32 ++++----- .../com/iluwatar/abstractfactory/OrcArmy.java | 25 ++++--- .../iluwatar/abstractfactory/OrcCastle.java | 25 ++++--- .../com/iluwatar/abstractfactory/OrcKing.java | 25 ++++--- .../abstractfactory/OrcKingdomFactory.java | 44 ++++++------- 13 files changed, 217 insertions(+), 164 deletions(-) diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java index 3f77a521c..d18f1abed 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java @@ -1,29 +1,37 @@ -package com.iluwatar.abstractfactory; - -/** - * - * The essence of the Abstract Factory pattern is a factory interface - * (KingdomFactory) and its implementations (ElfKingdomFactory, - * OrcKingdomFactory). - * - * The example uses both concrete implementations to create a king, a castle and - * an army. - * - */ -public class App { - - public static void main(String[] args) { - createKingdom(new ElfKingdomFactory()); - createKingdom(new OrcKingdomFactory()); - } - - public static void createKingdom(KingdomFactory factory) { - King king = factory.createKing(); - Castle castle = factory.createCastle(); - Army army = factory.createArmy(); - System.out.println("The kingdom was created."); - System.out.println(king); - System.out.println(castle); - System.out.println(army); - } -} +package com.iluwatar.abstractfactory; + +/** + * + * 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 { + + /** + * Program entry point + * @param args command line arguments + */ + public static void main(String[] args) { + createKingdom(new ElfKingdomFactory()); + createKingdom(new OrcKingdomFactory()); + } + + /** + * Creates kingdom + * @param factory + */ + public static void createKingdom(KingdomFactory factory) { + King king = factory.createKing(); + Castle castle = factory.createCastle(); + Army army = factory.createArmy(); + System.out.println("The kingdom was created."); + System.out.println(king); + System.out.println(castle); + System.out.println(army); + } +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java index 39e023e3b..225331517 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java @@ -1,5 +1,10 @@ -package com.iluwatar.abstractfactory; - -public interface Army { - -} +package com.iluwatar.abstractfactory; + +/** + * + * Army interface + * + */ +public interface Army { + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java index 277daea56..272a97bf3 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java @@ -1,5 +1,10 @@ -package com.iluwatar.abstractfactory; - -public interface Castle { - -} +package com.iluwatar.abstractfactory; + +/** + * + * Castle interface + * + */ +public interface Castle { + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java index 473106222..d77fe8ebd 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java @@ -1,10 +1,15 @@ -package com.iluwatar.abstractfactory; - -public class ElfArmy implements Army { - - @Override - public String toString() { - return "This is the Elven Army!"; - } - -} +package com.iluwatar.abstractfactory; + +/** + * + * ElfArmy + * + */ +public class ElfArmy implements Army { + + @Override + public String toString() { + return "This is the Elven Army!"; + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java index 851baf84f..5c2b2a62a 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java @@ -1,10 +1,15 @@ -package com.iluwatar.abstractfactory; - -public class ElfCastle implements Castle { - - @Override - public String toString() { - return "This is the Elven castle!"; - } - -} +package com.iluwatar.abstractfactory; + +/** + * + * ElfCastle + * + */ +public class ElfCastle implements Castle { + + @Override + public String toString() { + return "This is the Elven castle!"; + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java index eafaccf49..df475a354 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java @@ -1,10 +1,15 @@ -package com.iluwatar.abstractfactory; - -public class ElfKing implements King { - - @Override - public String toString() { - return "This is the Elven king!"; - } - -} +package com.iluwatar.abstractfactory; + +/** + * + * ElfKing + * + */ +public class ElfKing implements King { + + @Override + public String toString() { + return "This is the Elven king!"; + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java index eb4b99685..0d62fa5f2 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java @@ -1,22 +1,22 @@ -package com.iluwatar.abstractfactory; - -/** - * - * 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(); - } - -} +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(); + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java index 12a9c1f13..0b75dbb0a 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java @@ -1,5 +1,10 @@ -package com.iluwatar.abstractfactory; - -public interface King { - -} +package com.iluwatar.abstractfactory; + +/** + * + * King interface + * + */ +public interface King { + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java index e5b4b4050..00bcd1755 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java @@ -1,16 +1,16 @@ -package com.iluwatar.abstractfactory; - -/** - * - * The factory interface. - * - */ -public interface KingdomFactory { - - Castle createCastle(); - - King createKing(); - - Army createArmy(); - -} +package com.iluwatar.abstractfactory; + +/** + * + * KingdomFactory factory interface. + * + */ +public interface KingdomFactory { + + Castle createCastle(); + + King createKing(); + + Army createArmy(); + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java index b0e202d51..d331252dc 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java @@ -1,10 +1,15 @@ -package com.iluwatar.abstractfactory; - -public class OrcArmy implements Army { - - @Override - public String toString() { - return "This is the Orcish Army!"; - } - -} +package com.iluwatar.abstractfactory; + +/** + * + * OrcArmy + * + */ +public class OrcArmy implements Army { + + @Override + public String toString() { + return "This is the Orcish Army!"; + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java index 785884a59..fd09d9c17 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java @@ -1,10 +1,15 @@ -package com.iluwatar.abstractfactory; - -public class OrcCastle implements Castle { - - @Override - public String toString() { - return "This is the Orcish castle!"; - } - -} +package com.iluwatar.abstractfactory; + +/** + * + * OrcCastle + * + */ +public class OrcCastle implements Castle { + + @Override + public String toString() { + return "This is the Orcish castle!"; + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java index 27ea8afd4..5bae8f31b 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java @@ -1,10 +1,15 @@ -package com.iluwatar.abstractfactory; - -public class OrcKing implements King { - - @Override - public String toString() { - return "This is the Orc king!"; - } - -} +package com.iluwatar.abstractfactory; + +/** + * + * OrcKing + * + */ +public class OrcKing implements King { + + @Override + public String toString() { + return "This is the Orc king!"; + } + +} diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java index 2f2a2a54d..4fdea6656 100644 --- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java +++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java @@ -1,22 +1,22 @@ -package com.iluwatar.abstractfactory; - -/** - * - * 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(); - } - -} +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(); + } + +} From ef6a34ef7476035e9ffb42fd5f40314b1df4e871 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 17 Aug 2015 23:11:15 +0300 Subject: [PATCH 101/687] #107 JavaDoc improvements for the Adapter example --- .../main/java/com/iluwatar/adapter/App.java | 46 ++++++++++-------- .../com/iluwatar/adapter/GnomeEngineer.java | 48 +++++++++---------- .../adapter/GnomeEngineeringManager.java | 40 ++++++++-------- 3 files changed, 69 insertions(+), 65 deletions(-) diff --git a/adapter/src/main/java/com/iluwatar/adapter/App.java b/adapter/src/main/java/com/iluwatar/adapter/App.java index 43a93fa44..3d10a4d41 100644 --- a/adapter/src/main/java/com/iluwatar/adapter/App.java +++ b/adapter/src/main/java/com/iluwatar/adapter/App.java @@ -1,21 +1,25 @@ -package com.iluwatar.adapter; - -/** - * - * 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 (GnomeEngineer) converts the interface of the target class - * (GoblinGlider) into a suitable one expected by the client - * (GnomeEngineeringManager). - * - */ -public class App { - - public static void main(String[] args) { - Engineer manager = new GnomeEngineeringManager(); - manager.operateDevice(); - } -} +package com.iluwatar.adapter; + +/** + * + * 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 GnomeEngineer}) converts the interface of the target class + * ({@link GoblinGlider}) into a suitable one expected by the client + * ({@link GnomeEngineeringManager}). + * + */ +public class App { + + /** + * Program entry point + * @param args command line args + */ + public static void main(String[] args) { + Engineer manager = new GnomeEngineeringManager(); + manager.operateDevice(); + } +} diff --git a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java index 62fab599f..35cbc9573 100644 --- a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java +++ b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java @@ -1,24 +1,24 @@ -package com.iluwatar.adapter; - -/** - * - * Adapter class. Adapts the interface of the device (GoblinGlider) into - * Engineer interface expected by the client (GnomeEngineeringManager). - * - */ -public class GnomeEngineer implements Engineer { - - private GoblinGlider glider; - - public GnomeEngineer() { - glider = new GoblinGlider(); - } - - @Override - public void operateDevice() { - glider.attachGlider(); - glider.gainSpeed(); - glider.takeOff(); - } - -} +package com.iluwatar.adapter; + +/** + * + * Adapter class. Adapts the interface of the device ({@link GoblinGlider}) into + * {@link Engineer} interface expected by the client ({@link GnomeEngineeringManager}). + * + */ +public class GnomeEngineer implements Engineer { + + private GoblinGlider glider; + + public GnomeEngineer() { + glider = new GoblinGlider(); + } + + @Override + public void operateDevice() { + glider.attachGlider(); + glider.gainSpeed(); + glider.takeOff(); + } + +} diff --git a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java index 6d0010d74..d95065b88 100644 --- a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java +++ b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java @@ -1,20 +1,20 @@ -package com.iluwatar.adapter; - -/** - * - * GnomeEngineering manager uses Engineer to operate devices. - * - */ -public class GnomeEngineeringManager implements Engineer { - - private Engineer engineer; - - public GnomeEngineeringManager() { - engineer = new GnomeEngineer(); - } - - @Override - public void operateDevice() { - engineer.operateDevice(); - } -} +package com.iluwatar.adapter; + +/** + * + * GnomeEngineering manager uses {@link Engineer} to operate devices. + * + */ +public class GnomeEngineeringManager implements Engineer { + + private Engineer engineer; + + public GnomeEngineeringManager() { + engineer = new GnomeEngineer(); + } + + @Override + public void operateDevice() { + engineer.operateDevice(); + } +} From 8d621566833dec09f053f43d9e68072dee113b15 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:11:39 +0300 Subject: [PATCH 102/687] #107 JavaDoc improvements for Async Method Invocation example --- .../java/com/iluwatar/async/method/invocation/App.java | 5 ----- .../iluwatar/async/method/invocation/AsyncCallback.java | 7 +++++++ .../iluwatar/async/method/invocation/AsyncExecutor.java | 5 +++++ .../com/iluwatar/async/method/invocation/AsyncResult.java | 6 ++++++ .../async/method/invocation/ThreadAsyncExecutor.java | 2 ++ 5 files changed, 20 insertions(+), 5 deletions(-) diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java index de4dfe926..688d8482f 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java @@ -3,29 +3,24 @@ package com.iluwatar.async.method.invocation; 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 diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java index 067b79d43..46556a48e 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java @@ -2,6 +2,13 @@ package com.iluwatar.async.method.invocation; import java.util.Optional; +/** + * + * AsyncCallback interface + * + * @param + * + */ public interface AsyncCallback { /** diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java index 4bf837a4f..5c5098487 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java @@ -3,6 +3,11 @@ package com.iluwatar.async.method.invocation; import java.util.concurrent.Callable; import java.util.concurrent.ExecutionException; +/** + * + * AsyncExecutor interface + * + */ public interface AsyncExecutor { /** diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java index 689095e9d..405bec251 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java @@ -2,6 +2,12 @@ package com.iluwatar.async.method.invocation; import java.util.concurrent.ExecutionException; +/** + * + * AsyncResult interface + * + * @param + */ public interface AsyncResult { /** diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java index 18b27c3b6..a3ed51af3 100644 --- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java +++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java @@ -6,7 +6,9 @@ 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 { From 7d2e9fa1b401bc6ad64b9b41d85a90c6eb719ef3 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:25:47 +0300 Subject: [PATCH 103/687] #107 JavaDoc improvements and minor fixes to Bridge example --- bridge/etc/bridge.png | Bin 48735 -> 53487 bytes bridge/etc/bridge.ucls | 88 +++++++++--------- bridge/etc/bridge_1.png | Bin 86628 -> 0 bytes bridge/index.md | 2 +- .../main/java/com/iluwatar/bridge/App.java | 74 ++++++++------- .../iluwatar/bridge/BlindingMagicWeapon.java | 71 +++++++------- .../bridge/BlindingMagicWeaponImp.java | 7 -- .../bridge/BlindingMagicWeaponImpl.java | 12 +++ .../java/com/iluwatar/bridge/Excalibur.java | 57 ++++++------ .../iluwatar/bridge/FlyingMagicWeapon.java | 69 +++++++------- .../iluwatar/bridge/FlyingMagicWeaponImp.java | 7 -- .../bridge/FlyingMagicWeaponImpl.java | 12 +++ .../java/com/iluwatar/bridge/MagicWeapon.java | 52 +++++------ ...gicWeaponImp.java => MagicWeaponImpl.java} | 32 +++---- .../java/com/iluwatar/bridge/Mjollnir.java | 57 ++++++------ .../bridge/SoulEatingMagicWeapon.java | 71 +++++++------- .../bridge/SoulEatingMagicWeaponImp.java | 7 -- .../bridge/SoulEatingMagicWeaponImpl.java | 12 +++ .../com/iluwatar/bridge/Stormbringer.java | 55 ++++++----- 19 files changed, 369 insertions(+), 316 deletions(-) delete mode 100644 bridge/etc/bridge_1.png delete mode 100644 bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImp.java create mode 100644 bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java delete mode 100644 bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImp.java create mode 100644 bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java rename bridge/src/main/java/com/iluwatar/bridge/{MagicWeaponImp.java => MagicWeaponImpl.java} (65%) delete mode 100644 bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImp.java create mode 100644 bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java diff --git a/bridge/etc/bridge.png b/bridge/etc/bridge.png index 472fe51e74f5866c2a3c7bf02cca6961aafd7340..00d3e611c1f72e1b3411c3c5b327f81a49f3a78e 100644 GIT binary patch literal 53487 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 Sl~`f)|MIdbw@Rc<9{(RdGq(Q# literal 48735 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 H-|PPX)W;k0 diff --git a/bridge/etc/bridge.ucls b/bridge/etc/bridge.ucls index 86455e7fb..2eda6e1d1 100644 --- a/bridge/etc/bridge.ucls +++ b/bridge/etc/bridge.ucls @@ -1,18 +1,18 @@ - - + + - - + + @@ -21,25 +21,25 @@ - + - - + + - - + + @@ -48,7 +48,7 @@ - + @@ -57,7 +57,7 @@ - + @@ -66,7 +66,7 @@ - + @@ -75,7 +75,7 @@ - + @@ -84,7 +84,7 @@ - + @@ -93,7 +93,7 @@ - + @@ -101,48 +101,52 @@ - - + + - - - - - - - - - - - - - - - + + + - + - - + + + + + + - + + + + + + + + + + + + + - - + + diff --git a/bridge/etc/bridge_1.png b/bridge/etc/bridge_1.png deleted file mode 100644 index 3152efdf66515ce1c87876aa90f49738545cd434..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 86628 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
Ltcz$O@bXxUqR$i z8kL*g7VgVmVz$s?>5+4K99Z0h?p2C}X~i$}o#z#$r2HK+(a{ry&bF~H7syKDL}bvx z`wESI8mvrdtrQ&AyyqfP-ssT_suqlT*sAQVYD?HXspXqHp~u374p{2g!gGWTMTAnV ztH$1@6R$CKm!)VZL=M_aHE_M`M=56|9xkt{%~k;#ZsJXWRkwI4drK^Jdgafus;;gK zdZ&t6Bt%UxdLTkLS)@2Km_Y$?cLc&&$q!e32{kcBaO%i=!4qAFHa|35;%=4YLPVzq zACEA@@zIz$UWsUWE6J<<0rIk~V%>4;IyfW#Liwv|gK@CT8}5HsAV?h*PF&y7&N6j& zzk>}}XZ2kTVp~kt!sn@K1w+nyAG(mOzY4YdWxP5|v+%nck8be!;!5JqG4D`0=>0aR zE)iY0QnuFdRK%mCL?i4`*$R;v+gLE!p*Vw54RhUF{z}^;-b+2EIcT>)wnRLl*IrF! zZ?T|yk&F+D1q9r}Vy9rxp|3es#te?o7Au$*x}mW$Q%EEl33wSE9_gtDOul6@Lr-PdhBGIC8Xh}1z=MbptvH_)7xHR|cZdJ2m z)c?Ps7b7p6ML^&rH&=6+`?Pzp#^&c7=L@|D~7f z;Paw=mY#U2RwTI)StccDFF4s3V!F=~Cenw&D2l4XX;Scu=8 zJ&@k8oJ&kcwwro~bKarW2&3ZVvq3_cFjBYCMG0Vh_eI6@sz0Ws*Xc6k<#&)a`%>wQ zv0#D>p`#gF>C*d1>VBMCXi^2;sY*!o|4*`i3mqMu)0SaJ_ys=)U>B72Pt34~3H8%) adJ4bRG-m6KyqxpM7up&p)w5Nt{QnDk0_k-C diff --git a/bridge/index.md b/bridge/index.md index 9983dab40..fef4e1789 100644 --- a/bridge/index.md +++ b/bridge/index.md @@ -11,7 +11,7 @@ tags: pattern_tag vary independently. -![alt text](./etc/bridge_1.png "Bridge") +![alt text](./etc/bridge.png "Bridge") **Applicability:** Use the Bridge pattern when diff --git a/bridge/src/main/java/com/iluwatar/bridge/App.java b/bridge/src/main/java/com/iluwatar/bridge/App.java index 3797653d4..e8774caea 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/App.java +++ b/bridge/src/main/java/com/iluwatar/bridge/App.java @@ -1,35 +1,39 @@ -package com.iluwatar.bridge; - -/** - * - * In Bridge pattern both abstraction (MagicWeapon) and implementation - * (MagicWeaponImp) have their own class hierarchies. The interface of the - * implementations can be changed without affecting the clients. - * - */ -public class App { - - 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(); - - } -} +package com.iluwatar.bridge; + +/** + * + * 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(); + + } +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java index 5421c6d5e..bf4bac8f9 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java +++ b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java @@ -1,33 +1,38 @@ -package com.iluwatar.bridge; - -public class BlindingMagicWeapon extends MagicWeapon { - - public BlindingMagicWeapon(BlindingMagicWeaponImp imp) { - super(imp); - } - - @Override - public BlindingMagicWeaponImp getImp() { - return (BlindingMagicWeaponImp) imp; - } - - @Override - public void wield() { - getImp().wieldImp(); - } - - @Override - public void swing() { - getImp().swingImp(); - } - - @Override - public void unwield() { - getImp().unwieldImp(); - } - - public void blind() { - getImp().blindImp(); - } - -} +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(); + } + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImp.java b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImp.java deleted file mode 100644 index 0686ce917..000000000 --- a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImp.java +++ /dev/null @@ -1,7 +0,0 @@ -package com.iluwatar.bridge; - -public abstract class BlindingMagicWeaponImp extends MagicWeaponImp { - - public abstract void blindImp(); - -} diff --git a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java new file mode 100644 index 000000000..31dffb042 --- /dev/null +++ b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java @@ -0,0 +1,12 @@ +package com.iluwatar.bridge; + +/** + * + * BlindingMagicWeaponImpl + * + */ +public abstract class BlindingMagicWeaponImpl extends MagicWeaponImpl { + + public abstract void blindImp(); + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java b/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java index 52298c900..9f7078139 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java +++ b/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java @@ -1,26 +1,31 @@ -package com.iluwatar.bridge; - -public class Excalibur extends BlindingMagicWeaponImp { - - @Override - public void wieldImp() { - System.out.println("wielding Excalibur"); - } - - @Override - public void swingImp() { - System.out.println("swinging Excalibur"); - } - - @Override - public void unwieldImp() { - System.out.println("unwielding Excalibur"); - } - - @Override - public void blindImp() { - System.out - .println("bright light streams from Excalibur blinding the enemy"); - } - -} +package com.iluwatar.bridge; + +/** + * + * Excalibur + * + */ +public class Excalibur extends BlindingMagicWeaponImpl { + + @Override + public void wieldImp() { + System.out.println("wielding Excalibur"); + } + + @Override + public void swingImp() { + System.out.println("swinging Excalibur"); + } + + @Override + public void unwieldImp() { + System.out.println("unwielding Excalibur"); + } + + @Override + public void blindImp() { + System.out + .println("bright light streams from Excalibur blinding the enemy"); + } + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java index 9cb1902f9..542e7d97e 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java +++ b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java @@ -1,32 +1,37 @@ -package com.iluwatar.bridge; - -public class FlyingMagicWeapon extends MagicWeapon { - - public FlyingMagicWeapon(FlyingMagicWeaponImp imp) { - super(imp); - } - - public FlyingMagicWeaponImp getImp() { - return (FlyingMagicWeaponImp) imp; - } - - @Override - public void wield() { - getImp().wieldImp(); - } - - @Override - public void swing() { - getImp().swingImp(); - } - - @Override - public void unwield() { - getImp().unwieldImp(); - } - - public void fly() { - getImp().flyImp(); - } - -} +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(); + } + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImp.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImp.java deleted file mode 100644 index 37fa8a0f9..000000000 --- a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImp.java +++ /dev/null @@ -1,7 +0,0 @@ -package com.iluwatar.bridge; - -public abstract class FlyingMagicWeaponImp extends MagicWeaponImp { - - public abstract void flyImp(); - -} diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java new file mode 100644 index 000000000..8b7a10f2f --- /dev/null +++ b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java @@ -0,0 +1,12 @@ +package com.iluwatar.bridge; + +/** + * + * FlyingMagicWeaponImpl + * + */ +public abstract class FlyingMagicWeaponImpl extends MagicWeaponImpl { + + public abstract void flyImp(); + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java index b03435c51..b2b82839c 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java +++ b/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java @@ -1,26 +1,26 @@ -package com.iluwatar.bridge; - -/** - * - * Abstraction interface. - * - */ -public abstract class MagicWeapon { - - protected MagicWeaponImp imp; - - public MagicWeapon(MagicWeaponImp imp) { - this.imp = imp; - } - - public abstract void wield(); - - public abstract void swing(); - - public abstract void unwield(); - - public MagicWeaponImp getImp() { - return imp; - } - -} +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; + } + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImp.java b/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java similarity index 65% rename from bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImp.java rename to bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java index cf972c115..bd2a3b8d7 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImp.java +++ b/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java @@ -1,16 +1,16 @@ -package com.iluwatar.bridge; - -/** - * - * Implementation interface. - * - */ -public abstract class MagicWeaponImp { - - public abstract void wieldImp(); - - public abstract void swingImp(); - - public abstract void unwieldImp(); - -} +package com.iluwatar.bridge; + +/** + * + * MagicWeaponImpl + * + */ +public abstract class MagicWeaponImpl { + + public abstract void wieldImp(); + + public abstract void swingImp(); + + public abstract void unwieldImp(); + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java b/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java index 0c21f8d07..887173add 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java +++ b/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java @@ -1,26 +1,31 @@ -package com.iluwatar.bridge; - -public class Mjollnir extends FlyingMagicWeaponImp { - - @Override - public void wieldImp() { - System.out.println("wielding Mjollnir"); - } - - @Override - public void swingImp() { - System.out.println("swinging Mjollnir"); - } - - @Override - public void unwieldImp() { - System.out.println("unwielding Mjollnir"); - } - - @Override - public void flyImp() { - System.out - .println("Mjollnir hits the enemy in the air and returns back to the owner's hand"); - } - -} +package com.iluwatar.bridge; + +/** + * + * Mjollnir + * + */ +public class Mjollnir extends FlyingMagicWeaponImpl { + + @Override + public void wieldImp() { + System.out.println("wielding Mjollnir"); + } + + @Override + public void swingImp() { + System.out.println("swinging Mjollnir"); + } + + @Override + public void unwieldImp() { + System.out.println("unwielding Mjollnir"); + } + + @Override + public void flyImp() { + System.out + .println("Mjollnir hits the enemy in the air and returns back to the owner's hand"); + } + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java index dbbec102d..3310b6488 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java +++ b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java @@ -1,33 +1,38 @@ -package com.iluwatar.bridge; - -public class SoulEatingMagicWeapon extends MagicWeapon { - - public SoulEatingMagicWeapon(SoulEatingMagicWeaponImp imp) { - super(imp); - } - - @Override - public SoulEatingMagicWeaponImp getImp() { - return (SoulEatingMagicWeaponImp) imp; - } - - @Override - public void wield() { - getImp().wieldImp(); - } - - @Override - public void swing() { - getImp().swingImp(); - } - - @Override - public void unwield() { - getImp().unwieldImp(); - } - - public void eatSoul() { - getImp().eatSoulImp(); - } - -} +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(); + } + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImp.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImp.java deleted file mode 100644 index 3c1a557dd..000000000 --- a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImp.java +++ /dev/null @@ -1,7 +0,0 @@ -package com.iluwatar.bridge; - -public abstract class SoulEatingMagicWeaponImp extends MagicWeaponImp { - - public abstract void eatSoulImp(); - -} diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java new file mode 100644 index 000000000..9ec112031 --- /dev/null +++ b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java @@ -0,0 +1,12 @@ +package com.iluwatar.bridge; + +/** + * + * SoulEatingMagicWeaponImpl + * + */ +public abstract class SoulEatingMagicWeaponImpl extends MagicWeaponImpl { + + public abstract void eatSoulImp(); + +} diff --git a/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java b/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java index 55b5960c9..589156fe3 100644 --- a/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java +++ b/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java @@ -1,25 +1,30 @@ -package com.iluwatar.bridge; - -public class Stormbringer extends SoulEatingMagicWeaponImp { - - @Override - public void wieldImp() { - System.out.println("wielding Stormbringer"); - } - - @Override - public void swingImp() { - System.out.println("swinging Stormbringer"); - } - - @Override - public void unwieldImp() { - System.out.println("unwielding Stormbringer"); - } - - @Override - public void eatSoulImp() { - System.out.println("Stormbringer devours the enemy's soul"); - } - -} +package com.iluwatar.bridge; + +/** + * + * Stormbringer + * + */ +public class Stormbringer extends SoulEatingMagicWeaponImpl { + + @Override + public void wieldImp() { + System.out.println("wielding Stormbringer"); + } + + @Override + public void swingImp() { + System.out.println("swinging Stormbringer"); + } + + @Override + public void unwieldImp() { + System.out.println("unwielding Stormbringer"); + } + + @Override + public void eatSoulImp() { + System.out.println("Stormbringer devours the enemy's soul"); + } + +} From 1dc2d8d0c779c6ba29594d1de3ac8c6e079ff477 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:28:23 +0300 Subject: [PATCH 104/687] #107 JavaDoc improvements --- .../com/iluwatar/abstractfactory/AppTest.java | 31 +++++++++-------- .../java/com/iluwatar/adapter/AppTest.java | 33 +++++++++++-------- .../async/method/invocation/AppTest.java | 5 +++ .../java/com/iluwatar/bridge/AppTest.java | 33 +++++++++++-------- 4 files changed, 61 insertions(+), 41 deletions(-) diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java index 0241ed8ce..91db0a4be 100644 --- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java +++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java @@ -1,13 +1,18 @@ -package com.iluwatar.abstractfactory; -import org.junit.Test; - -import com.iluwatar.abstractfactory.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.abstractfactory; +import org.junit.Test; + +import com.iluwatar.abstractfactory.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java index cd9d713b0..3d877815a 100644 --- a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java +++ b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.adapter; - -import org.junit.Test; - -import com.iluwatar.adapter.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.adapter; + +import org.junit.Test; + +import com.iluwatar.adapter.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java index 989fa6d1d..5faec5356 100644 --- a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java +++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java @@ -2,6 +2,11 @@ package com.iluwatar.async.method.invocation; import org.junit.Test; +/** + * + * Application test + * + */ public class AppTest { @Test diff --git a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java index 196008950..b53111c8e 100644 --- a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java +++ b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.bridge; - -import org.junit.Test; - -import com.iluwatar.bridge.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.bridge; + +import org.junit.Test; + +import com.iluwatar.bridge.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 81dda94abd2994a3d9ce19a6d3e1b804b2c7cb6a Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:37:07 +0300 Subject: [PATCH 105/687] #107 JavaDoc improvements for the Builder example --- .../main/java/com/iluwatar/builder/App.java | 80 ++++++++++--------- .../main/java/com/iluwatar/builder/Armor.java | 39 +++++---- .../java/com/iluwatar/builder/HairColor.java | 29 ++++--- .../java/com/iluwatar/builder/HairType.java | 39 +++++---- .../main/java/com/iluwatar/builder/Hero.java | 2 +- .../java/com/iluwatar/builder/Profession.java | 29 ++++--- .../java/com/iluwatar/builder/Weapon.java | 29 ++++--- .../java/com/iluwatar/builder/AppTest.java | 33 ++++---- 8 files changed, 157 insertions(+), 123 deletions(-) diff --git a/builder/src/main/java/com/iluwatar/builder/App.java b/builder/src/main/java/com/iluwatar/builder/App.java index e38e5a0c3..bcdbb8821 100644 --- a/builder/src/main/java/com/iluwatar/builder/App.java +++ b/builder/src/main/java/com/iluwatar/builder/App.java @@ -1,38 +1,42 @@ -package com.iluwatar.builder; - -import com.iluwatar. builder.Hero.HeroBuilder; - -/** - * - * This is the Builder pattern variation as described by Joshua Bloch in - * Effective Java 2nd Edition. - * - * We want to build Hero objects, but its construction is complex because of the - * many parameters needed. To aid the user we introduce HeroBuilder class. - * HeroBuilder takes the minimum parameters to build Hero object in its - * constructor. After that additional configuration for the Hero object can be - * done using the fluent HeroBuilder interface. When configuration is ready the - * build method is called to receive the final Hero object. - * - */ -public class App { - - public static void main(String[] args) { - - Hero mage = new HeroBuilder(Profession.MAGE, "Riobard") - .withHairColor(HairColor.BLACK).withWeapon(Weapon.DAGGER) - .build(); - System.out.println(mage); - - Hero warrior = new HeroBuilder(Profession.WARRIOR, "Amberjill") - .withHairColor(HairColor.BLOND) - .withHairType(HairType.LONG_CURLY).withArmor(Armor.CHAIN_MAIL) - .withWeapon(Weapon.SWORD).build(); - System.out.println(warrior); - - Hero thief = new HeroBuilder(Profession.THIEF, "Desmond") - .withHairType(HairType.BALD).withWeapon(Weapon.BOW).build(); - System.out.println(thief); - - } -} +package com.iluwatar.builder; + +import com.iluwatar. builder.Hero.HeroBuilder; + +/** + * + * This is 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 HeroBuilder} class. + * {@link HeroBuilder} 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 HeroBuilder} interface. When configuration is ready the + * build method is called to receive the final {@link Hero} object. + * + */ +public class App { + + /** + * Program entry point + * @param args command line args + */ + public static void main(String[] args) { + + Hero mage = new HeroBuilder(Profession.MAGE, "Riobard") + .withHairColor(HairColor.BLACK).withWeapon(Weapon.DAGGER) + .build(); + System.out.println(mage); + + Hero warrior = new HeroBuilder(Profession.WARRIOR, "Amberjill") + .withHairColor(HairColor.BLOND) + .withHairType(HairType.LONG_CURLY).withArmor(Armor.CHAIN_MAIL) + .withWeapon(Weapon.SWORD).build(); + System.out.println(warrior); + + Hero thief = new HeroBuilder(Profession.THIEF, "Desmond") + .withHairType(HairType.BALD).withWeapon(Weapon.BOW).build(); + System.out.println(thief); + + } +} diff --git a/builder/src/main/java/com/iluwatar/builder/Armor.java b/builder/src/main/java/com/iluwatar/builder/Armor.java index ebec6a47d..95fcba43b 100644 --- a/builder/src/main/java/com/iluwatar/builder/Armor.java +++ b/builder/src/main/java/com/iluwatar/builder/Armor.java @@ -1,17 +1,22 @@ -package com.iluwatar.builder; - -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; - } -} +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; + } +} diff --git a/builder/src/main/java/com/iluwatar/builder/HairColor.java b/builder/src/main/java/com/iluwatar/builder/HairColor.java index a73044754..dd8ec2ecc 100644 --- a/builder/src/main/java/com/iluwatar/builder/HairColor.java +++ b/builder/src/main/java/com/iluwatar/builder/HairColor.java @@ -1,12 +1,17 @@ -package com.iluwatar.builder; - -public enum HairColor { - - WHITE, BLOND, RED, BROWN, BLACK; - - @Override - public String toString() { - return name().toLowerCase(); - } - -} +package com.iluwatar.builder; + +/** + * + * HairColor enumeration + * + */ +public enum HairColor { + + WHITE, BLOND, RED, BROWN, BLACK; + + @Override + public String toString() { + return name().toLowerCase(); + } + +} diff --git a/builder/src/main/java/com/iluwatar/builder/HairType.java b/builder/src/main/java/com/iluwatar/builder/HairType.java index 075699a58..ea49c0470 100644 --- a/builder/src/main/java/com/iluwatar/builder/HairType.java +++ b/builder/src/main/java/com/iluwatar/builder/HairType.java @@ -1,17 +1,22 @@ -package com.iluwatar.builder; - -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; - } -} +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; + } +} diff --git a/builder/src/main/java/com/iluwatar/builder/Hero.java b/builder/src/main/java/com/iluwatar/builder/Hero.java index 75513eeda..05304bf09 100644 --- a/builder/src/main/java/com/iluwatar/builder/Hero.java +++ b/builder/src/main/java/com/iluwatar/builder/Hero.java @@ -2,7 +2,7 @@ package com.iluwatar.builder; /** * - * The class with many parameters. + * Hero, the class with many parameters. * */ public class Hero { diff --git a/builder/src/main/java/com/iluwatar/builder/Profession.java b/builder/src/main/java/com/iluwatar/builder/Profession.java index 487fc5133..c9a7cc4e9 100644 --- a/builder/src/main/java/com/iluwatar/builder/Profession.java +++ b/builder/src/main/java/com/iluwatar/builder/Profession.java @@ -1,12 +1,17 @@ -package com.iluwatar.builder; - -public enum Profession { - - WARRIOR, THIEF, MAGE, PRIEST; - - @Override - public String toString() { - return name().toLowerCase(); - } - -} +package com.iluwatar.builder; + +/** + * + * Profession enumeration + * + */ +public enum Profession { + + WARRIOR, THIEF, MAGE, PRIEST; + + @Override + public String toString() { + return name().toLowerCase(); + } + +} diff --git a/builder/src/main/java/com/iluwatar/builder/Weapon.java b/builder/src/main/java/com/iluwatar/builder/Weapon.java index 99622ddac..af71c596d 100644 --- a/builder/src/main/java/com/iluwatar/builder/Weapon.java +++ b/builder/src/main/java/com/iluwatar/builder/Weapon.java @@ -1,12 +1,17 @@ -package com.iluwatar.builder; - -public enum Weapon { - - DAGGER, SWORD, AXE, WARHAMMER, BOW; - - @Override - public String toString() { - return name().toLowerCase(); - } - -} +package com.iluwatar.builder; + +/** + * + * Weapon enumeration + * + */ +public enum Weapon { + + DAGGER, SWORD, AXE, WARHAMMER, BOW; + + @Override + public String toString() { + return name().toLowerCase(); + } + +} diff --git a/builder/src/test/java/com/iluwatar/builder/AppTest.java b/builder/src/test/java/com/iluwatar/builder/AppTest.java index 462ad3a9a..acae1ca70 100644 --- a/builder/src/test/java/com/iluwatar/builder/AppTest.java +++ b/builder/src/test/java/com/iluwatar/builder/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.builder; - -import org.junit.Test; - -import com.iluwatar. builder.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.builder; + +import org.junit.Test; + +import com.iluwatar. builder.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From a0283d60f14783cc0049d8b9763902fe3e0282d2 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:40:11 +0300 Subject: [PATCH 106/687] #107 Business Delegate JavaDoc improvements --- .../java/com/iluwatar/business/delegate/App.java | 12 ++++++++---- .../iluwatar/business/delegate/BusinessDelegate.java | 2 +- .../java/com/iluwatar/business/delegate/AppTest.java | 5 +++++ 3 files changed, 14 insertions(+), 5 deletions(-) diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java index 214d8232f..eea7608eb 100644 --- a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java +++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java @@ -2,21 +2,25 @@ package com.iluwatar.business.delegate; /** * - * The Business Delegate pattern adds an abstraction layer between presentation and business tiers. + * 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 (Client) utilizes a business delegate (BusinessDelegate) to execute a task. + *

+ * 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(); diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java index d70646820..cf0809b97 100644 --- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java +++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java @@ -2,7 +2,7 @@ package com.iluwatar.business.delegate; /** * - * BusinessDelegate separates presentation and business tiers + * BusinessDelegate separates the presentation and business tiers * */ public class BusinessDelegate { diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java index 3a3dce68e..7ce63c2b4 100644 --- a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java +++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.business.delegate.App; +/** + * + * Application test + * + */ public class AppTest { @Test From b3b6479f6fd93807140772f1ae848c98396b0013 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:51:04 +0300 Subject: [PATCH 107/687] #107 Callback JavaDoc improvements --- callback/src/main/java/com/iluwatar/callback/App.java | 6 ++++-- callback/src/main/java/com/iluwatar/callback/Callback.java | 2 ++ .../src/main/java/com/iluwatar/callback/SimpleTask.java | 2 ++ callback/src/main/java/com/iluwatar/callback/Task.java | 2 ++ callback/src/test/java/com/iluwatar/callback/AppTest.java | 5 +++++ 5 files changed, 15 insertions(+), 2 deletions(-) diff --git a/callback/src/main/java/com/iluwatar/callback/App.java b/callback/src/main/java/com/iluwatar/callback/App.java index 546a6b507..513a32415 100644 --- a/callback/src/main/java/com/iluwatar/callback/App.java +++ b/callback/src/main/java/com/iluwatar/callback/App.java @@ -1,8 +1,10 @@ package com.iluwatar.callback; /** - * Callback pattern is more native for functional languages where function is treated as first-class citizen. - * Prior to Java8 can be simulated using simple (alike command) interfaces. + * + * 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 { diff --git a/callback/src/main/java/com/iluwatar/callback/Callback.java b/callback/src/main/java/com/iluwatar/callback/Callback.java index 9e757e218..81a421c0d 100644 --- a/callback/src/main/java/com/iluwatar/callback/Callback.java +++ b/callback/src/main/java/com/iluwatar/callback/Callback.java @@ -1,7 +1,9 @@ package com.iluwatar.callback; /** + * * Callback interface + * */ public interface Callback { diff --git a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java index f8a27ba10..58f35709f 100644 --- a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java +++ b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java @@ -1,7 +1,9 @@ package com.iluwatar.callback; /** + * * Implementation of task that need to be executed + * */ public class SimpleTask extends Task { diff --git a/callback/src/main/java/com/iluwatar/callback/Task.java b/callback/src/main/java/com/iluwatar/callback/Task.java index df7bf8ae8..db4b66dc5 100644 --- a/callback/src/main/java/com/iluwatar/callback/Task.java +++ b/callback/src/main/java/com/iluwatar/callback/Task.java @@ -1,7 +1,9 @@ package com.iluwatar.callback; /** + * * Template-method class for callback hook execution + * */ public abstract class Task { diff --git a/callback/src/test/java/com/iluwatar/callback/AppTest.java b/callback/src/test/java/com/iluwatar/callback/AppTest.java index 5d7febcee..aceac1c62 100644 --- a/callback/src/test/java/com/iluwatar/callback/AppTest.java +++ b/callback/src/test/java/com/iluwatar/callback/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.callback.App; +/** + * + * Application test + * + */ public class AppTest { @Test From fa0acb4366d194b196db8f0bc2a5371d32c6a248 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 21:55:25 +0300 Subject: [PATCH 108/687] #107 Chain example JavaDoc improvements --- .../src/main/java/com/iluwatar/chain/App.java | 48 +++++++------ .../java/com/iluwatar/chain/OrcCommander.java | 49 +++++++------ .../main/java/com/iluwatar/chain/OrcKing.java | 48 ++++++------- .../java/com/iluwatar/chain/OrcOfficer.java | 51 +++++++------ .../java/com/iluwatar/chain/OrcSoldier.java | 49 +++++++------ .../main/java/com/iluwatar/chain/Request.java | 71 ++++++++++--------- .../com/iluwatar/chain/RequestHandler.java | 51 +++++++------ .../java/com/iluwatar/chain/RequestType.java | 19 +++-- .../test/java/com/iluwatar/chain/AppTest.java | 33 +++++---- 9 files changed, 229 insertions(+), 190 deletions(-) diff --git a/chain/src/main/java/com/iluwatar/chain/App.java b/chain/src/main/java/com/iluwatar/chain/App.java index 21d206696..5f98b2478 100644 --- a/chain/src/main/java/com/iluwatar/chain/App.java +++ b/chain/src/main/java/com/iluwatar/chain/App.java @@ -1,22 +1,26 @@ -package com.iluwatar.chain; - -/** - * - * Chain of Responsibility organizes request handlers (RequestHandler) into a - * chain where each handler has a chance to act on the request on its turn. In - * this example the king (OrcKing) makes requests and the military orcs - * (OrcCommander, OrcOfficer, OrcSoldier) form the handler chain. - * - */ -public class App { - - 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")); - - } -} +package com.iluwatar.chain; + +/** + * + * Chain of Responsibility organizes request handlers ({@link RequestHandler}) into a + * chain where each handler has a chance to act on the request on its turn. In + * this example 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")); + + } +} diff --git a/chain/src/main/java/com/iluwatar/chain/OrcCommander.java b/chain/src/main/java/com/iluwatar/chain/OrcCommander.java index 1f5f4de86..fb5134e01 100644 --- a/chain/src/main/java/com/iluwatar/chain/OrcCommander.java +++ b/chain/src/main/java/com/iluwatar/chain/OrcCommander.java @@ -1,22 +1,27 @@ -package com.iluwatar.chain; - -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); - } else { - super.handleRequest(req); - } - } - - @Override - public String toString() { - return "Orc commander"; - } -} +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); + } else { + super.handleRequest(req); + } + } + + @Override + public String toString() { + return "Orc commander"; + } +} diff --git a/chain/src/main/java/com/iluwatar/chain/OrcKing.java b/chain/src/main/java/com/iluwatar/chain/OrcKing.java index afd2616fe..b39959935 100644 --- a/chain/src/main/java/com/iluwatar/chain/OrcKing.java +++ b/chain/src/main/java/com/iluwatar/chain/OrcKing.java @@ -1,24 +1,24 @@ -package com.iluwatar.chain; - -/** - * - * 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); - } - -} +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); + } + +} diff --git a/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java b/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java index c09729cc8..131cb1101 100644 --- a/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java +++ b/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java @@ -1,23 +1,28 @@ -package com.iluwatar.chain; - -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); - } else { - super.handleRequest(req); - } - } - - @Override - public String toString() { - return "Orc officer"; - } - -} +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); + } else { + super.handleRequest(req); + } + } + + @Override + public String toString() { + return "Orc officer"; + } + +} diff --git a/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java b/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java index f52c7d543..a681dfb77 100644 --- a/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java +++ b/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java @@ -1,22 +1,27 @@ -package com.iluwatar.chain; - -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); - } else { - super.handleRequest(req); - } - } - - @Override - public String toString() { - return "Orc soldier"; - } -} +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); + } else { + super.handleRequest(req); + } + } + + @Override + public String toString() { + return "Orc soldier"; + } +} diff --git a/chain/src/main/java/com/iluwatar/chain/Request.java b/chain/src/main/java/com/iluwatar/chain/Request.java index ad55522f0..558ee65d1 100644 --- a/chain/src/main/java/com/iluwatar/chain/Request.java +++ b/chain/src/main/java/com/iluwatar/chain/Request.java @@ -1,33 +1,38 @@ -package com.iluwatar.chain; - -public class Request { - - private String requestDescription; - private RequestType requestType; - - public Request(RequestType requestType, String requestDescription) { - this.setRequestType(requestType); - this.setRequestDescription(requestDescription); - } - - public String getRequestDescription() { - return requestDescription; - } - - public void setRequestDescription(String requestDescription) { - this.requestDescription = requestDescription; - } - - public RequestType getRequestType() { - return requestType; - } - - public void setRequestType(RequestType requestType) { - this.requestType = requestType; - } - - @Override - public String toString() { - return getRequestDescription(); - } -} +package com.iluwatar.chain; + +/** + * + * Request + * + */ +public class Request { + + private String requestDescription; + private RequestType requestType; + + public Request(RequestType requestType, String requestDescription) { + this.setRequestType(requestType); + this.setRequestDescription(requestDescription); + } + + public String getRequestDescription() { + return requestDescription; + } + + public void setRequestDescription(String requestDescription) { + this.requestDescription = requestDescription; + } + + public RequestType getRequestType() { + return requestType; + } + + public void setRequestType(RequestType requestType) { + this.requestType = requestType; + } + + @Override + public String toString() { + return getRequestDescription(); + } +} diff --git a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java index dbb8b10a6..5570c20ce 100644 --- a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java +++ b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java @@ -1,23 +1,28 @@ -package com.iluwatar.chain; - -public abstract class RequestHandler { - - private RequestHandler next; - - public RequestHandler(RequestHandler next) { - this.next = next; - } - - public void handleRequest(Request req) { - if (next != null) { - next.handleRequest(req); - } - } - - protected void printHandling(Request req) { - System.out.println(this + " handling request \"" + req + "\""); - } - - @Override - public abstract String toString(); -} +package com.iluwatar.chain; + +/** + * + * RequestHandler + * + */ +public abstract class RequestHandler { + + private RequestHandler next; + + public RequestHandler(RequestHandler next) { + this.next = next; + } + + public void handleRequest(Request req) { + if (next != null) { + next.handleRequest(req); + } + } + + protected void printHandling(Request req) { + System.out.println(this + " handling request \"" + req + "\""); + } + + @Override + public abstract String toString(); +} diff --git a/chain/src/main/java/com/iluwatar/chain/RequestType.java b/chain/src/main/java/com/iluwatar/chain/RequestType.java index 21727535e..9ad975d2f 100644 --- a/chain/src/main/java/com/iluwatar/chain/RequestType.java +++ b/chain/src/main/java/com/iluwatar/chain/RequestType.java @@ -1,7 +1,12 @@ -package com.iluwatar.chain; - -public enum RequestType { - - DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX - -} +package com.iluwatar.chain; + +/** + * + * RequestType enumeration + * + */ +public enum RequestType { + + DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX + +} diff --git a/chain/src/test/java/com/iluwatar/chain/AppTest.java b/chain/src/test/java/com/iluwatar/chain/AppTest.java index 5edba69bb..aa52e60e2 100644 --- a/chain/src/test/java/com/iluwatar/chain/AppTest.java +++ b/chain/src/test/java/com/iluwatar/chain/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.chain; - -import org.junit.Test; - -import com.iluwatar.chain.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.chain; + +import org.junit.Test; + +import com.iluwatar.chain.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 98abe5b5b6181c0269115a5a2f0af1f190258cba Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:01:08 +0300 Subject: [PATCH 109/687] #107 Improvements for Command example JavaDocs --- .../main/java/com/iluwatar/command/App.java | 10 ++++-- .../java/com/iluwatar/command/AppTest.java | 33 +++++++++++-------- 2 files changed, 26 insertions(+), 17 deletions(-) diff --git a/command/src/main/java/com/iluwatar/command/App.java b/command/src/main/java/com/iluwatar/command/App.java index 6d9df821c..fc05afa66 100644 --- a/command/src/main/java/com/iluwatar/command/App.java +++ b/command/src/main/java/com/iluwatar/command/App.java @@ -3,15 +3,15 @@ package com.iluwatar.command; /** * * In Command pattern actions are objects that can be executed and undone. - * + *

* Four terms always associated with the command pattern are command, receiver, invoker and client. A command - * object (spell) knows about receiver (target) and invokes a method of the receiver. Values for parameters of + * 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. @@ -20,6 +20,10 @@ package com.iluwatar.command; */ 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(); diff --git a/command/src/test/java/com/iluwatar/command/AppTest.java b/command/src/test/java/com/iluwatar/command/AppTest.java index 454f92b63..2fd5c16b4 100644 --- a/command/src/test/java/com/iluwatar/command/AppTest.java +++ b/command/src/test/java/com/iluwatar/command/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.command; - -import org.junit.Test; - -import com.iluwatar.command.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.command; + +import org.junit.Test; + +import com.iluwatar.command.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From a7d25e0485829e3a2a13f118e371f269cff73dfe Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:03:41 +0300 Subject: [PATCH 110/687] #107 Composite example JavaDoc --- .../main/java/com/iluwatar/composite/App.java | 54 +++++---- .../java/com/iluwatar/composite/Letter.java | 47 ++++---- .../com/iluwatar/composite/Messenger.java | 111 +++++++++--------- .../java/com/iluwatar/composite/Sentence.java | 51 ++++---- .../java/com/iluwatar/composite/Word.java | 51 ++++---- .../java/com/iluwatar/composite/AppTest.java | 33 +++--- 6 files changed, 188 insertions(+), 159 deletions(-) diff --git a/composite/src/main/java/com/iluwatar/composite/App.java b/composite/src/main/java/com/iluwatar/composite/App.java index 6dd62a552..7dfd15443 100644 --- a/composite/src/main/java/com/iluwatar/composite/App.java +++ b/composite/src/main/java/com/iluwatar/composite/App.java @@ -1,25 +1,29 @@ -package com.iluwatar.composite; - -/** - * - * With Composite we can treat tree hierarchies of objects with uniform - * interface (LetterComposite). In this example we have sentences composed of - * words composed of letters. - * - */ -public class App { - - public static void main(String[] args) { - System.out.println("Message from the orcs: "); - - LetterComposite orcMessage = new Messenger().messageFromOrcs(); - orcMessage.print(); - - System.out.println("\n"); - - System.out.println("Message from the elves: "); - - LetterComposite elfMessage = new Messenger().messageFromElves(); - elfMessage.print(); - } -} +package com.iluwatar.composite; + +/** + * + * With Composite we can treat tree hierarchies of objects with uniform + * interface ({@link LetterComposite}). In this example we have sentences composed of + * words composed of letters. + * + */ +public class App { + + /** + * Program entry point + * @param args command line args + */ + public static void main(String[] args) { + System.out.println("Message from the orcs: "); + + LetterComposite orcMessage = new Messenger().messageFromOrcs(); + orcMessage.print(); + + System.out.println("\n"); + + System.out.println("Message from the elves: "); + + LetterComposite elfMessage = new Messenger().messageFromElves(); + elfMessage.print(); + } +} diff --git a/composite/src/main/java/com/iluwatar/composite/Letter.java b/composite/src/main/java/com/iluwatar/composite/Letter.java index 9df8b95f7..8304ea801 100644 --- a/composite/src/main/java/com/iluwatar/composite/Letter.java +++ b/composite/src/main/java/com/iluwatar/composite/Letter.java @@ -1,21 +1,26 @@ -package com.iluwatar.composite; - -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 - } - -} +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 + } + +} diff --git a/composite/src/main/java/com/iluwatar/composite/Messenger.java b/composite/src/main/java/com/iluwatar/composite/Messenger.java index a849408ca..aa0560d4d 100644 --- a/composite/src/main/java/com/iluwatar/composite/Messenger.java +++ b/composite/src/main/java/com/iluwatar/composite/Messenger.java @@ -1,53 +1,58 @@ -package com.iluwatar.composite; - -import java.util.ArrayList; -import java.util.Arrays; -import java.util.List; - -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); - - } - -} +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); + + } + +} diff --git a/composite/src/main/java/com/iluwatar/composite/Sentence.java b/composite/src/main/java/com/iluwatar/composite/Sentence.java index c83c520de..2fc13701b 100644 --- a/composite/src/main/java/com/iluwatar/composite/Sentence.java +++ b/composite/src/main/java/com/iluwatar/composite/Sentence.java @@ -1,23 +1,28 @@ -package com.iluwatar.composite; - -import java.util.List; - -public class Sentence extends LetterComposite { - - public Sentence(List words) { - for (Word w : words) { - this.add(w); - } - } - - @Override - protected void printThisBefore() { - // nop - } - - @Override - protected void printThisAfter() { - System.out.print("."); - } - -} +package com.iluwatar.composite; + +import java.util.List; + +/** + * + * Sentence + * + */ +public class Sentence extends LetterComposite { + + public Sentence(List words) { + for (Word w : words) { + this.add(w); + } + } + + @Override + protected void printThisBefore() { + // nop + } + + @Override + protected void printThisAfter() { + System.out.print("."); + } + +} diff --git a/composite/src/main/java/com/iluwatar/composite/Word.java b/composite/src/main/java/com/iluwatar/composite/Word.java index 393cd2019..e715ed28a 100644 --- a/composite/src/main/java/com/iluwatar/composite/Word.java +++ b/composite/src/main/java/com/iluwatar/composite/Word.java @@ -1,23 +1,28 @@ -package com.iluwatar.composite; - -import java.util.List; - -public class Word extends LetterComposite { - - public Word(List letters) { - for (Letter l : letters) { - this.add(l); - } - } - - @Override - protected void printThisBefore() { - System.out.print(" "); - } - - @Override - protected void printThisAfter() { - // nop - } - -} +package com.iluwatar.composite; + +import java.util.List; + +/** + * + * Word + * + */ +public class Word extends LetterComposite { + + public Word(List letters) { + for (Letter l : letters) { + this.add(l); + } + } + + @Override + protected void printThisBefore() { + System.out.print(" "); + } + + @Override + protected void printThisAfter() { + // nop + } + +} diff --git a/composite/src/test/java/com/iluwatar/composite/AppTest.java b/composite/src/test/java/com/iluwatar/composite/AppTest.java index 5057efe68..872ccea78 100644 --- a/composite/src/test/java/com/iluwatar/composite/AppTest.java +++ b/composite/src/test/java/com/iluwatar/composite/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.composite; - -import org.junit.Test; - -import com.iluwatar.composite.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.composite; + +import org.junit.Test; + +import com.iluwatar.composite.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 3526d96e374f22053a3dcb2f5b545ca0faf7f984 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:08:18 +0300 Subject: [PATCH 111/687] #107 Dao example JavaDoc --- dao/src/main/java/com/iluwatar/dao/App.java | 103 ++++++++++-------- .../main/java/com/iluwatar/dao/Customer.java | 6 + .../java/com/iluwatar/dao/CustomerDao.java | 6 + .../com/iluwatar/dao/CustomerDaoImpl.java | 2 + .../test/java/com/iluwatar/dao/AppTest.java | 33 +++--- 5 files changed, 89 insertions(+), 61 deletions(-) diff --git a/dao/src/main/java/com/iluwatar/dao/App.java b/dao/src/main/java/com/iluwatar/dao/App.java index dd96cf807..ac6794973 100644 --- a/dao/src/main/java/com/iluwatar/dao/App.java +++ b/dao/src/main/java/com/iluwatar/dao/App.java @@ -1,47 +1,56 @@ -package com.iluwatar.dao; - -import java.util.ArrayList; -import java.util.List; - -/** - * - * With the DAO pattern, we can use various method calls to retrieve/add/delete/update data without directly - * interacting with the data. The below example demonstrates basic operations(CRUD): select, add, update, and delete. - */ -public class App { - - public static void main(String[] args) { - - CustomerDaoImpl customerDao = new CustomerDaoImpl(generateSampleCustomers()); - - System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); - System.out.println("customerDao.getCusterById(2): " + customerDao.getCusterById(2)); - - Customer customer = new Customer(4, "Dan", "Danson"); - customerDao.addCustomer(customer); - - System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); - - customer.setFirstName("Daniel"); - customer.setLastName("Danielson"); - customerDao.updateCustomer(customer); - - System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); - - customerDao.deleteCustomer(customer); - - System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); - } - - public static List generateSampleCustomers() { - Customer customer1 = new Customer(1, "Adam", "Adamson"); - Customer customer2 = new Customer(2, "Bob", "Bobson"); - Customer customer3 = new Customer(3, "Carl", "Carlson"); - - List customers = new ArrayList(); - customers.add(customer1); - customers.add(customer2); - customers.add(customer3); - return customers; - } -} +package com.iluwatar.dao; + +import java.util.ArrayList; +import java.util.List; + +/** + * + * With the DAO pattern, we can use various method calls to retrieve/add/delete/update data without directly + * interacting with the data. The below example demonstrates basic operations(CRUD): select, add, update, and delete. + * + */ +public class App { + + /** + * Program entry point + * @param args command line args + */ + public static void main(String[] args) { + + CustomerDaoImpl customerDao = new CustomerDaoImpl(generateSampleCustomers()); + + System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); + System.out.println("customerDao.getCusterById(2): " + customerDao.getCusterById(2)); + + Customer customer = new Customer(4, "Dan", "Danson"); + customerDao.addCustomer(customer); + + System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); + + customer.setFirstName("Daniel"); + customer.setLastName("Danielson"); + customerDao.updateCustomer(customer); + + System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); + + customerDao.deleteCustomer(customer); + + System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers()); + } + + /** + * Generate customers + * @return list of customers + */ + public static List generateSampleCustomers() { + Customer customer1 = new Customer(1, "Adam", "Adamson"); + Customer customer2 = new Customer(2, "Bob", "Bobson"); + Customer customer3 = new Customer(3, "Carl", "Carlson"); + + List customers = new ArrayList(); + customers.add(customer1); + customers.add(customer2); + customers.add(customer3); + return customers; + } +} diff --git a/dao/src/main/java/com/iluwatar/dao/Customer.java b/dao/src/main/java/com/iluwatar/dao/Customer.java index 7900fee67..8cfdd8034 100644 --- a/dao/src/main/java/com/iluwatar/dao/Customer.java +++ b/dao/src/main/java/com/iluwatar/dao/Customer.java @@ -1,6 +1,12 @@ package com.iluwatar.dao; +/** + * + * Customer + * + */ public class Customer { + private int id; private String firstName; private String lastName; diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java index f201d945d..2a50d2bfb 100644 --- a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java +++ b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java @@ -2,7 +2,13 @@ package com.iluwatar.dao; import java.util.List; +/** + * + * CustomerDao + * + */ public interface CustomerDao { + public List getAllCustomers(); public Customer getCusterById(int id); public void addCustomer(Customer customer); diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java b/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java index ff5332798..4403b57ed 100644 --- a/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java +++ b/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java @@ -3,11 +3,13 @@ package com.iluwatar.dao; import java.util.List; /** + * * The 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, * database schema, etc. + * */ public class CustomerDaoImpl implements CustomerDao { diff --git a/dao/src/test/java/com/iluwatar/dao/AppTest.java b/dao/src/test/java/com/iluwatar/dao/AppTest.java index d45e0ef18..5eb1ebb11 100644 --- a/dao/src/test/java/com/iluwatar/dao/AppTest.java +++ b/dao/src/test/java/com/iluwatar/dao/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.dao; - -import org.junit.Test; - -import com.iluwatar.dao.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.dao; + +import org.junit.Test; + +import com.iluwatar.dao.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 10a911be5498c3444f849a0490c3b75b9d151cc7 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:10:57 +0300 Subject: [PATCH 112/687] #107 Decorator example JavaDoc --- .../main/java/com/iluwatar/decorator/App.java | 62 ++++++++++--------- .../com/iluwatar/decorator/SmartTroll.java | 60 +++++++++--------- .../java/com/iluwatar/decorator/Troll.java | 36 +++++------ .../java/com/iluwatar/decorator/AppTest.java | 33 +++++----- 4 files changed, 100 insertions(+), 91 deletions(-) diff --git a/decorator/src/main/java/com/iluwatar/decorator/App.java b/decorator/src/main/java/com/iluwatar/decorator/App.java index f424f51b9..88e1c7103 100644 --- a/decorator/src/main/java/com/iluwatar/decorator/App.java +++ b/decorator/src/main/java/com/iluwatar/decorator/App.java @@ -1,29 +1,33 @@ -package com.iluwatar.decorator; - -/** - * - * Decorator pattern is more flexible alternative to subclassing. The decorator - * class implements the same interface as the target and uses composition to - * "decorate" calls to the target. - * - * Using decorator pattern it is possible to change class behavior during - * runtime, as the example shows. - * - */ -public class App { - - public static void main(String[] args) { - - // simple troll - System.out.println("A simple looking troll approaches."); - Hostile troll = new Troll(); - troll.attack(); - troll.fleeBattle(); - - // change the behavior of the simple troll by adding a decorator - System.out.println("\nA smart looking troll surprises you."); - Hostile smart = new SmartTroll(troll); - smart.attack(); - smart.fleeBattle(); - } -} +package com.iluwatar.decorator; + +/** + * + * Decorator pattern is a more flexible alternative to subclassing. The decorator + * class implements the same interface as the target and uses composition to + * "decorate" calls to the target. + *

+ * Using decorator pattern it is possible to change class behavior during + * runtime, as the example shows. + * + */ +public class App { + + /** + * Program entry point + * @param args command line args + */ + public static void main(String[] args) { + + // simple troll + System.out.println("A simple looking troll approaches."); + Hostile troll = new Troll(); + troll.attack(); + troll.fleeBattle(); + + // change the behavior of the simple troll by adding a decorator + System.out.println("\nA smart looking troll surprises you."); + Hostile smart = new SmartTroll(troll); + smart.attack(); + smart.fleeBattle(); + } +} diff --git a/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java b/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java index 9baa729f3..22ba88dc8 100644 --- a/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java +++ b/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java @@ -1,30 +1,30 @@ -package com.iluwatar.decorator; - -/** - * SmartTroll is a decorator for Hostile objects. - * The calls to the Hostile interface are intercepted - * and decorated. Finally the calls are delegated - * to the decorated Hostile object. - * - */ -public class SmartTroll implements Hostile { - - private Hostile decorated; - - public SmartTroll(Hostile decorated) { - this.decorated = decorated; - } - - @Override - public void attack() { - System.out.println("The troll throws a rock at you!"); - decorated.attack(); - } - - @Override - public void fleeBattle() { - System.out.println("The troll calls for help!"); - decorated.fleeBattle(); - } - -} +package com.iluwatar.decorator; + +/** + * SmartTroll is a decorator for {@link Hostile} objects. + * The calls to the {@link Hostile} interface are intercepted + * and decorated. Finally the calls are delegated + * to the decorated {@link Hostile} object. + * + */ +public class SmartTroll implements Hostile { + + private Hostile decorated; + + public SmartTroll(Hostile decorated) { + this.decorated = decorated; + } + + @Override + public void attack() { + System.out.println("The troll throws a rock at you!"); + decorated.attack(); + } + + @Override + public void fleeBattle() { + System.out.println("The troll calls for help!"); + decorated.fleeBattle(); + } + +} diff --git a/decorator/src/main/java/com/iluwatar/decorator/Troll.java b/decorator/src/main/java/com/iluwatar/decorator/Troll.java index 8d6cd0aa5..11e9b9d1a 100644 --- a/decorator/src/main/java/com/iluwatar/decorator/Troll.java +++ b/decorator/src/main/java/com/iluwatar/decorator/Troll.java @@ -1,18 +1,18 @@ -package com.iluwatar.decorator; - -/** - * - * Troll implements Hostile interface directly. - * - */ -public class Troll implements Hostile { - - public void attack() { - System.out.println("The troll swings at you with a club!"); - } - - public void fleeBattle() { - System.out.println("The troll shrieks in horror and runs away!"); - } - -} +package com.iluwatar.decorator; + +/** + * + * Troll implements {@link Hostile} interface directly. + * + */ +public class Troll implements Hostile { + + public void attack() { + System.out.println("The troll swings at you with a club!"); + } + + public void fleeBattle() { + System.out.println("The troll shrieks in horror and runs away!"); + } + +} diff --git a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java index 28776c930..b74bd3a06 100644 --- a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java +++ b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.decorator; - -import org.junit.Test; - -import com.iluwatar.decorator.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.decorator; + +import org.junit.Test; + +import com.iluwatar.decorator.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From e71f2279f07466d797d3a6f50af65358d96f65cc Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:17:16 +0300 Subject: [PATCH 113/687] #107 Dependency Injection example JavaDoc --- .../iluwatar/dependency/injection/App.java | 20 +++++++++++-------- .../dependency/injection/OldTobyTobacco.java | 2 +- .../injection/RivendellTobacco.java | 2 +- .../injection/SecondBreakfastTobacco.java | 2 +- .../dependency/injection/TobaccoModule.java | 2 +- .../dependency/injection/AppTest.java | 5 +++++ 6 files changed, 21 insertions(+), 12 deletions(-) diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java index 5d15e3742..a882863b7 100644 --- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java +++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java @@ -9,23 +9,27 @@ import com.google.inject.Injector; * 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 (SimpleWizard) is a naive + *

+ * 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 wizard (AdvancedWizard) is more flexible. It does not depend on any concrete implementation - * but abstraction. It utilizes Dependency Injection pattern allowing its Tobacco dependency to be + *

+ * The second wizard ({@link AdvancedWizard}) is more flexible. It does not depend on any concrete implementation + * but abstraction. It utilizes Dependency Injection pattern allowing its {@link Tobacco} dependency to be * injected through its constructor. This way, handling the dependency is no longer the wizard's * responsibility. It is resolved outside the wizard class. - * + *

* The third example takes the pattern a step further. It uses Guice framework for Dependency Injection. - * TobaccoModule binds a concrete implementation to abstraction. Injector is then used to create - * GuiceWizard object with correct dependencies. + * {@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(); diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java index 08d9c0d12..9197066ee 100644 --- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java +++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/OldTobyTobacco.java @@ -2,7 +2,7 @@ package com.iluwatar.dependency.injection; /** * - * OldTobyTobacco concrete Tobacco implementation + * OldTobyTobacco concrete {@link Tobacco} implementation * */ public class OldTobyTobacco extends Tobacco { diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java index b64a6b93b..9eb137a05 100644 --- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java +++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/RivendellTobacco.java @@ -2,7 +2,7 @@ package com.iluwatar.dependency.injection; /** * - * RivendellTobacco concrete Tobacco implementation + * RivendellTobacco concrete {@link Tobacco} implementation * */ public class RivendellTobacco extends Tobacco { diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java index 1826f269a..269f531d3 100644 --- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java +++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SecondBreakfastTobacco.java @@ -2,7 +2,7 @@ package com.iluwatar.dependency.injection; /** * - * SecondBreakfastTobacco concrete Tobacco implementation + * SecondBreakfastTobacco concrete {@link Tobacco} implementation * */ public class SecondBreakfastTobacco extends Tobacco { diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java index 12c5a57ff..d2dd1072e 100644 --- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java +++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java @@ -4,7 +4,7 @@ import com.google.inject.AbstractModule; /** * - * Guice module for binding certain concrete Tobacco implementation. + * Guice module for binding certain concrete {@link Tobacco} implementation. * */ public class TobaccoModule extends AbstractModule { diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java index d01bc7cbe..5315fe1db 100644 --- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java +++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.dependency.injection.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 57e702db4f5707253fe92f61ea6f71bf3fa8b420 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:29:35 +0300 Subject: [PATCH 114/687] #107 Double Checked Locking example JavaDoc --- .../java/com/iluwatar/doublechecked/locking/App.java | 7 ++++++- .../com/iluwatar/doublechecked/locking/Inventory.java | 5 +++++ .../java/com/iluwatar/doublechecked/locking/Item.java | 10 ++++++++-- .../com/iluwatar/doublechecked/locking/AppTest.java | 5 +++++ 4 files changed, 24 insertions(+), 3 deletions(-) diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java index 10d22a5b2..2a5c65813 100644 --- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java +++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java @@ -5,13 +5,18 @@ import java.util.concurrent.Executors; /** * - * In Inventory we store the items with a given size. However, we do not store + * 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 { + /** + * 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); diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java index e69d30b10..9f663f272 100644 --- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java +++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java @@ -5,6 +5,11 @@ import java.util.List; import java.util.concurrent.locks.Lock; import java.util.concurrent.locks.ReentrantLock; +/** + * + * Inventory + * + */ public class Inventory { private int inventorySize; diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java index 81db22115..8fc7f3888 100644 --- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java +++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java @@ -1,6 +1,12 @@ package com.iluwatar.doublechecked.locking; +/** + * + * Item + * + */ public class Item { - String name; - int level; + + private String name; + private int level; } diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java index 51db32c4f..14fd47488 100644 --- a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java +++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.doublechecked.locking.App; +/** + * + * Application test + * + */ public class AppTest { @Test From f2db01e54676def32445fa40baa837dd7162fe5f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:32:13 +0300 Subject: [PATCH 115/687] #107 Double Dispatch example JavaDoc --- .../main/java/com/iluwatar/doubledispatch/App.java | 12 ++++++++---- .../java/com/iluwatar/doubledispatch/AppTest.java | 5 +++++ 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java index fa799ecfc..f32c93cb1 100644 --- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java +++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java @@ -8,23 +8,27 @@ 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 (GameObject) that can collide to each other. Each + *

+ * 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 { + /** + * 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<>(); diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java index 892772e09..be93ee559 100644 --- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java +++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.doubledispatch.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 0364b49870c6e878101dbd3648f765fddf09cef1 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:37:04 +0300 Subject: [PATCH 116/687] #107 Event Aggregator example JavaDoc --- .../main/java/com/iluwatar/event/aggregator/App.java | 12 ++++++++---- .../com/iluwatar/event/aggregator/KingJoffrey.java | 2 +- .../java/com/iluwatar/event/aggregator/Weekday.java | 5 +++++ .../java/com/iluwatar/event/aggregator/AppTest.java | 5 +++++ 4 files changed, 19 insertions(+), 5 deletions(-) diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java index 44c678f81..029489077 100644 --- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java @@ -7,14 +7,18 @@ import java.util.List; * * The Event Aggregator pattern channels events from multiple objects * into a single object to simplify registration for clients. - * - * In the example LordBaelish, LordVarys and Scout deliver events to - * KingsHand. KingsHand, the event aggregator, then delivers the events - * to KingJoffrey. + *

+ * 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(); diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java index c94d821be..da45f2f1e 100644 --- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java @@ -2,7 +2,7 @@ package com.iluwatar.event.aggregator; /** * - * KingJoffrey observes events from KingsHand. + * KingJoffrey observes events from {@link KingsHand}. * */ public class KingJoffrey implements EventObserver { diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java index 651a4e71c..bafc4f36a 100644 --- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java +++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java @@ -1,5 +1,10 @@ package com.iluwatar.event.aggregator; +/** + * + * Weekday enumeration + * + */ public enum Weekday { MONDAY("Monday"), TUESDAY("Tuesday"), WEDNESDAY("Wednesday"), THURSDAY("Thursday"), FRIDAY("Friday"), SATURDAY("Saturday"), SUNDAY("Sunday"); diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java index 1d2562e2c..f8f765880 100644 --- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java +++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java @@ -3,6 +3,11 @@ import org.junit.Test; import com.iluwatar.event.aggregator.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 527da253c92aed6f3211cc5543bc984b4180db28 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:39:03 +0300 Subject: [PATCH 117/687] #107 Execute Around example JavaDoc --- .../main/java/com/iluwatar/execute/around/App.java | 11 ++++++++--- .../com/iluwatar/execute/around/SimpleFileWriter.java | 2 +- 2 files changed, 9 insertions(+), 4 deletions(-) diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/App.java b/execute-around/src/main/java/com/iluwatar/execute/around/App.java index 8603a12bc..910a024de 100644 --- a/execute-around/src/main/java/com/iluwatar/execute/around/App.java +++ b/execute-around/src/main/java/com/iluwatar/execute/around/App.java @@ -7,14 +7,19 @@ 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 SimpleFileWriter class that opens and closes the file + *

+ * 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 - * FileWriterAction implementation. + * {@link FileWriterAction} implementation. * */ public class App { + /** + * Program entry point + * @param args command line args + * @throws IOException + */ public static void main( String[] args ) throws IOException { new SimpleFileWriter("testfile.txt", new FileWriterAction() { diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java index 2de1e5d67..a7ee11d15 100644 --- a/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java +++ b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java @@ -6,7 +6,7 @@ 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 FileWriterAction + * only has to specify what to do with the file resource through {@link FileWriterAction} * parameter. * */ From 87717a581bd8abb847da694d152ce206281b6d0f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:41:20 +0300 Subject: [PATCH 118/687] #107 Facade example JavaDoc --- .../main/java/com/iluwatar/facade/App.java | 39 +++++++++++-------- .../java/com/iluwatar/facade/AppTest.java | 33 +++++++++------- 2 files changed, 41 insertions(+), 31 deletions(-) diff --git a/facade/src/main/java/com/iluwatar/facade/App.java b/facade/src/main/java/com/iluwatar/facade/App.java index 09d5d1a0b..0d8eccd4b 100644 --- a/facade/src/main/java/com/iluwatar/facade/App.java +++ b/facade/src/main/java/com/iluwatar/facade/App.java @@ -1,17 +1,22 @@ -package com.iluwatar.facade; - -/** - * - * Facade (DwarvenGoldmineFacade) provides simpler interface to subsystem. - * http://en.wikipedia.org/wiki/Facade_pattern - * - */ -public class App { - - public static void main(String[] args) { - DwarvenGoldmineFacade facade = new DwarvenGoldmineFacade(); - facade.startNewDay(); - facade.digOutGold(); - facade.endDay(); - } -} +package com.iluwatar.facade; + +/** + * + * Facade ({@link DwarvenGoldmineFacade}) provides simpler interface to subsystem. + *

+ * http://en.wikipedia.org/wiki/Facade_pattern + * + */ +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(); + } +} diff --git a/facade/src/test/java/com/iluwatar/facade/AppTest.java b/facade/src/test/java/com/iluwatar/facade/AppTest.java index b32b16bb1..bfca5473a 100644 --- a/facade/src/test/java/com/iluwatar/facade/AppTest.java +++ b/facade/src/test/java/com/iluwatar/facade/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.facade; - -import org.junit.Test; - -import com.iluwatar.facade.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.facade; + +import org.junit.Test; + +import com.iluwatar.facade.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 1ec86b732a25e7044babe79bb21ed09280ce1b96 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:44:58 +0300 Subject: [PATCH 119/687] #107 Factory Method example JavaDoc --- .../main/java/com/iluwatar/factory/method/App.java | 11 ++++++++--- .../java/com/iluwatar/factory/method/ElfWeapon.java | 5 +++++ .../java/com/iluwatar/factory/method/OrcWeapon.java | 5 +++++ .../main/java/com/iluwatar/factory/method/Weapon.java | 5 +++++ .../java/com/iluwatar/factory/method/WeaponType.java | 5 +++++ .../java/com/iluwatar/factory/method/AppTest.java | 5 +++++ 6 files changed, 33 insertions(+), 3 deletions(-) diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/App.java b/factory-method/src/main/java/com/iluwatar/factory/method/App.java index 41b234791..69bda3489 100644 --- a/factory-method/src/main/java/com/iluwatar/factory/method/App.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/App.java @@ -2,13 +2,18 @@ package com.iluwatar.factory.method; /** * - * In Factory Method we have an interface (Blacksmith) with a method for - * creating objects (manufactureWeapon). The concrete subclasses (OrcBlacksmith, - * ElfBlacksmith) then override the method to produce objects of their liking. + * In Factory Method 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 { + /** + * Program entry point + * @param args command line args + */ public static void main(String[] args) { Blacksmith blacksmith; Weapon weapon; diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java index a425d3ce7..75bb8a9e0 100644 --- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java @@ -1,5 +1,10 @@ package com.iluwatar.factory.method; +/** + * + * ElfWeapon + * + */ public class ElfWeapon implements Weapon { private WeaponType weaponType; diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java index ab9b83991..85500799e 100644 --- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java @@ -1,5 +1,10 @@ package com.iluwatar.factory.method; +/** + * + * OrcWeapon + * + */ public class OrcWeapon implements Weapon { private WeaponType weaponType; diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java index 80e7c911f..a5ae99254 100644 --- a/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/Weapon.java @@ -1,5 +1,10 @@ package com.iluwatar.factory.method; +/** + * + * Weapon interface + * + */ public interface Weapon { } diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java index 9ef82fff6..1c0341670 100644 --- a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java +++ b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java @@ -1,5 +1,10 @@ package com.iluwatar.factory.method; +/** + * + * WeaponType enumeration + * + */ public enum WeaponType { SHORT_SWORD("short sword"), SPEAR("spear"), AXE("axe"), UNDEFINED(""); diff --git a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java index 9fa0cc5eb..c6db18b3e 100644 --- a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java +++ b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.factory.method.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 25a2fc756d336b33e2546ca5053a36a16b441904 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:47:40 +0300 Subject: [PATCH 120/687] #107 Flux example JavaDoc --- flux/src/main/java/com/iluwatar/flux/app/App.java | 9 +++++++-- flux/src/test/java/com/iluwatar/flux/app/AppTest.java | 5 +++++ 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/flux/src/main/java/com/iluwatar/flux/app/App.java b/flux/src/main/java/com/iluwatar/flux/app/App.java index d0c7763e7..a567a92d3 100644 --- a/flux/src/main/java/com/iluwatar/flux/app/App.java +++ b/flux/src/main/java/com/iluwatar/flux/app/App.java @@ -13,18 +13,23 @@ import com.iluwatar.flux.view.MenuView; * 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); diff --git a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java index 902e5872e..ba4b592a1 100644 --- a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java +++ b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.flux.app.App; +/** + * + * Application test + * + */ public class AppTest { @Test From de784cfdc12c6816fd8d9b925b50ee86e3b19144 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:51:08 +0300 Subject: [PATCH 121/687] #107 Flyweight example JavaDoc --- .../main/java/com/iluwatar/flyweight/App.java | 14 +++++--- .../com/iluwatar/flyweight/HealingPotion.java | 27 ++++++++------- .../iluwatar/flyweight/HolyWaterPotion.java | 27 ++++++++------- .../flyweight/InvisibilityPotion.java | 27 ++++++++------- .../com/iluwatar/flyweight/PoisonPotion.java | 27 ++++++++------- .../iluwatar/flyweight/StrengthPotion.java | 25 ++++++++------ .../java/com/iluwatar/flyweight/AppTest.java | 33 +++++++++++-------- 7 files changed, 107 insertions(+), 73 deletions(-) diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/App.java b/flyweight/src/main/java/com/iluwatar/flyweight/App.java index 3aa41cf2c..c08ba78a3 100644 --- a/flyweight/src/main/java/com/iluwatar/flyweight/App.java +++ b/flyweight/src/main/java/com/iluwatar/flyweight/App.java @@ -4,18 +4,22 @@ 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 AlchemistShop has great amount of potions on its shelves. - * To fill the shelves AlchemistShop uses PotionFactory (which represents - * the Flyweight in this example). Internally PotionFactory holds a map + *

+ * 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(); diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java index 397cca428..a5f8f4fb8 100644 --- a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java +++ b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java @@ -1,11 +1,16 @@ -package com.iluwatar.flyweight; - -public class HealingPotion implements Potion { - - @Override - public void drink() { - System.out.println("You feel healed. (Potion=" - + System.identityHashCode(this) + ")"); - } - -} +package com.iluwatar.flyweight; + +/** + * + * HealingPotion + * + */ +public class HealingPotion implements Potion { + + @Override + public void drink() { + System.out.println("You feel healed. (Potion=" + + System.identityHashCode(this) + ")"); + } + +} diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java index df4c4009e..750e3c568 100644 --- a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java +++ b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java @@ -1,11 +1,16 @@ -package com.iluwatar.flyweight; - -public class HolyWaterPotion implements Potion { - - @Override - public void drink() { - System.out.println("You feel blessed. (Potion=" - + System.identityHashCode(this) + ")"); - } - -} +package com.iluwatar.flyweight; + +/** + * + * HolyWaterPotion + * + */ +public class HolyWaterPotion implements Potion { + + @Override + public void drink() { + System.out.println("You feel blessed. (Potion=" + + System.identityHashCode(this) + ")"); + } + +} diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java index 2156b1017..db9d261d5 100644 --- a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java +++ b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java @@ -1,11 +1,16 @@ -package com.iluwatar.flyweight; - -public class InvisibilityPotion implements Potion { - - @Override - public void drink() { - System.out.println("You become invisible. (Potion=" - + System.identityHashCode(this) + ")"); - } - -} +package com.iluwatar.flyweight; + +/** + * + * InvisibilityPotion + * + */ +public class InvisibilityPotion implements Potion { + + @Override + public void drink() { + System.out.println("You become invisible. (Potion=" + + System.identityHashCode(this) + ")"); + } + +} diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java index 2dcfab7d3..dfcd3c38d 100644 --- a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java +++ b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java @@ -1,11 +1,16 @@ -package com.iluwatar.flyweight; - -public class PoisonPotion implements Potion { - - @Override - public void drink() { - System.out.println("Urgh! This is poisonous. (Potion=" - + System.identityHashCode(this) + ")"); - } - -} +package com.iluwatar.flyweight; + +/** + * + * PoisonPotion + * + */ +public class PoisonPotion implements Potion { + + @Override + public void drink() { + System.out.println("Urgh! This is poisonous. (Potion=" + + System.identityHashCode(this) + ")"); + } + +} diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java index a1ffcdc53..49083cf7c 100644 --- a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java +++ b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java @@ -1,10 +1,15 @@ -package com.iluwatar.flyweight; - -public class StrengthPotion implements Potion { - - @Override - public void drink() { - System.out.println("You feel strong. (Potion=" - + System.identityHashCode(this) + ")"); - } -} +package com.iluwatar.flyweight; + +/** + * + * StrengthPotion + * + */ +public class StrengthPotion implements Potion { + + @Override + public void drink() { + System.out.println("You feel strong. (Potion=" + + System.identityHashCode(this) + ")"); + } +} diff --git a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java index 2c93d0e10..f3b033ba7 100644 --- a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java +++ b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.flyweight; - -import org.junit.Test; - -import com.iluwatar.flyweight.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.flyweight; + +import org.junit.Test; + +import com.iluwatar.flyweight.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From c5c4a68c6f9ce08a754833fd8444d3cbf88df040 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:54:15 +0300 Subject: [PATCH 122/687] #107 Front Controller example JavaDoc --- .../com/iluwatar/front/controller/App.java | 24 +++++++++++-------- .../controller/ApplicationException.java | 9 ++++++- .../iluwatar/front/controller/AppTest.java | 5 ++++ 3 files changed, 27 insertions(+), 11 deletions(-) diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/App.java b/front-controller/src/main/java/com/iluwatar/front/controller/App.java index d17987823..18a92d37d 100644 --- a/front-controller/src/main/java/com/iluwatar/front/controller/App.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/App.java @@ -4,22 +4,26 @@ 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 (FrontController). This object can carry out the common the behavior such as + * 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 (Command) which then display - * the correct view (View). - * - * In this example we have implemented two views: ArcherView and CatapultView. These - * are displayed by sending correct request to the FrontController object. For example, - * the ArcherView gets displayed when FrontController receives request "Archer". When - * the request is unknown, we display the error view (ErrorView). + *

+ * 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"); diff --git a/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java b/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java index 3a0191831..b3963d8e9 100644 --- a/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java +++ b/front-controller/src/main/java/com/iluwatar/front/controller/ApplicationException.java @@ -1,8 +1,15 @@ package com.iluwatar.front.controller; +/** + * + * Custom exception type + * + */ public class ApplicationException extends RuntimeException { - public ApplicationException(Throwable cause) { + private static final long serialVersionUID = 1L; + + public ApplicationException(Throwable cause) { super(cause); } } diff --git a/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java index 2c05cf9c4..2c28aa8ce 100644 --- a/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java +++ b/front-controller/src/test/java/com/iluwatar/front/controller/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.front.controller.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 665dc703d6f81ae7e849dc891e66f0577ba20742 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 22:58:00 +0300 Subject: [PATCH 123/687] #107 Half-Sync Half-Async example JavaDoc --- .../main/java/com/iluwatar/halfsynchalfasync/App.java | 11 +++++++++++ .../java/com/iluwatar/halfsynchalfasync/AppTest.java | 5 +++++ 2 files changed, 16 insertions(+) diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java index 77b1988ba..b8cec89e3 100644 --- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java +++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java @@ -3,6 +3,7 @@ package com.iluwatar.halfsynchalfasync; import java.util.concurrent.LinkedBlockingQueue; /** + * * This application demonstrates Half-Sync/Half-Async pattern. Key parts of the pattern are * {@link AsyncTask} and {@link AsynchronousService}. * @@ -44,9 +45,14 @@ import java.util.concurrent.LinkedBlockingQueue; * 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 { + /** + * Program entry point + * @param args command line args + */ public static void main(String[] args) { AsynchronousService service = new AsynchronousService(new LinkedBlockingQueue<>()); /* @@ -66,6 +72,11 @@ public class App { service.execute(new ArithmeticSumTask(1)); } + /** + * + * ArithmeticSumTask + * + */ static class ArithmeticSumTask implements AsyncTask { private long n; diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java index 54f6ea5a7..a72417aff 100644 --- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java +++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java @@ -4,6 +4,11 @@ import java.util.concurrent.ExecutionException; import org.junit.Test; +/** + * + * Application test + * + */ public class AppTest { @Test From 0d8b3c9935250d1889b823b0592600935015469c Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 23:06:14 +0300 Subject: [PATCH 124/687] #107 Intercepting Filter example JavaDoc --- .../main/java/com/iluwatar/intercepting/filter/App.java | 8 ++++++-- .../java/com/iluwatar/intercepting/filter/Client.java | 4 ++-- .../java/com/iluwatar/intercepting/filter/Filter.java | 2 +- .../com/iluwatar/intercepting/filter/FilterManager.java | 2 +- .../java/com/iluwatar/intercepting/filter/NameFilter.java | 2 +- .../com/iluwatar/intercepting/filter/OrderFilter.java | 2 +- .../java/com/iluwatar/intercepting/filter/AppTest.java | 5 +++++ 7 files changed, 17 insertions(+), 8 deletions(-) diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java index b597396f5..7cdb17fb8 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java @@ -2,13 +2,17 @@ package com.iluwatar.intercepting.filter; /** * - * This is an app that checks whether the order request is valid through pre-processing done via Filters - * Each field has its own corresponding Filter + * This is an app that checks 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(new Target()); filterManager.addFilter(new NameFilter()); diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java index 6c94af5c5..0125d1b9d 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java @@ -15,9 +15,9 @@ import javax.swing.JTextField; import javax.swing.SwingUtilities; /** - * The Client class is responsible for handling the input and running them through filters inside the filterManager + * The Client class is responsible for handling the input and running them through filters inside the {@link FilterManager}. * - * This is where Filters come to play as the client pre-processes the request before being displayed in the Target + * 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 * diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java index 0782fddab..a71be5154 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java @@ -1,7 +1,7 @@ package com.iluwatar.intercepting.filter; /** - * Filter interface Filters perform certain tasks prior or after execution of + * 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 * diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java index 65c822c8a..d15df424a 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java @@ -1,7 +1,7 @@ package com.iluwatar.intercepting.filter; /** - * Filter Manager manages the filters and Filter Chain. + * Filter Manager manages the filters and {@link FilterChain}. * * @author joshzambales * diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java index c9da2600a..201c68bca 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java @@ -1,7 +1,7 @@ package com.iluwatar.intercepting.filter; /** - * Concrete implementation of filter This filter checks if the input in the Name + * Concrete implementation of filter. This filter checks if the input in the Name * field is valid. (alphanumeric) * * @author joshzambales diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java index bc86289b4..cdeaec6e0 100644 --- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java +++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java @@ -1,7 +1,7 @@ package com.iluwatar.intercepting.filter; /** - * Concrete implementation of filter This checks for the order field + * Concrete implementation of filter. This checks for the order field. * * @author joshzambales * diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java index b12bc8db9..9d31127a2 100644 --- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java +++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.intercepting.filter.App; +/** + * + * Application test. + * + */ public class AppTest { @Test From 5831d3239d30b3ac3163aba0e31bdd20d0ce731c Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 23:10:08 +0300 Subject: [PATCH 125/687] #107 Interpreter example JavaDoc --- .../java/com/iluwatar/interpreter/App.java | 140 +++++++++--------- .../com/iluwatar/interpreter/Expression.java | 23 +-- .../iluwatar/interpreter/MinusExpression.java | 51 ++++--- .../interpreter/MultiplyExpression.java | 53 ++++--- .../interpreter/NumberExpression.java | 55 +++---- .../iluwatar/interpreter/PlusExpression.java | 51 ++++--- .../com/iluwatar/interpreter/AppTest.java | 33 +++-- 7 files changed, 220 insertions(+), 186 deletions(-) diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/App.java b/interpreter/src/main/java/com/iluwatar/interpreter/App.java index 56924f6b0..2273b386b 100644 --- a/interpreter/src/main/java/com/iluwatar/interpreter/App.java +++ b/interpreter/src/main/java/com/iluwatar/interpreter/App.java @@ -1,68 +1,72 @@ -package com.iluwatar.interpreter; - -import java.util.Stack; - -/** - * - * Interpreter pattern breaks sentences into expressions (Expression) that can - * be evaluated and as a whole form the result. - * - */ -public class App { - - /** - * - * Expressions can be evaluated using prefix, infix or postfix notations - * This sample uses postfix, where operator comes after the operands - * - */ - 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(); - System.out - .println(String.format( - "popped from stack left: %d right: %d", - leftExpression.interpret(), - rightExpression.interpret())); - Expression operator = getOperatorInstance(s, leftExpression, - rightExpression); - System.out.println(String.format("operator: %s", operator)); - int result = operator.interpret(); - NumberExpression resultExpression = new NumberExpression(result); - stack.push(resultExpression); - System.out.println(String.format("push result to stack: %d", - resultExpression.interpret())); - } else { - Expression i = new NumberExpression(s); - stack.push(i); - System.out.println(String.format("push to stack: %d", - i.interpret())); - } - } - System.out - .println(String.format("result: %d", stack.pop().interpret())); - } - - public static boolean isOperator(String s) { - return s.equals("+") || s.equals("-") || s.equals("*"); - } - - 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); - } - return null; - } -} +package com.iluwatar.interpreter; + +import java.util.Stack; + +/** + * + * Interpreter pattern breaks sentences into expressions ({@link Expression}) that can + * be evaluated and as a whole form the result. + * + */ +public class App { + + /** + * + * 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(); + System.out + .println(String.format( + "popped from stack left: %d right: %d", + leftExpression.interpret(), + rightExpression.interpret())); + Expression operator = getOperatorInstance(s, leftExpression, + rightExpression); + System.out.println(String.format("operator: %s", operator)); + int result = operator.interpret(); + NumberExpression resultExpression = new NumberExpression(result); + stack.push(resultExpression); + System.out.println(String.format("push result to stack: %d", + resultExpression.interpret())); + } else { + Expression i = new NumberExpression(s); + stack.push(i); + System.out.println(String.format("push to stack: %d", + i.interpret())); + } + } + System.out + .println(String.format("result: %d", stack.pop().interpret())); + } + + public static boolean isOperator(String s) { + return s.equals("+") || s.equals("-") || s.equals("*"); + } + + 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); + } + return null; + } +} diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java b/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java index 877e5db33..e70e57f7c 100644 --- a/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java +++ b/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java @@ -1,9 +1,14 @@ -package com.iluwatar.interpreter; - -public abstract class Expression { - - public abstract int interpret(); - - @Override - public abstract String toString(); -} +package com.iluwatar.interpreter; + +/** + * + * Expression + * + */ +public abstract class Expression { + + public abstract int interpret(); + + @Override + public abstract String toString(); +} diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java index 03d088604..d26f977da 100644 --- a/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java +++ b/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java @@ -1,23 +1,28 @@ -package com.iluwatar.interpreter; - -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 "-"; - } - -} +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 "-"; + } + +} diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java index fa30e4236..9feada7ee 100644 --- a/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java +++ b/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java @@ -1,24 +1,29 @@ -package com.iluwatar.interpreter; - -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 "*"; - } - -} +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 "*"; + } + +} diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java index 041ddccae..0cf6b034a 100644 --- a/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java +++ b/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java @@ -1,25 +1,30 @@ -package com.iluwatar.interpreter; - -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"; - } - -} +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"; + } + +} diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java index 843a66b62..f244fa946 100644 --- a/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java +++ b/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java @@ -1,23 +1,28 @@ -package com.iluwatar.interpreter; - -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 "+"; - } - -} +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 "+"; + } + +} diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java index f89150159..b0e486833 100644 --- a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java +++ b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.interpreter; - -import org.junit.Test; - -import com.iluwatar.interpreter.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.interpreter; + +import org.junit.Test; + +import com.iluwatar.interpreter.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 0d2e033df6f7526ed281d4f2be45f4fe9b6dcbe1 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Tue, 18 Aug 2015 23:14:04 +0300 Subject: [PATCH 126/687] #107 Iterator example JavaDoc --- .../main/java/com/iluwatar/iterator/App.java | 86 ++++++++------- .../main/java/com/iluwatar/iterator/Item.java | 55 +++++----- .../com/iluwatar/iterator/ItemIterator.java | 26 ++--- .../java/com/iluwatar/iterator/ItemType.java | 19 ++-- .../com/iluwatar/iterator/TreasureChest.java | 78 ++++++------- .../iterator/TreasureChestItemIterator.java | 103 +++++++++--------- .../java/com/iluwatar/iterator/AppTest.java | 33 +++--- 7 files changed, 212 insertions(+), 188 deletions(-) diff --git a/iterator/src/main/java/com/iluwatar/iterator/App.java b/iterator/src/main/java/com/iluwatar/iterator/App.java index 22a6ea2d7..5b59cbcbc 100644 --- a/iterator/src/main/java/com/iluwatar/iterator/App.java +++ b/iterator/src/main/java/com/iluwatar/iterator/App.java @@ -1,41 +1,45 @@ -package com.iluwatar.iterator; - -/** - * - * Iterator (ItemIterator) adds abstraction layer on top of a collection - * (TreasureChest). This way the collection can change its internal - * implementation without affecting its clients. - * - */ -public class App { - - public static void main(String[] args) { - TreasureChest chest = new TreasureChest(); - - ItemIterator ringIterator = chest.Iterator(ItemType.RING); - while (ringIterator.hasNext()) { - System.out.println(ringIterator.next()); - } - - System.out.println("----------"); - - ItemIterator potionIterator = chest.Iterator(ItemType.POTION); - while (potionIterator.hasNext()) { - System.out.println(potionIterator.next()); - } - - System.out.println("----------"); - - ItemIterator weaponIterator = chest.Iterator(ItemType.WEAPON); - while (weaponIterator.hasNext()) { - System.out.println(weaponIterator.next()); - } - - System.out.println("----------"); - - ItemIterator it = chest.Iterator(ItemType.ANY); - while (it.hasNext()) { - System.out.println(it.next()); - } - } -} +package com.iluwatar.iterator; + +/** + * + * 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 { + + /** + * 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()) { + System.out.println(ringIterator.next()); + } + + System.out.println("----------"); + + ItemIterator potionIterator = chest.Iterator(ItemType.POTION); + while (potionIterator.hasNext()) { + System.out.println(potionIterator.next()); + } + + System.out.println("----------"); + + ItemIterator weaponIterator = chest.Iterator(ItemType.WEAPON); + while (weaponIterator.hasNext()) { + System.out.println(weaponIterator.next()); + } + + System.out.println("----------"); + + ItemIterator it = chest.Iterator(ItemType.ANY); + while (it.hasNext()) { + System.out.println(it.next()); + } + } +} diff --git a/iterator/src/main/java/com/iluwatar/iterator/Item.java b/iterator/src/main/java/com/iluwatar/iterator/Item.java index c22eba96f..4df167c6f 100644 --- a/iterator/src/main/java/com/iluwatar/iterator/Item.java +++ b/iterator/src/main/java/com/iluwatar/iterator/Item.java @@ -1,25 +1,30 @@ -package com.iluwatar.iterator; - -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 void setType(ItemType type) { - this.type = type; - } -} +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 void setType(ItemType type) { + this.type = type; + } +} diff --git a/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java b/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java index b18cd608e..91b5b62c0 100644 --- a/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java +++ b/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java @@ -1,13 +1,13 @@ -package com.iluwatar.iterator; - -/** - * - * Iterator interface. - * - */ -public interface ItemIterator { - - boolean hasNext(); - - Item next(); -} +package com.iluwatar.iterator; + +/** + * + * ItemIterator interface. + * + */ +public interface ItemIterator { + + boolean hasNext(); + + Item next(); +} diff --git a/iterator/src/main/java/com/iluwatar/iterator/ItemType.java b/iterator/src/main/java/com/iluwatar/iterator/ItemType.java index a3d4d3f54..288590c31 100644 --- a/iterator/src/main/java/com/iluwatar/iterator/ItemType.java +++ b/iterator/src/main/java/com/iluwatar/iterator/ItemType.java @@ -1,7 +1,12 @@ -package com.iluwatar.iterator; - -public enum ItemType { - - ANY, WEAPON, RING, POTION - -} +package com.iluwatar.iterator; + +/** + * + * ItemType enumeration + * + */ +public enum ItemType { + + ANY, WEAPON, RING, POTION + +} diff --git a/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java b/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java index e20269023..f4e1337bc 100644 --- a/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java +++ b/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java @@ -1,39 +1,39 @@ -package com.iluwatar.iterator; - -import java.util.ArrayList; -import java.util.List; - -/** - * - * Collection class. - * - */ -public class TreasureChest { - - private List items; - - 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 type) { - return new TreasureChestItemIterator(this, type); - } - - public List getItems() { - ArrayList list = new ArrayList<>(); - list.addAll(items); - return list; - } - -} +package com.iluwatar.iterator; + +import java.util.ArrayList; +import java.util.List; + +/** + * + * TreasureChest, the collection class. + * + */ +public class TreasureChest { + + private List items; + + 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 type) { + return new TreasureChestItemIterator(this, type); + } + + public List getItems() { + ArrayList list = new ArrayList<>(); + list.addAll(items); + return list; + } + +} diff --git a/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java b/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java index fca50725d..1a6daef4e 100644 --- a/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java +++ b/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java @@ -1,49 +1,54 @@ -package com.iluwatar.iterator; - -import java.util.List; - -public class TreasureChestItemIterator implements ItemIterator { - - private TreasureChest chest; - private int idx; - private ItemType type; - - 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; - } -} +package com.iluwatar.iterator; + +import java.util.List; + +/** + * + * TreasureChestItemIterator + * + */ +public class TreasureChestItemIterator implements ItemIterator { + + private TreasureChest chest; + private int idx; + private ItemType type; + + 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; + } +} diff --git a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java index ffdbb9ba1..1c1d65e34 100644 --- a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java +++ b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.iterator; - -import org.junit.Test; - -import com.iluwatar.iterator.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.iterator; + +import org.junit.Test; + +import com.iluwatar.iterator.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 5295ad6c2f1625268f30d5bb9939d1e7af657198 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 19 Aug 2015 22:00:36 +0300 Subject: [PATCH 127/687] #107 Added missing test for Layers example --- .../java/com/iluwatar/layers/AppTest.java | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 layers/src/test/java/com/iluwatar/layers/AppTest.java diff --git a/layers/src/test/java/com/iluwatar/layers/AppTest.java b/layers/src/test/java/com/iluwatar/layers/AppTest.java new file mode 100644 index 000000000..e55ab4f84 --- /dev/null +++ b/layers/src/test/java/com/iluwatar/layers/AppTest.java @@ -0,0 +1,19 @@ +package com.iluwatar.layers; + +import org.junit.Test; + +import com.iluwatar.layers.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 48cb04f98af5a8d2248a26ae2fd0ee87a0820e0e Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 19 Aug 2015 22:03:03 +0300 Subject: [PATCH 128/687] #107 JavaDoc improvements for Layers example --- layers/src/main/java/com/iluwatar/layers/App.java | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java index 3ab5e211e..bac946265 100644 --- a/layers/src/main/java/com/iluwatar/layers/App.java +++ b/layers/src/main/java/com/iluwatar/layers/App.java @@ -4,33 +4,22 @@ 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 @@ -41,7 +30,6 @@ import java.util.Arrays; * 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 From add57d4066e78f200b0a884cb36ba799a6566b11 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 19 Aug 2015 22:09:54 +0300 Subject: [PATCH 129/687] #107 Improve JavaDoc for Lazy Loading example --- .../src/main/java/com/iluwatar/lazy/loading/App.java | 8 ++++++-- .../main/java/com/iluwatar/lazy/loading/Java8Holder.java | 4 ++-- .../src/test/java/com/iluwatar/lazy/loading/AppTest.java | 5 +++++ 3 files changed, 13 insertions(+), 4 deletions(-) diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java index f12d4e20c..db09c781b 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java @@ -3,16 +3,20 @@ package com.iluwatar.lazy.loading; /** * * 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 { + /** + * Program entry point + * @param args command line args + */ public static void main( String[] args ) { // Simple lazy loader - not thread safe diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java index 6bd2382c1..a03aae352 100644 --- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java +++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java @@ -4,8 +4,8 @@ import java.util.function.Supplier; /** * - * This lazy loader is thread safe and more efficient than HolderThreadSafe. - * It utilizes Java 8 functional interface Supplier as Heavy factory. + * 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 { diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java index 96e88e75f..0ef7e8ae2 100644 --- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java +++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.lazy.loading.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 252f93899f8f642293ef05e4436d0a98a31ce281 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 19 Aug 2015 22:12:05 +0300 Subject: [PATCH 130/687] #107 Improve JavaDoc for Mediator example --- .../main/java/com/iluwatar/mediator/App.java | 70 ++++++++++--------- .../com/iluwatar/mediator/PartyMember.java | 30 ++++---- .../java/com/iluwatar/mediator/AppTest.java | 33 +++++---- 3 files changed, 71 insertions(+), 62 deletions(-) diff --git a/mediator/src/main/java/com/iluwatar/mediator/App.java b/mediator/src/main/java/com/iluwatar/mediator/App.java index 6c5233d26..a7df7d39f 100644 --- a/mediator/src/main/java/com/iluwatar/mediator/App.java +++ b/mediator/src/main/java/com/iluwatar/mediator/App.java @@ -1,33 +1,37 @@ -package com.iluwatar.mediator; - -/** - * - * Mediator encapsulates how a set of objects (PartyMember) interact. Instead of - * referring to each other directly they use a mediator (Party) interface. - * - */ -public class App { - - 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); - } -} +package com.iluwatar.mediator; + +/** + * + * Mediator encapsulates how a set of objects ({@link PartyMember}) interact. Instead of + * referring to each other directly they use a 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); + } +} diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java b/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java index 4dbfd450b..fffe6dd39 100644 --- a/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java +++ b/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java @@ -1,15 +1,15 @@ -package com.iluwatar.mediator; - -/** - * - * Interface for party members interacting with Party. - * - */ -public interface PartyMember { - - void joinedParty(Party party); - - void partyAction(Action action); - - void act(Action action); -} +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); +} diff --git a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java index 79bd9478d..2b614b003 100644 --- a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java +++ b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.mediator; - -import org.junit.Test; - -import com.iluwatar.mediator.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.mediator; + +import org.junit.Test; + +import com.iluwatar.mediator.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 8701833d836c9b8fc91fb301aa3636efbcb8c778 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 19 Aug 2015 22:13:40 +0300 Subject: [PATCH 131/687] #107 Improve JavaDoc for Memento example --- .../main/java/com/iluwatar/memento/App.java | 72 +++++++++---------- .../java/com/iluwatar/memento/StarType.java | 39 +++++----- .../java/com/iluwatar/memento/AppTest.java | 33 +++++---- 3 files changed, 77 insertions(+), 67 deletions(-) diff --git a/memento/src/main/java/com/iluwatar/memento/App.java b/memento/src/main/java/com/iluwatar/memento/App.java index 9411cb4fd..623ffb00e 100644 --- a/memento/src/main/java/com/iluwatar/memento/App.java +++ b/memento/src/main/java/com/iluwatar/memento/App.java @@ -1,36 +1,36 @@ -package com.iluwatar.memento; - -import java.util.Stack; - -/** - * - * Memento pattern is for storing and restoring object state. The object (Star) - * gives out a "memento" (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 { - - public static void main(String[] args) { - Stack states = new Stack<>(); - - Star star = new Star(StarType.SUN, 10000000, 500000); - System.out.println(star); - states.add(star.getMemento()); - star.timePasses(); - System.out.println(star); - states.add(star.getMemento()); - star.timePasses(); - System.out.println(star); - states.add(star.getMemento()); - star.timePasses(); - System.out.println(star); - states.add(star.getMemento()); - star.timePasses(); - System.out.println(star); - while (states.size() > 0) { - star.setMemento(states.pop()); - System.out.println(star); - } - } -} +package com.iluwatar.memento; + +import java.util.Stack; + +/** + * + * Memento pattern is for storing and restoring object state. 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 { + + public static void main(String[] args) { + Stack states = new Stack<>(); + + Star star = new Star(StarType.SUN, 10000000, 500000); + System.out.println(star); + states.add(star.getMemento()); + star.timePasses(); + System.out.println(star); + states.add(star.getMemento()); + star.timePasses(); + System.out.println(star); + states.add(star.getMemento()); + star.timePasses(); + System.out.println(star); + states.add(star.getMemento()); + star.timePasses(); + System.out.println(star); + while (states.size() > 0) { + star.setMemento(states.pop()); + System.out.println(star); + } + } +} diff --git a/memento/src/main/java/com/iluwatar/memento/StarType.java b/memento/src/main/java/com/iluwatar/memento/StarType.java index 442025525..bae853097 100644 --- a/memento/src/main/java/com/iluwatar/memento/StarType.java +++ b/memento/src/main/java/com/iluwatar/memento/StarType.java @@ -1,17 +1,22 @@ -package com.iluwatar.memento; - -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; - } -} +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; + } +} diff --git a/memento/src/test/java/com/iluwatar/memento/AppTest.java b/memento/src/test/java/com/iluwatar/memento/AppTest.java index 72bd5946d..84afd5945 100644 --- a/memento/src/test/java/com/iluwatar/memento/AppTest.java +++ b/memento/src/test/java/com/iluwatar/memento/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.memento; - -import org.junit.Test; - -import com.iluwatar.memento.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.memento; + +import org.junit.Test; + +import com.iluwatar.memento.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From ef887e6003a46a7cd8cbfb8479969cf0cf91aabb Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 19 Aug 2015 22:15:49 +0300 Subject: [PATCH 132/687] #107 Improve JavaDoc for Model-View-Controller example --- .../java/com/iluwatar/model/view/controller/App.java | 12 ++++++++---- .../com/iluwatar/model/view/controller/AppTest.java | 5 +++++ 2 files changed, 13 insertions(+), 4 deletions(-) diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java index e3d61302e..0ba34b5d4 100644 --- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java @@ -4,19 +4,23 @@ 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 (GiantModel) with statuses for health, fatigue and nourishment. GiantView - * can display the giant with its current status. GiantController receives input affecting the model and + *

+ * 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); diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java index b6e2f1bff..4bb31f6e6 100644 --- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java +++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.model.view.controller.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 9691a371e68cc33c8e530d94a2f7d2b788b78998 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Thu, 20 Aug 2015 11:52:20 +0530 Subject: [PATCH 133/687] Work on #221 documented agreed guideline in README Agreed guideline is conveyed and configuration link for eclipse and IntelliJ is also added. --- README.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0f374e9de..08fcc4b70 100644 --- a/README.md +++ b/README.md @@ -228,10 +228,13 @@ Flyweight. 3. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. -4. Create a simple class diagram from your example code and put it inside of the etc folder. -5. Add description of the pattern in index.md and link to the class diagram. +4. Format the code according to [Google Java Style Guide](https://google.github.io/styleguide/javaguide.html) + * [Eclipse configuration](https://github.com/google/styleguide/blob/gh-pages/eclipse-java-google-style.xml) + * [IntelliJ configuration](https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml) +5. Create a simple class diagram from your example code and put it inside of the etc folder. +6. Add description of the pattern in index.md and link to the class diagram. (Attention, all internal links must be relative to the pattern subdirectory, else the links dont link properly on the website) -6. Create a pull request. +7. Create a pull request. **Structure of the index.md file** From e8c8e26c8b90032631074a139055670a7ceab16d Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 20 Aug 2015 22:29:44 +0300 Subject: [PATCH 134/687] #107 Improve JavaDoc and change main class name for Model-View-Presenter example --- .../view/presenter/{MainApp.java => App.java} | 18 +++++++++++------- .../model/view/presenter/FileLoader.java | 6 ++---- .../view/presenter/FileSelectorJFrame.java | 2 +- .../view/presenter/FileSelectorPresenter.java | 12 ++++-------- .../model/view/presenter/FileSelectorStub.java | 4 ++-- .../model/view/presenter/FileSelectorView.java | 16 ++++------------ 6 files changed, 24 insertions(+), 34 deletions(-) rename model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/{MainApp.java => App.java} (65%) diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/MainApp.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java similarity index 65% rename from model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/MainApp.java rename to model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java index 73da4f733..ac6ccf091 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/MainApp.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java @@ -4,19 +4,23 @@ 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 FileLoader class represents the app's logic, - * the FileSelectorJFrame is the GUI and the FileSelectorPresenter is + * 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 MainApp { +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(); diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java index aef5bade9..96d843f83 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java @@ -7,7 +7,7 @@ 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 { @@ -51,9 +51,7 @@ public class FileLoader { /** * Sets the path of the file to be loaded, to the given value. - * - * @param fileName - * The path of the file to be loaded. + * @param fileName The path of the file to be loaded. */ public void setFileName(String fileName) { this.fileName = fileName; diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java index be3c253ed..f4d24f59f 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java @@ -14,7 +14,7 @@ import javax.swing.JTextArea; import javax.swing.JTextField; /** - * This class is the GUI implementation of the View component In the + * This class is the GUI implementation of the View component in the * Model-View-Presenter pattern. */ public class FileSelectorJFrame extends JFrame implements FileSelectorView, diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java index a7842e932..7119d60bf 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java @@ -3,7 +3,7 @@ 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. */ @@ -21,19 +21,15 @@ public class FileSelectorPresenter { /** * Constructor - * - * @param view - * The view component that the presenter will interact with. + * @param view The view component that the presenter will interact with. */ public FileSelectorPresenter(FileSelectorView view) { this.view = view; } /** - * Sets the FileLoader object, to the value given as parameter. - * - * @param loader - * The new FileLoader object(the Model component). + * 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; diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java index 7aa88e922..d0cec4c40 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java @@ -3,10 +3,10 @@ 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. */ diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java index e4a7efaee..8cd265f9b 100644 --- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java +++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java @@ -23,9 +23,7 @@ public interface FileSelectorView { /** * Sets the presenter component, to the one given as parameter. - * - * @param presenter - * The new presenter component. + * @param presenter The new presenter component. */ public void setPresenter(FileSelectorPresenter presenter); @@ -36,9 +34,7 @@ public interface FileSelectorView { /** * Sets the file's name, to the value given as parameter. - * - * @param name - * The new name of the file. + * @param name The new name of the file. */ public void setFileName(String name); @@ -49,17 +45,13 @@ public interface FileSelectorView { /** * Displays a message to the users. - * - * @param message - * The message to be displayed. + * @param message The message to be displayed. */ public void showMessage(String message); /** * Displays the data to the view. - * - * @param data - * The data to be written. + * @param data The data to be written. */ public void displayData(String data); } From 952ebc638fa06d4cc5c20030ac1ac67bb083eeb9 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 20 Aug 2015 22:35:57 +0300 Subject: [PATCH 135/687] #107 Improvements for Multiton JavaDoc --- multiton/src/main/java/com/iluwatar/multiton/App.java | 10 +++++++--- .../src/main/java/com/iluwatar/multiton/Nazgul.java | 2 +- .../main/java/com/iluwatar/multiton/NazgulName.java | 2 +- .../src/test/java/com/iluwatar/multiton/AppTest.java | 5 +++++ 4 files changed, 14 insertions(+), 5 deletions(-) diff --git a/multiton/src/main/java/com/iluwatar/multiton/App.java b/multiton/src/main/java/com/iluwatar/multiton/App.java index 7e3da2123..9f2c5da78 100644 --- a/multiton/src/main/java/com/iluwatar/multiton/App.java +++ b/multiton/src/main/java/com/iluwatar/multiton/App.java @@ -6,14 +6,18 @@ package com.iluwatar.multiton; * 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 Nazgul is the Multiton and we can ask single - * Nazgul from it using NazgulName. The Nazguls are statically + *

+ * 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 { + /** + * Program entry point + * @param args command line args + */ public static void main( String[] args ) { System.out.println("KHAMUL=" + Nazgul.getInstance(NazgulName.KHAMUL)); System.out.println("MURAZOR=" + Nazgul.getInstance(NazgulName.MURAZOR)); diff --git a/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java b/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java index a099f9322..833923f75 100644 --- a/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java +++ b/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java @@ -6,7 +6,7 @@ import java.util.concurrent.ConcurrentHashMap; /** * * Nazgul is a Multiton class. Nazgul instances can be queried - * using getInstance() method. + * using {@link #getInstance} method. * */ public class Nazgul { diff --git a/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java b/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java index f0db192a4..cef1e43a9 100644 --- a/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java +++ b/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java @@ -2,7 +2,7 @@ package com.iluwatar.multiton; /** * - * Each Nazgul has different NazgulName. + * Each Nazgul has different {@link NazgulName}. * */ public enum NazgulName { diff --git a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java index 9f5f96792..439f08e24 100644 --- a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java +++ b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.multiton.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 5ce932ceb7768e9f8f975524af9758f614ef68ee Mon Sep 17 00:00:00 2001 From: Markus Date: Thu, 20 Aug 2015 21:40:07 +0200 Subject: [PATCH 136/687] Work on #213 - properly categorize all patterns - remove pattern list from readme - minor fixes to readme - removed "introduction" because its not a pattern and an error i committed some time ago --- README.md | 148 ++---------------- abstract-factory/index.md | 6 +- adapter/index.md | 4 +- async-method-invocation/index.md | 4 +- bridge/index.md | 4 +- builder/index.md | 4 +- business-delegate/index.md | 4 +- callback/index.md | 4 +- chain-of-responsibility/index.md | 4 +- command/index.md | 4 +- composite/index.md | 4 +- dao/index.md | 4 +- decorator/index.md | 4 +- dependency-injection/index.md | 4 +- double-checked-locking/index.md | 4 +- double-dispatch/index.md | 4 +- event-aggregator/index.md | 4 +- execute-around/index.md | 4 +- facade/index.md | 4 +- factory-method/index.md | 4 +- flux/index.md | 4 +- flyweight/index.md | 4 +- front-controller/index.md | 4 +- half-sync-half-async/index.md | 4 +- intercepting-filter/index.md | 4 +- interpreter/index.md | 4 +- introduction/index.md | 20 --- iterator/index.md | 4 +- layers/index.md | 4 +- lazy-loading/index.md | 4 +- mediator/index.md | 4 +- memento/index.md | 4 +- model-view-controller/index.md | 4 +- model-view-presenter/index.md | 4 +- multiton/index.md | 4 +- naked-objects/index.md | 4 +- null-object/index.md | 4 +- object-pool/index.md | 4 +- observer/index.md | 4 +- poison-pill/index.md | 4 +- private-class-data/index.md | 4 +- property/index.md | 4 +- prototype/index.md | 4 +- proxy/index.md | 4 +- repository/index.md | 4 +- .../index.md | 4 +- servant/index.md | 4 +- service-layer/index.md | 4 +- service-locator/index.md | 4 +- singleton/index.md | 4 +- specification/index.md | 4 +- state/index.md | 4 +- step-builder/index.md | 4 +- strategy/index.md | 4 +- template-method/index.md | 4 +- thread-pool/index.md | 4 +- tolerant-reader/index.md | 4 +- visitor/index.md | 4 +- 58 files changed, 129 insertions(+), 265 deletions(-) delete mode 100644 introduction/index.md diff --git a/README.md b/README.md index 08fcc4b70..4724ea332 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,8 @@ -# Design pattern samples in Java. + + +# Design pattern samples in Java [![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) @@ -7,24 +11,19 @@ src="https://scan.coverity.com/projects/5634/badge.svg"/> - + +#### Browse and view all of the patterns on our Website: [iluwatar.github.io/java-design-patterns/](https://iluwatar.github.io/java-design-patterns/) + + + +# Table of Contents - Introduction - - List of Design Patterns - - Creational Patterns - - Structural Patterns - - Behavioral Patterns - - Concurrency Patterns - - Presentation Tier Patterns - - Business Tier Patterns - - Architectural Patterns - - Integration Patterns - - Idioms - Frequently Asked Questions - How to contribute - Versioning - Credits - License - + ## Introduction @@ -38,119 +37,6 @@ 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. -## List of Design Patterns [↑](#top) - -### Creational Patterns [↑](#top) - -Creational design patterns abstract the instantiation process. They help make a -system independent of how its objects are created, composed, and represented. - -* [Abstract Factory](#abstract-factory) -* [Builder](#builder) -* [Factory Method](#factory-method) -* [Prototype](#prototype) -* [Property](#property) -* [Singleton](#singleton) -* [Step Builder](#step-builder) -* [Multiton](#multiton) -* [Object Pool](#object-pool) - -### Structural Patterns [↑](#top) - -Structural patterns are concerned with how classes and objects are composed to -form larger structures. - -* [Adapter](#adapter) -* [Bridge](#bridge) -* [Composite](#composite) -* [Decorator](#decorator) -* [Facade](#facade) -* [Flyweight](#flyweight) -* [Proxy](#proxy) -* [Service Locator](#service-locator) -* [Servant](#servant) -* [Event Aggregator](#event-aggregator) - -### Behavioral Patterns [↑](#top) - -Behavioral patterns are concerned with algorithms and the assignment of -responsibilities between objects. - -* [Chain of responsibility](#chain-of-responsibility) -* [Command](#command) -* [Interpreter](#interpreter) -* [Iterator](#iterator) -* [Mediator](#mediator) -* [Memento](#memento) -* [Observer](#observer) -* [State](#state) -* [Strategy](#strategy) -* [Template method](#template-method) -* [Visitor](#visitor) -* [Null Object](#null-object) -* [Intercepting Filter](#intercepting-filter) -* [Specification](#specification) -* [Dependency Injection](#dependency-injection) - -### Concurrency Patterns [↑](#top) - -Concurrency patterns are those types of design patterns that deal with the -multi-threaded programming paradigm. - -* [Double Checked Locking](#double-checked-locking) -* [Thread Pool](#thread-pool) -* [Async Method Invocation](#async-method-invocation) -* [Half-Sync/Half-Async](#half-sync-half-async) - -### Presentation Tier Patterns [↑](#top) - -Presentation Tier patterns are the top-most level of the application, this is -concerned with translating tasks and results to something the user can -understand. - -* [Model-View-Controller](#model-view-controller) -* [Model-View-Presenter](#model-view-presenter) -* [Flux](#flux) -* [Front Controller](#front-controller) - -### Business Tier Patterns [↑](#top) - -* [Business Delegate](#business-delegate) - -### Architectural Patterns [↑](#top) - -An architectural pattern is a general, reusable solution to a commonly occurring -problem in software architecture within a given context. - -* [Data Access Object](#dao) -* [Service Layer](#service-layer) -* [Naked Objects](#naked-objects) -* [Repository](#repository) - -### Integration Patterns [↑](#top) - -Integration patterns are concerned with how software applications communicate -and exchange data. - -* [Tolerant Reader](#tolerant-reader) - -### Idioms [↑](#top) - -A programming idiom is a means of expressing a recurring construct in one or -more programming languages. Generally speaking, a programming idiom is an -expression of a simple task, algorithm, or data structure that is not a built-in -feature in the programming language being used, or, conversely, the use of an -unusual or notable feature that is built into a programming language. What -distinguishes idioms from patterns is generally the size, the idioms tend to be -something small while the patterns are larger. - -* [Execute Around](#execute-around) -* [Poison Pill](#poison-pill) -* [Callback](#callback) -* [Lazy Loading](#lazy-loading) -* [Double Dispatch](#double-dispatch) -* [Resource Acquisition Is Initialization](#resource-acquisition-is-initialization) -* [Private Class Data](#private-class-data) # Frequently asked questions [↑](#top) @@ -225,16 +111,16 @@ Flyweight. * src (the source code of the pattern) * index.md (the description of the pattern) * pom.xml (the maven pom.xml) -3. Implement the code changes in your fork. Remember to add sufficient comments +4. Implement the code changes in your fork. Remember to add sufficient comments documenting the implementation. Reference the issue id e.g. #52 in your commit messages. -4. Format the code according to [Google Java Style Guide](https://google.github.io/styleguide/javaguide.html) +5. Format the code according to [Google Java Style Guide](https://google.github.io/styleguide/javaguide.html) * [Eclipse configuration](https://github.com/google/styleguide/blob/gh-pages/eclipse-java-google-style.xml) * [IntelliJ configuration](https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml) -5. Create a simple class diagram from your example code and put it inside of the etc folder. -6. Add description of the pattern in index.md and link to the class diagram. +6. Create a simple class diagram from your example code and put it inside of the etc folder. +7. Add description of the pattern in index.md and link to the class diagram. (Attention, all internal links must be relative to the pattern subdirectory, else the links dont link properly on the website) -7. Create a pull request. +8. Create a pull request. **Structure of the index.md file** diff --git a/abstract-factory/index.md b/abstract-factory/index.md index 412e16009..cb229f4ab 100644 --- a/abstract-factory/index.md +++ b/abstract-factory/index.md @@ -3,10 +3,8 @@ layout: pattern title: Abstract Factory folder: abstract-factory permalink: /patterns/abstract-factory/ -categories: - - pattern_cat - - creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Provide an interface for creating families of related or dependent diff --git a/adapter/index.md b/adapter/index.md index ee94ef47c..23aaeadcc 100644 --- a/adapter/index.md +++ b/adapter/index.md @@ -3,8 +3,8 @@ layout: pattern title: Adapter folder: adapter permalink: /patterns/adapter/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Convert the interface of a class into another interface the clients diff --git a/async-method-invocation/index.md b/async-method-invocation/index.md index fdc30606e..dfcee0208 100644 --- a/async-method-invocation/index.md +++ b/async-method-invocation/index.md @@ -3,8 +3,8 @@ layout: pattern title: Async Method Invocation folder: async-method-invocation permalink: /patterns/async-method-invocation/ -categories: concurrency -tags: pattern_tag +categories: Concurrency +tags: Java --- **Intent:** Asynchronous method invocation is pattern where the calling thread diff --git a/bridge/index.md b/bridge/index.md index 9983dab40..8c05f14cf 100644 --- a/bridge/index.md +++ b/bridge/index.md @@ -3,8 +3,8 @@ layout: pattern title: Bridge folder: bridge permalink: /patterns/bridge/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Decouple an abstraction from its implementation so that the two can diff --git a/builder/index.md b/builder/index.md index 78fb61fea..aa5c86201 100644 --- a/builder/index.md +++ b/builder/index.md @@ -3,8 +3,8 @@ layout: pattern title: Builder folder: builder permalink: /patterns/builder/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Separate the construction of a complex object from its diff --git a/business-delegate/index.md b/business-delegate/index.md index af3c2108d..a55febaf9 100644 --- a/business-delegate/index.md +++ b/business-delegate/index.md @@ -3,8 +3,8 @@ layout: pattern title: Business Delegate folder: business-delegate permalink: /patterns/business-delegate/ -categories: business_tier -tags: pattern_tag +categories: Business Tier +tags: Java --- **Intent:** The Business Delegate pattern adds an abstraction layer between diff --git a/callback/index.md b/callback/index.md index 1d65e1514..b724f1edc 100644 --- a/callback/index.md +++ b/callback/index.md @@ -3,8 +3,8 @@ layout: pattern title: Callback folder: callback permalink: /patterns/callback/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Callback is a piece of executable code that is passed as an diff --git a/chain-of-responsibility/index.md b/chain-of-responsibility/index.md index 0dd250cbd..cf56fe3c6 100644 --- a/chain-of-responsibility/index.md +++ b/chain-of-responsibility/index.md @@ -3,8 +3,8 @@ layout: pattern title: Chain of responsibility folder: chain-of-responsibility permalink: /patterns/chain-of-responsibility/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Avoid coupling the sender of a request to its receiver by giving diff --git a/command/index.md b/command/index.md index df512d023..23582406e 100644 --- a/command/index.md +++ b/command/index.md @@ -3,8 +3,8 @@ layout: pattern title: Command folder: command permalink: /patterns/command/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Encapsulate a request as an object, thereby letting you diff --git a/composite/index.md b/composite/index.md index f50c32dd3..374e1d5aa 100644 --- a/composite/index.md +++ b/composite/index.md @@ -3,8 +3,8 @@ layout: pattern title: Composite folder: composite permalink: /patterns/composite/ -categories: pattern_cat -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Compose objects into tree structures to represent part-whole diff --git a/dao/index.md b/dao/index.md index de481b3a5..7fd936c12 100644 --- a/dao/index.md +++ b/dao/index.md @@ -3,8 +3,8 @@ layout: pattern title: Data Access Object folder: dao permalink: /patterns/dao/ -categories: architectural -tags: pattern_tag +categories: Architectural +tags: Java --- **Intent:** Object provides an abstract interface to some type of database or diff --git a/decorator/index.md b/decorator/index.md index 0570935ca..02f129258 100644 --- a/decorator/index.md +++ b/decorator/index.md @@ -3,8 +3,8 @@ layout: pattern title: Decorator folder: decorator permalink: /patterns/decorator/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Attach additional responsibilities to an object dynamically. diff --git a/dependency-injection/index.md b/dependency-injection/index.md index 884fdb502..f6ead97a7 100644 --- a/dependency-injection/index.md +++ b/dependency-injection/index.md @@ -3,8 +3,8 @@ layout: pattern title: Dependency Injection folder: dependency-injection permalink: /patterns/dependency-injection/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Dependency Injection is a software design pattern in which one or diff --git a/double-checked-locking/index.md b/double-checked-locking/index.md index 371048b12..b1b0108ec 100644 --- a/double-checked-locking/index.md +++ b/double-checked-locking/index.md @@ -3,8 +3,8 @@ layout: pattern title: Double Checked Locking folder: double-checked-locking permalink: /patterns/double-checked-locking/ -categories: concurrency -tags: pattern_tag +categories: Concurrency +tags: Java --- **Intent:** Reduce the overhead of acquiring a lock by first testing the diff --git a/double-dispatch/index.md b/double-dispatch/index.md index 842913738..6847b7a41 100644 --- a/double-dispatch/index.md +++ b/double-dispatch/index.md @@ -3,8 +3,8 @@ layout: pattern title: Double Dispatch folder: double-dispatch permalink: /patterns/double-dispatch/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Double Dispatch pattern is a way to create maintainable dynamic diff --git a/event-aggregator/index.md b/event-aggregator/index.md index d27d3423e..fd42e9811 100644 --- a/event-aggregator/index.md +++ b/event-aggregator/index.md @@ -3,8 +3,8 @@ layout: pattern title: Event Aggregator folder: event-aggregator permalink: /patterns/event-aggregator/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** A system with lots of objects can lead to complexities when a diff --git a/execute-around/index.md b/execute-around/index.md index ec4c040bf..56ece4ac4 100644 --- a/execute-around/index.md +++ b/execute-around/index.md @@ -3,8 +3,8 @@ layout: pattern title: Execute Around folder: execute-around permalink: /patterns/execute-around/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Execute Around idiom frees the user from certain actions that diff --git a/facade/index.md b/facade/index.md index a2aba225f..0f6e2fbb1 100644 --- a/facade/index.md +++ b/facade/index.md @@ -3,8 +3,8 @@ layout: pattern title: Facade folder: facade permalink: /patterns/facade/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Provide a unified interface to a set of interfaces in a subsystem. diff --git a/factory-method/index.md b/factory-method/index.md index 11ad77dda..fa30a4349 100644 --- a/factory-method/index.md +++ b/factory-method/index.md @@ -3,8 +3,8 @@ layout: pattern title: Factory Method folder: factory-method permalink: /patterns/factory-method/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Define an interface for creating an object, but let subclasses diff --git a/flux/index.md b/flux/index.md index 970ef051c..c96b2b56a 100644 --- a/flux/index.md +++ b/flux/index.md @@ -3,8 +3,8 @@ layout: pattern title: Flux folder: flux permalink: /patterns/flux/ -categories: presentation_tier -tags: pattern_tag +categories: Presentation Tier +tags: Java --- **Intent:** Flux eschews MVC in favor of a unidirectional data flow. When a diff --git a/flyweight/index.md b/flyweight/index.md index 2a804e769..699c1ed54 100644 --- a/flyweight/index.md +++ b/flyweight/index.md @@ -3,8 +3,8 @@ layout: pattern title: Flyweight folder: flyweight permalink: /patterns/flyweight/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Use sharing to support large numbers of fine-grained objects diff --git a/front-controller/index.md b/front-controller/index.md index 9c73ddb95..dd83bc396 100644 --- a/front-controller/index.md +++ b/front-controller/index.md @@ -3,8 +3,8 @@ layout: pattern title: Front Controller folder: front-controller permalink: /patterns/front-controller/ -categories: presentation_tier -tags: pattern_tag +categories: Presentation Tier +tags: Java --- **Intent:** Introduce a common handler for all requests for a web site. This diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md index 025ba605f..b21c97bc4 100644 --- a/half-sync-half-async/index.md +++ b/half-sync-half-async/index.md @@ -3,8 +3,8 @@ layout: pattern title: Half-Sync/Half-Async folder: half-sync-half-async permalink: /patterns/half-sync-half-async/ -categories: concurrency -tags: pattern_tag +categories: Concurrency +tags: Java --- **Intent:** The Half-Sync/Half-Async pattern decouples synchronous I/O from diff --git a/intercepting-filter/index.md b/intercepting-filter/index.md index b8fa2a7f6..66cf04b62 100644 --- a/intercepting-filter/index.md +++ b/intercepting-filter/index.md @@ -3,8 +3,8 @@ layout: pattern title: Intercepting Filter folder: intercepting-filter permalink: /patterns/intercepting-filter/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Provide pluggable filters to conduct necessary pre-processing and diff --git a/interpreter/index.md b/interpreter/index.md index d1ca73955..40030917a 100644 --- a/interpreter/index.md +++ b/interpreter/index.md @@ -3,8 +3,8 @@ layout: pattern title: Interpreter folder: interpreter permalink: /patterns/interpreter/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Given a language, define a representation for its grammar along diff --git a/introduction/index.md b/introduction/index.md deleted file mode 100644 index 14df55cee..000000000 --- a/introduction/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -layout: pattern -title: Introduction -folder: introduction -permalink: /patterns/introduction/ -permalink: /patterns/introduction/ -categories: pattern_cat -tags: pattern_tag ---- - - -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. diff --git a/iterator/index.md b/iterator/index.md index 8b185ff83..63bdaf516 100644 --- a/iterator/index.md +++ b/iterator/index.md @@ -3,8 +3,8 @@ layout: pattern title: Iterator folder: iterator permalink: /patterns/iterator/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Provide a way to access the elements of an aggregate object diff --git a/layers/index.md b/layers/index.md index bec7a5f14..1d12d3b4e 100644 --- a/layers/index.md +++ b/layers/index.md @@ -3,8 +3,8 @@ layout: pattern title: Layers folder: layers permalink: /patterns/layers/ -categories: architectural -tags: pattern_tag +categories: Architectural +tags: Java --- **Intent:** Layers is an architectural style where software responsibilities are diff --git a/lazy-loading/index.md b/lazy-loading/index.md index c1ecc1cf5..700892af0 100644 --- a/lazy-loading/index.md +++ b/lazy-loading/index.md @@ -3,8 +3,8 @@ layout: pattern title: Lazy Loading folder: lazy-loading permalink: /patterns/lazy-loading/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Lazy loading is a design pattern commonly used to defer diff --git a/mediator/index.md b/mediator/index.md index 735024298..e67218a53 100644 --- a/mediator/index.md +++ b/mediator/index.md @@ -3,8 +3,8 @@ layout: pattern title: Mediator folder: mediator permalink: /patterns/mediator/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Define an object that encapsulates how a set of objects interact. diff --git a/memento/index.md b/memento/index.md index 99dd9fad4..b91e34739 100644 --- a/memento/index.md +++ b/memento/index.md @@ -3,8 +3,8 @@ layout: pattern title: Memento folder: memento permalink: /patterns/memento/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Without violating encapsulation, capture and externalize an diff --git a/model-view-controller/index.md b/model-view-controller/index.md index f6390225e..5a12bc656 100644 --- a/model-view-controller/index.md +++ b/model-view-controller/index.md @@ -3,8 +3,8 @@ layout: pattern title: Model-View-Controller folder: model-view-controller permalink: /patterns/model-view-controller/ -categories: presentation_tier -tags: pattern_tag +categories: Presentation Tier +tags: Java --- **Intent:** Separate the user interface into three interconnected components: diff --git a/model-view-presenter/index.md b/model-view-presenter/index.md index d1ba373e3..6b0994077 100644 --- a/model-view-presenter/index.md +++ b/model-view-presenter/index.md @@ -3,8 +3,8 @@ layout: pattern title: Model-View-Presenter folder: model-view-presenter permalink: /patterns/model-view-presenter/ -categories: presentation_tier -tags: pattern_tag +categories: Presentation Tier +tags: Java --- **Intent:** Apply a "Separation of Concerns" principle in a way that allows diff --git a/multiton/index.md b/multiton/index.md index 47b9582b8..617bedb6a 100644 --- a/multiton/index.md +++ b/multiton/index.md @@ -3,8 +3,8 @@ layout: pattern title: Multiton folder: multiton permalink: /patterns/multiton/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Ensure a class only has limited number of instances, and provide a diff --git a/naked-objects/index.md b/naked-objects/index.md index 45f5bec86..cef2a9ede 100644 --- a/naked-objects/index.md +++ b/naked-objects/index.md @@ -3,8 +3,8 @@ layout: pattern title: Naked Objects folder: naked-objects permalink: /patterns/naked-objects/ -categories: architectural -tags: pattern_tag +categories: Architectural +tags: Java --- **Intent:** The Naked Objects architectural pattern is well suited for rapid diff --git a/null-object/index.md b/null-object/index.md index c7e89272b..5127e8565 100644 --- a/null-object/index.md +++ b/null-object/index.md @@ -3,8 +3,8 @@ layout: pattern title: Null Object folder: null-object permalink: /patterns/null-object/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** In most object-oriented languages, such as Java or C#, references diff --git a/object-pool/index.md b/object-pool/index.md index ac08006f7..276d9a1f6 100644 --- a/object-pool/index.md +++ b/object-pool/index.md @@ -3,8 +3,8 @@ layout: pattern title: Object Pool folder: object-pool permalink: /patterns/object-pool/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** When objects are expensive to create and they are needed only for diff --git a/observer/index.md b/observer/index.md index 10036336c..d5b380a30 100644 --- a/observer/index.md +++ b/observer/index.md @@ -3,8 +3,8 @@ layout: pattern title: Observer folder: observer permalink: /patterns/observer/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Define a one-to-many dependency between objects so that when one diff --git a/poison-pill/index.md b/poison-pill/index.md index 7d3b02bf4..cd60e1a68 100644 --- a/poison-pill/index.md +++ b/poison-pill/index.md @@ -3,8 +3,8 @@ layout: pattern title: Poison Pill folder: poison-pill permalink: /patterns/poison-pill/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Poison Pill is known predefined data item that allows to provide diff --git a/private-class-data/index.md b/private-class-data/index.md index b90ae654d..83c95d308 100644 --- a/private-class-data/index.md +++ b/private-class-data/index.md @@ -3,8 +3,8 @@ layout: pattern title: Private Class Data folder: private-class-data permalink: /patterns/private-class-data/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Private Class Data design pattern seeks to reduce exposure of diff --git a/property/index.md b/property/index.md index 802940f84..1c5b28db6 100644 --- a/property/index.md +++ b/property/index.md @@ -3,8 +3,8 @@ layout: pattern title: Property folder: property permalink: /patterns/property/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Create hierarchy of objects and new objects using already existing diff --git a/prototype/index.md b/prototype/index.md index 7db6e8513..cab97f7dc 100644 --- a/prototype/index.md +++ b/prototype/index.md @@ -3,8 +3,8 @@ layout: pattern title: Prototype folder: prototype permalink: /patterns/prototype/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Specify the kinds of objects to create using a prototypical diff --git a/proxy/index.md b/proxy/index.md index 4c29877f6..96ea40714 100644 --- a/proxy/index.md +++ b/proxy/index.md @@ -3,8 +3,8 @@ layout: pattern title: Proxy folder: proxy permalink: /patterns/proxy/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Provide a surrogate or placeholder for another object to control diff --git a/repository/index.md b/repository/index.md index 3421a2075..a65044d29 100644 --- a/repository/index.md +++ b/repository/index.md @@ -3,8 +3,8 @@ layout: pattern title: Repository folder: repository permalink: /patterns/repository/ -categories: architectural -tags: pattern_tag +categories: Architectural +tags: Java --- **Intent:** Repository layer is added between the domain and data mapping diff --git a/resource-acquisition-is-initialization/index.md b/resource-acquisition-is-initialization/index.md index 7b283ab8c..c3aa6c045 100644 --- a/resource-acquisition-is-initialization/index.md +++ b/resource-acquisition-is-initialization/index.md @@ -3,8 +3,8 @@ layout: pattern title: Resource Acquisition Is Initialization folder: resource-acquisition-is-initialization permalink: /patterns/resource-acquisition-is-initialization/ -categories: pattern_cat -tags: pattern_tag +categories: Other +tags: Java --- **Intent:** Resource Acquisition Is Initialization pattern can be used to implement exception safe resource management. diff --git a/servant/index.md b/servant/index.md index a4205b9c0..38a8e2c60 100644 --- a/servant/index.md +++ b/servant/index.md @@ -3,8 +3,8 @@ layout: pattern title: Servant folder: servant permalink: /patterns/servant/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Servant is used for providing some behavior to a group of classes. diff --git a/service-layer/index.md b/service-layer/index.md index d041c71ab..22afc1669 100644 --- a/service-layer/index.md +++ b/service-layer/index.md @@ -3,8 +3,8 @@ layout: pattern title: Service Layer folder: service-layer permalink: /patterns/service-layer/ -categories: architectural -tags: pattern_tag +categories: Architectural +tags: Java --- **Intent:** Service Layer is an abstraction over domain logic. Typically diff --git a/service-locator/index.md b/service-locator/index.md index 8bb12c01b..8c2aa6417 100644 --- a/service-locator/index.md +++ b/service-locator/index.md @@ -3,8 +3,8 @@ layout: pattern title: Service Locator folder: service-locator permalink: /patterns/service-locator/ -categories: structural -tags: pattern_tag +categories: Structural +tags: Java --- **Intent:** Encapsulate the processes involved in obtaining a service with a diff --git a/singleton/index.md b/singleton/index.md index b7aed47bb..7a280bdfa 100644 --- a/singleton/index.md +++ b/singleton/index.md @@ -3,8 +3,8 @@ layout: pattern title: Singleton folder: singleton permalink: /patterns/singleton/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** Ensure a class only has one instance, and provide a global point of diff --git a/specification/index.md b/specification/index.md index 81ed15e11..2609f50e5 100644 --- a/specification/index.md +++ b/specification/index.md @@ -3,8 +3,8 @@ layout: pattern title: Specification folder: specification permalink: /patterns/specification/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Specification pattern separates the statement of how to match a diff --git a/state/index.md b/state/index.md index b2e4cc2c7..1b1e4717f 100644 --- a/state/index.md +++ b/state/index.md @@ -3,8 +3,8 @@ layout: pattern title: State folder: state permalink: /patterns/state/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Allow an object to alter its behavior when its internal state diff --git a/step-builder/index.md b/step-builder/index.md index f3a7f2413..636504598 100644 --- a/step-builder/index.md +++ b/step-builder/index.md @@ -3,8 +3,8 @@ layout: pattern title: Step Builder folder: step-builder permalink: /patterns/step-builder/ -categories: creational -tags: pattern_tag +categories: Creational +tags: Java --- **Intent:** An extension of the Builder pattern that fully guides the user through the creation of the object with no chances of confusion. diff --git a/strategy/index.md b/strategy/index.md index 0f3dcd144..1d3250517 100644 --- a/strategy/index.md +++ b/strategy/index.md @@ -3,8 +3,8 @@ layout: pattern title: Strategy folder: strategy permalink: /patterns/strategy/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Define a family of algorithms, encapsulate each one, and make them diff --git a/template-method/index.md b/template-method/index.md index e0d1ceb14..f647d2cd5 100644 --- a/template-method/index.md +++ b/template-method/index.md @@ -3,8 +3,8 @@ layout: pattern title: Template method folder: template-method permalink: /patterns/template-method/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Define the skeleton of an algorithm in an operation, deferring some diff --git a/thread-pool/index.md b/thread-pool/index.md index 092c8b8a8..d9f00f428 100644 --- a/thread-pool/index.md +++ b/thread-pool/index.md @@ -3,8 +3,8 @@ layout: pattern title: Thread Pool folder: thread-pool permalink: /patterns/thread-pool/ -categories: concurrency -tags: pattern_tag +categories: Concurrency +tags: Java --- **Intent:** It is often the case that tasks to be executed are short-lived and diff --git a/tolerant-reader/index.md b/tolerant-reader/index.md index 75fa6ec70..7e0ef4f32 100644 --- a/tolerant-reader/index.md +++ b/tolerant-reader/index.md @@ -3,8 +3,8 @@ layout: pattern title: Tolerant Reader folder: tolerant-reader permalink: /patterns/tolerant-reader/ -categories: integration -tags: pattern_tag +categories: Integration +tags: Java --- **Intent:** Tolerant Reader is an integration pattern that helps creating diff --git a/visitor/index.md b/visitor/index.md index f9f5c87f8..eeb11a5e5 100644 --- a/visitor/index.md +++ b/visitor/index.md @@ -3,8 +3,8 @@ layout: pattern title: Visitor folder: visitor permalink: /patterns/visitor/ -categories: behavioral -tags: pattern_tag +categories: Behavioral +tags: Java --- **Intent:** Represent an operation to be performed on the elements of an object From 2bc23844a40a98cc21c3bf034f638d6c8713baf4 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 20 Aug 2015 22:42:49 +0300 Subject: [PATCH 137/687] #107 Improve JavaDoc for Null Object example --- null-object/src/main/java/com/iluwatar/nullobject/App.java | 6 +++++- .../src/main/java/com/iluwatar/nullobject/NullNode.java | 2 +- .../src/test/java/com/iluwatar/nullobject/AppTest.java | 5 +++++ 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/null-object/src/main/java/com/iluwatar/nullobject/App.java b/null-object/src/main/java/com/iluwatar/nullobject/App.java index 35b05061e..9cc4a14da 100644 --- a/null-object/src/main/java/com/iluwatar/nullobject/App.java +++ b/null-object/src/main/java/com/iluwatar/nullobject/App.java @@ -5,7 +5,7 @@ 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. @@ -13,6 +13,10 @@ package com.iluwatar.nullobject; */ public class App { + /** + * Program entry point + * @param args command line args + */ public static void main( String[] args ) { Node root = new NodeImpl("1", diff --git a/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java b/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java index dfa6963d0..4a0f4cd2b 100644 --- a/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java +++ b/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java @@ -3,7 +3,7 @@ package com.iluwatar.nullobject; /** * * Null Object implementation for binary tree node. - * + *

* Implemented as Singleton, since all the NullNodes are the same. * */ diff --git a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java index eb12f3c4d..7ddf2cabc 100644 --- a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java +++ b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.nullobject.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 86c68f96e3b44aeab61759fee375da2c1f03225e Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:24:53 +0300 Subject: [PATCH 138/687] #107 Improve JavaDoc for Object Pool example --- .../src/main/java/com/iluwatar/object/pool/App.java | 10 +++++++--- .../test/java/com/iluwatar/object/pool/AppTest.java | 5 +++++ 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java index d47bc51be..c1893a774 100644 --- a/object-pool/src/main/java/com/iluwatar/object/pool/App.java +++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java @@ -5,21 +5,25 @@ package com.iluwatar.object.pool; * 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 OliphauntPool inheriting from generic ObjectPool. Oliphaunts can be checked + *

+ * 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 { + /** + * Program entry point + * @param args command line args + */ public static void main( String[] args ) { OliphauntPool pool = new OliphauntPool(); System.out.println(pool); diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java index c856141db..4114590ec 100644 --- a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java +++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.object.pool.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 520f81d62ec59cc308bc2cf7344bca52ae9e51c7 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:28:51 +0300 Subject: [PATCH 139/687] #107 Improve JavaDoc for Observer example --- .../main/java/com/iluwatar/observer/App.java | 79 ++++++++--------- .../java/com/iluwatar/observer/Hobbits.java | 55 ++++++------ .../main/java/com/iluwatar/observer/Orcs.java | 55 ++++++------ .../java/com/iluwatar/observer/Weather.java | 84 +++++++++---------- .../com/iluwatar/observer/WeatherType.java | 29 ++++--- .../iluwatar/observer/generic/GHobbits.java | 5 ++ .../com/iluwatar/observer/generic/GOrcs.java | 6 ++ .../iluwatar/observer/generic/GWeather.java | 5 ++ .../iluwatar/observer/generic/Observer.java | 8 ++ .../com/iluwatar/observer/generic/Race.java | 5 ++ .../java/com/iluwatar/observer/AppTest.java | 33 ++++---- 11 files changed, 208 insertions(+), 156 deletions(-) diff --git a/observer/src/main/java/com/iluwatar/observer/App.java b/observer/src/main/java/com/iluwatar/observer/App.java index 9d97084c8..bd99da841 100644 --- a/observer/src/main/java/com/iluwatar/observer/App.java +++ b/observer/src/main/java/com/iluwatar/observer/App.java @@ -1,38 +1,41 @@ -package com.iluwatar.observer; - -import com.iluwatar.observer.generic.GHobbits; -import com.iluwatar.observer.generic.GOrcs; -import com.iluwatar.observer.generic.GWeather; - -/** - * - * Observer pattern defines one-to-many relationship between objects. The target - * object sends change notifications to its registered observers. - * - */ -public class App { - - 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 - System.out.println("\n--Running generic version--"); - GWeather gWeather = new GWeather(); - gWeather.addObserver(new GOrcs()); - gWeather.addObserver(new GHobbits()); - - gWeather.timePasses(); - gWeather.timePasses(); - gWeather.timePasses(); - gWeather.timePasses(); - - } -} +package com.iluwatar.observer; + +import com.iluwatar.observer.generic.GHobbits; +import com.iluwatar.observer.generic.GOrcs; +import com.iluwatar.observer.generic.GWeather; + +/** + * + * Observer pattern defines one-to-many relationship between objects. The target + * object sends change notifications to its registered observers. + * + */ +public class App { + + /** + * 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 + System.out.println("\n--Running generic version--"); + GWeather gWeather = new GWeather(); + gWeather.addObserver(new GOrcs()); + gWeather.addObserver(new GHobbits()); + + gWeather.timePasses(); + gWeather.timePasses(); + gWeather.timePasses(); + gWeather.timePasses(); + } +} diff --git a/observer/src/main/java/com/iluwatar/observer/Hobbits.java b/observer/src/main/java/com/iluwatar/observer/Hobbits.java index b8a4f5b4f..d15ce6109 100644 --- a/observer/src/main/java/com/iluwatar/observer/Hobbits.java +++ b/observer/src/main/java/com/iluwatar/observer/Hobbits.java @@ -1,25 +1,30 @@ -package com.iluwatar.observer; - -public class Hobbits implements WeatherObserver { - - @Override - public void update(WeatherType currentWeather) { - switch (currentWeather) { - case COLD: - System.out.println("The hobbits are shivering in the cold weather."); - break; - case RAINY: - System.out.println("The hobbits look for cover from the rain."); - break; - case SUNNY: - System.out.println("The happy hobbits bade in the warm sun."); - break; - case WINDY: - System.out.println("The hobbits hold their hats tightly in the windy weather."); - break; - default: - break; - } - } - -} +package com.iluwatar.observer; + +/** + * + * Hobbits + * + */ +public class Hobbits implements WeatherObserver { + + @Override + public void update(WeatherType currentWeather) { + switch (currentWeather) { + case COLD: + System.out.println("The hobbits are shivering in the cold weather."); + break; + case RAINY: + System.out.println("The hobbits look for cover from the rain."); + break; + case SUNNY: + System.out.println("The happy hobbits bade in the warm sun."); + break; + case WINDY: + System.out.println("The hobbits hold their hats tightly in the windy weather."); + break; + default: + break; + } + } + +} diff --git a/observer/src/main/java/com/iluwatar/observer/Orcs.java b/observer/src/main/java/com/iluwatar/observer/Orcs.java index 0e51ab450..26049bf4b 100644 --- a/observer/src/main/java/com/iluwatar/observer/Orcs.java +++ b/observer/src/main/java/com/iluwatar/observer/Orcs.java @@ -1,25 +1,30 @@ -package com.iluwatar.observer; - -public class Orcs implements WeatherObserver { - - @Override - public void update(WeatherType currentWeather) { - switch (currentWeather) { - case COLD: - System.out.println("The orcs are freezing cold."); - break; - case RAINY: - System.out.println("The orcs are dripping wet."); - break; - case SUNNY: - System.out.println("The sun hurts the orcs' eyes."); - break; - case WINDY: - System.out.println("The orc smell almost vanishes in the wind."); - break; - default: - break; - } - } - -} +package com.iluwatar.observer; + +/** + * + * Orcs + * + */ +public class Orcs implements WeatherObserver { + + @Override + public void update(WeatherType currentWeather) { + switch (currentWeather) { + case COLD: + System.out.println("The orcs are freezing cold."); + break; + case RAINY: + System.out.println("The orcs are dripping wet."); + break; + case SUNNY: + System.out.println("The sun hurts the orcs' eyes."); + break; + case WINDY: + System.out.println("The orc smell almost vanishes in the wind."); + break; + default: + break; + } + } + +} diff --git a/observer/src/main/java/com/iluwatar/observer/Weather.java b/observer/src/main/java/com/iluwatar/observer/Weather.java index 32ff13d03..c5b03c7a3 100644 --- a/observer/src/main/java/com/iluwatar/observer/Weather.java +++ b/observer/src/main/java/com/iluwatar/observer/Weather.java @@ -1,42 +1,42 @@ -package com.iluwatar.observer; - -import java.util.ArrayList; -import java.util.List; - -/** - * - * Weather can be observed by implementing WeatherObserver interface and - * registering as listener. - * - */ -public class Weather { - - 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); - } - - public void timePasses() { - WeatherType[] enumValues = WeatherType.values(); - currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length]; - System.out.println("The weather changed to " + currentWeather + "."); - notifyObservers(); - } - - private void notifyObservers() { - for (WeatherObserver obs : observers) { - obs.update(currentWeather); - } - } -} +package com.iluwatar.observer; + +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 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); + } + + public void timePasses() { + WeatherType[] enumValues = WeatherType.values(); + currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length]; + System.out.println("The weather changed to " + currentWeather + "."); + notifyObservers(); + } + + private void notifyObservers() { + for (WeatherObserver obs : observers) { + obs.update(currentWeather); + } + } +} diff --git a/observer/src/main/java/com/iluwatar/observer/WeatherType.java b/observer/src/main/java/com/iluwatar/observer/WeatherType.java index b16c3cc04..173a53205 100644 --- a/observer/src/main/java/com/iluwatar/observer/WeatherType.java +++ b/observer/src/main/java/com/iluwatar/observer/WeatherType.java @@ -1,12 +1,17 @@ -package com.iluwatar.observer; - -public enum WeatherType { - - SUNNY, RAINY, WINDY, COLD; - - @Override - public String toString() { - return this.name().toLowerCase(); - } - -} +package com.iluwatar.observer; + +/** + * + * WeatherType enumeration + * + */ +public enum WeatherType { + + SUNNY, RAINY, WINDY, COLD; + + @Override + public String toString() { + return this.name().toLowerCase(); + } + +} diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java index 78caefbcf..ec19d68e1 100644 --- a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java +++ b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java @@ -2,6 +2,11 @@ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; +/** + * + * GHobbits + * + */ public class GHobbits implements Race { @Override public void update(GWeather weather, WeatherType weatherType) { diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java index 97518ee10..037b88a1d 100644 --- a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java +++ b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java @@ -2,7 +2,13 @@ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; +/** + * + * GOrcs + * + */ public class GOrcs implements Race { + @Override public void update(GWeather weather, WeatherType weatherType) { switch (weatherType) { diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java index c4702542c..cea86bc82 100644 --- a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java +++ b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java @@ -2,6 +2,11 @@ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; +/** + * + * GWeather + * + */ public class GWeather extends Observable { private WeatherType currentWeather; diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Observer.java b/observer/src/main/java/com/iluwatar/observer/generic/Observer.java index 901930de8..2338f9e98 100644 --- a/observer/src/main/java/com/iluwatar/observer/generic/Observer.java +++ b/observer/src/main/java/com/iluwatar/observer/generic/Observer.java @@ -1,5 +1,13 @@ package com.iluwatar.observer.generic; +/** + * + * Observer + * + * @param + * @param + * @param + */ public interface Observer, O extends Observer, A> { void update(S subject, A argument); diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Race.java b/observer/src/main/java/com/iluwatar/observer/generic/Race.java index 358b27758..ddc3337cb 100644 --- a/observer/src/main/java/com/iluwatar/observer/generic/Race.java +++ b/observer/src/main/java/com/iluwatar/observer/generic/Race.java @@ -2,5 +2,10 @@ package com.iluwatar.observer.generic; import com.iluwatar.observer.WeatherType; +/** + * + * Race + * + */ public interface Race extends Observer { } diff --git a/observer/src/test/java/com/iluwatar/observer/AppTest.java b/observer/src/test/java/com/iluwatar/observer/AppTest.java index 9e208ce66..38d5c0503 100644 --- a/observer/src/test/java/com/iluwatar/observer/AppTest.java +++ b/observer/src/test/java/com/iluwatar/observer/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.observer; - -import org.junit.Test; - -import com.iluwatar.observer.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.observer; + +import org.junit.Test; + +import com.iluwatar.observer.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 2bf00c3b5eee88b7c54066e671344a3d77f84cc1 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:34:23 +0300 Subject: [PATCH 140/687] #107 JavaDoc improvements for Poison Pill --- .../java/com/iluwatar/poison/pill/App.java | 20 ++++++++++++------- .../com/iluwatar/poison/pill/Message.java | 3 ++- .../com/iluwatar/poison/pill/AppTest.java | 5 +++++ 3 files changed, 20 insertions(+), 8 deletions(-) diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java index 8f665b1e3..526ca5b86 100644 --- a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java @@ -1,16 +1,22 @@ package com.iluwatar.poison.pill; /** - * One of possible approaches to terminate Producer-Consumer pattern is using PoisonPill idiom. - * If you use PoisonPill as termination signal then Producer is responsible to notify Consumer that exchange is over - * and reject any further messages. Consumer receiving PoisonPill will stop to read messages from queue. - * You also must ensure that PoisonPill will be last message that will be read from queue (if you have - * prioritized queue than this can be tricky). - * In simple cases as PoisonPill can be used just null-reference, but holding unique separate shared - * object-marker (with name "Poison" or "PoisonPill") is more clear and self describing. + * 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 exchange is over + * and reject any further messages. 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 as Poison Pill can be used just null-reference, but holding 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); diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java index f306e0385..8e167790f 100644 --- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java +++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java @@ -3,7 +3,8 @@ 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. + * 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 { diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java index 625d849a2..0730e5b10 100644 --- a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java +++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.poison.pill.App; +/** + * + * Application test + * + */ public class AppTest { @Test From c32246e41daf94d3813bdeb098860a5a7d0b31d5 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:38:26 +0300 Subject: [PATCH 141/687] #107 Improve Private Class Data example JavaDoc --- .../com/iluwatar/privateclassdata/App.java | 72 ++++++++++--------- .../iluwatar/privateclassdata/AppTest.java | 33 +++++---- 2 files changed, 57 insertions(+), 48 deletions(-) diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java index 8cc5254d6..a4e2ffa87 100644 --- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java +++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java @@ -1,34 +1,38 @@ -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 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 - * stew class. - * - * The problem is solved with the Private Class Data pattern. We introduce - * ImmutableStew class that contains StewData. The private data members of - * Stew are now in StewData and cannot be altered by ImmutableStew methods. - * - */ -public class App { - - 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(); - } -} +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(); + } +} diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java index 8ba8c4b80..92fc9b46a 100644 --- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java +++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.privateclassdata; - -import org.junit.Test; - -import com.iluwatar.privateclassdata.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.privateclassdata; + +import org.junit.Test; + +import com.iluwatar.privateclassdata.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 8fb0ec1bf98fa5aaf3ce5e37940a9986efdbf35e Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:41:33 +0300 Subject: [PATCH 142/687] #107 Improve Prototype JavaDoc --- .../src/main/java/com/iluwatar/property/App.java | 15 +++++++++++---- .../test/java/com/iluwatar/property/AppTest.java | 5 +++++ 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/property/src/main/java/com/iluwatar/property/App.java b/property/src/main/java/com/iluwatar/property/App.java index 40972ab59..54c140574 100644 --- a/property/src/main/java/com/iluwatar/property/App.java +++ b/property/src/main/java/com/iluwatar/property/App.java @@ -3,14 +3,21 @@ package com.iluwatar.property; import com.iluwatar.property.Character.Type; /** - * Example of Character instantiation using Property pattern (as concept also known like Prototype inheritance). + * + * Example of {@link Character} instantiation using the Property pattern (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. + * 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. + * */ public class App { + /** + * Program entry point + * @param args command line args + */ public static void main(String[] args) { /* set up */ Prototype charProto = new Character(); diff --git a/property/src/test/java/com/iluwatar/property/AppTest.java b/property/src/test/java/com/iluwatar/property/AppTest.java index dc05049f8..1e8078352 100644 --- a/property/src/test/java/com/iluwatar/property/AppTest.java +++ b/property/src/test/java/com/iluwatar/property/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.property.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 0db6581cfd2f16033169dc78e0929e08745a579a Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:45:03 +0300 Subject: [PATCH 143/687] #107 Improve JavaDoc for Prototype --- .../main/java/com/iluwatar/prototype/App.java | 76 ++++++++++--------- .../java/com/iluwatar/prototype/Beast.java | 21 +++-- .../java/com/iluwatar/prototype/ElfBeast.java | 47 +++++++----- .../java/com/iluwatar/prototype/ElfMage.java | 47 +++++++----- .../com/iluwatar/prototype/ElfWarlord.java | 47 +++++++----- .../java/com/iluwatar/prototype/Mage.java | 21 +++-- .../java/com/iluwatar/prototype/OrcBeast.java | 47 +++++++----- .../java/com/iluwatar/prototype/OrcMage.java | 47 +++++++----- .../com/iluwatar/prototype/OrcWarlord.java | 47 +++++++----- .../com/iluwatar/prototype/Prototype.java | 21 +++-- .../java/com/iluwatar/prototype/Warlord.java | 21 +++-- .../java/com/iluwatar/prototype/AppTest.java | 33 ++++---- 12 files changed, 267 insertions(+), 208 deletions(-) diff --git a/prototype/src/main/java/com/iluwatar/prototype/App.java b/prototype/src/main/java/com/iluwatar/prototype/App.java index b10de963b..4003862cb 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/App.java +++ b/prototype/src/main/java/com/iluwatar/prototype/App.java @@ -1,36 +1,40 @@ -package com.iluwatar.prototype; - -/** - * - * In Prototype we have a factory class (HeroFactoryImpl) producing objects by - * cloning existing ones. In this example the factory's prototype objects are - * given as constructor parameters. - * - */ -public class App { - - 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(); - System.out.println(mage); - System.out.println(warlord); - System.out.println(beast); - - factory = new HeroFactoryImpl(new OrcMage(), new OrcWarlord(), - new OrcBeast()); - mage = factory.createMage(); - warlord = factory.createWarlord(); - beast = factory.createBeast(); - System.out.println(mage); - System.out.println(warlord); - System.out.println(beast); - } -} +package com.iluwatar.prototype; + +/** + * + * In Prototype we have a factory class ({@link HeroFactoryImpl}) producing objects by + * cloning the existing ones. In this example the factory's prototype objects are + * given as constructor parameters. + * + */ +public class App { + + /** + * 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(); + System.out.println(mage); + System.out.println(warlord); + System.out.println(beast); + + factory = new HeroFactoryImpl(new OrcMage(), new OrcWarlord(), + new OrcBeast()); + mage = factory.createMage(); + warlord = factory.createWarlord(); + beast = factory.createBeast(); + System.out.println(mage); + System.out.println(warlord); + System.out.println(beast); + } +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/Beast.java b/prototype/src/main/java/com/iluwatar/prototype/Beast.java index 96cbfb2c8..028fa11b8 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/Beast.java +++ b/prototype/src/main/java/com/iluwatar/prototype/Beast.java @@ -1,8 +1,13 @@ -package com.iluwatar.prototype; - -public abstract class Beast extends Prototype { - - @Override - public abstract Beast clone() throws CloneNotSupportedException; - -} +package com.iluwatar.prototype; + +/** + * + * Beast + * + */ +public abstract class Beast extends Prototype { + + @Override + public abstract Beast clone() throws CloneNotSupportedException; + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java index 17ac87511..b2b517207 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java +++ b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java @@ -1,21 +1,26 @@ -package com.iluwatar.prototype; - -public class ElfBeast extends Beast { - - public ElfBeast() { - } - - public ElfBeast(ElfBeast beast) { - } - - @Override - public Beast clone() throws CloneNotSupportedException { - return new ElfBeast(this); - } - - @Override - public String toString() { - return "Elven eagle"; - } - -} +package com.iluwatar.prototype; + +/** + * + * ElfBeast + * + */ +public class ElfBeast extends Beast { + + public ElfBeast() { + } + + public ElfBeast(ElfBeast beast) { + } + + @Override + public Beast clone() throws CloneNotSupportedException { + return new ElfBeast(this); + } + + @Override + public String toString() { + return "Elven eagle"; + } + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java index c41ce2dd6..b502350c3 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java +++ b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java @@ -1,21 +1,26 @@ -package com.iluwatar.prototype; - -public class ElfMage extends Mage { - - public ElfMage() { - } - - public ElfMage(ElfMage mage) { - } - - @Override - public Mage clone() throws CloneNotSupportedException { - return new ElfMage(this); - } - - @Override - public String toString() { - return "Elven mage"; - } - -} +package com.iluwatar.prototype; + +/** + * + * ElfMage + * + */ +public class ElfMage extends Mage { + + public ElfMage() { + } + + public ElfMage(ElfMage mage) { + } + + @Override + public Mage clone() throws CloneNotSupportedException { + return new ElfMage(this); + } + + @Override + public String toString() { + return "Elven mage"; + } + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java index 465c1d046..7f5829797 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java +++ b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java @@ -1,21 +1,26 @@ -package com.iluwatar.prototype; - -public class ElfWarlord extends Warlord { - - public ElfWarlord() { - } - - public ElfWarlord(ElfWarlord warlord) { - } - - @Override - public Warlord clone() throws CloneNotSupportedException { - return new ElfWarlord(this); - } - - @Override - public String toString() { - return "Elven warlord"; - } - -} +package com.iluwatar.prototype; + +/** + * + * ElfWarlord + * + */ +public class ElfWarlord extends Warlord { + + public ElfWarlord() { + } + + public ElfWarlord(ElfWarlord warlord) { + } + + @Override + public Warlord clone() throws CloneNotSupportedException { + return new ElfWarlord(this); + } + + @Override + public String toString() { + return "Elven warlord"; + } + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/Mage.java b/prototype/src/main/java/com/iluwatar/prototype/Mage.java index 99cee8893..7ba192487 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/Mage.java +++ b/prototype/src/main/java/com/iluwatar/prototype/Mage.java @@ -1,8 +1,13 @@ -package com.iluwatar.prototype; - -public abstract class Mage extends Prototype { - - @Override - public abstract Mage clone() throws CloneNotSupportedException; - -} +package com.iluwatar.prototype; + +/** + * + * Mage + * + */ +public abstract class Mage extends Prototype { + + @Override + public abstract Mage clone() throws CloneNotSupportedException; + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java index bae7d360e..2af2fefa9 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java +++ b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java @@ -1,21 +1,26 @@ -package com.iluwatar.prototype; - -public class OrcBeast extends Beast { - - public OrcBeast() { - } - - public OrcBeast(OrcBeast beast) { - } - - @Override - public Beast clone() throws CloneNotSupportedException { - return new OrcBeast(this); - } - - @Override - public String toString() { - return "Orcish wolf"; - } - -} +package com.iluwatar.prototype; + +/** + * + * OrcBeast + * + */ +public class OrcBeast extends Beast { + + public OrcBeast() { + } + + public OrcBeast(OrcBeast beast) { + } + + @Override + public Beast clone() throws CloneNotSupportedException { + return new OrcBeast(this); + } + + @Override + public String toString() { + return "Orcish wolf"; + } + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java index a329ca61b..1f52a25d9 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java +++ b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java @@ -1,21 +1,26 @@ -package com.iluwatar.prototype; - -public class OrcMage extends Mage { - - public OrcMage() { - } - - public OrcMage(OrcMage mage) { - } - - @Override - public Mage clone() throws CloneNotSupportedException { - return new OrcMage(this); - } - - @Override - public String toString() { - return "Orcish mage"; - } - -} +package com.iluwatar.prototype; + +/** + * + * OrcMage + * + */ +public class OrcMage extends Mage { + + public OrcMage() { + } + + public OrcMage(OrcMage mage) { + } + + @Override + public Mage clone() throws CloneNotSupportedException { + return new OrcMage(this); + } + + @Override + public String toString() { + return "Orcish mage"; + } + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java index 2832c3835..53814d1c2 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java +++ b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java @@ -1,21 +1,26 @@ -package com.iluwatar.prototype; - -public class OrcWarlord extends Warlord { - - public OrcWarlord() { - } - - public OrcWarlord(OrcWarlord warlord) { - } - - @Override - public Warlord clone() throws CloneNotSupportedException { - return new OrcWarlord(this); - } - - @Override - public String toString() { - return "Orcish warlord"; - } - -} +package com.iluwatar.prototype; + +/** + * + * OrcWarlord + * + */ +public class OrcWarlord extends Warlord { + + public OrcWarlord() { + } + + public OrcWarlord(OrcWarlord warlord) { + } + + @Override + public Warlord clone() throws CloneNotSupportedException { + return new OrcWarlord(this); + } + + @Override + public String toString() { + return "Orcish warlord"; + } + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/Prototype.java b/prototype/src/main/java/com/iluwatar/prototype/Prototype.java index 2329f1e6d..eb2520c35 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/Prototype.java +++ b/prototype/src/main/java/com/iluwatar/prototype/Prototype.java @@ -1,8 +1,13 @@ -package com.iluwatar.prototype; - -public abstract class Prototype implements Cloneable { - - @Override - public abstract Object clone() throws CloneNotSupportedException; - -} +package com.iluwatar.prototype; + +/** + * + * Prototype + * + */ +public abstract class Prototype implements Cloneable { + + @Override + public abstract Object clone() throws CloneNotSupportedException; + +} diff --git a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java index 930320d97..bfd5c594a 100644 --- a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java +++ b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java @@ -1,8 +1,13 @@ -package com.iluwatar.prototype; - -public abstract class Warlord extends Prototype { - - @Override - public abstract Warlord clone() throws CloneNotSupportedException; - -} +package com.iluwatar.prototype; + +/** + * + * Warlord + * + */ +public abstract class Warlord extends Prototype { + + @Override + public abstract Warlord clone() throws CloneNotSupportedException; + +} diff --git a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java index ecb576038..030f5472c 100644 --- a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java +++ b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.prototype; - -import org.junit.Test; - -import com.iluwatar.prototype.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.prototype; + +import org.junit.Test; + +import com.iluwatar.prototype.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 4d08d16bb1effb2dcb594f9eff11d1ee0cc232fa Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:47:39 +0300 Subject: [PATCH 144/687] #107 JavaDoc for Proxy example --- .../src/main/java/com/iluwatar/proxy/App.java | 40 ++++++++-------- .../main/java/com/iluwatar/proxy/Wizard.java | 37 ++++++++------- .../com/iluwatar/proxy/WizardTowerProxy.java | 46 +++++++++---------- .../test/java/com/iluwatar/proxy/AppTest.java | 33 +++++++------ 4 files changed, 83 insertions(+), 73 deletions(-) diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java index 86c96466b..fb401ac9f 100644 --- a/proxy/src/main/java/com/iluwatar/proxy/App.java +++ b/proxy/src/main/java/com/iluwatar/proxy/App.java @@ -1,20 +1,20 @@ -package com.iluwatar.proxy; - -/** - * - * Proxy (WizardTowerProxy) controls access to the actual object (WizardTower). - * - */ -public class App { - - public static void main(String[] args) { - - WizardTowerProxy tower = new WizardTowerProxy(); - tower.enter(new Wizard("Red wizard")); - tower.enter(new Wizard("White wizard")); - tower.enter(new Wizard("Black wizard")); - tower.enter(new Wizard("Green wizard")); - tower.enter(new Wizard("Brown wizard")); - - } -} +package com.iluwatar.proxy; + +/** + * + * Proxy ({@link WizardTowerProxy}) controls access to the actual object ({@link WizardTower}). + * + */ +public class App { + + public static void main(String[] args) { + + WizardTowerProxy tower = new WizardTowerProxy(); + tower.enter(new Wizard("Red wizard")); + tower.enter(new Wizard("White wizard")); + tower.enter(new Wizard("Black wizard")); + tower.enter(new Wizard("Green wizard")); + tower.enter(new Wizard("Brown wizard")); + + } +} diff --git a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java index 2060a5803..b6d5691f4 100644 --- a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java +++ b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java @@ -1,16 +1,21 @@ -package com.iluwatar.proxy; - -public class Wizard { - - private String name; - - public Wizard(String name) { - this.name = name; - } - - @Override - public String toString() { - return name; - } - -} +package com.iluwatar.proxy; + +/** + * + * Wizard + * + */ +public class Wizard { + + private String name; + + public Wizard(String name) { + this.name = name; + } + + @Override + public String toString() { + return name; + } + +} diff --git a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java index 3563aef1d..567a998d1 100644 --- a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java +++ b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java @@ -1,23 +1,23 @@ -package com.iluwatar.proxy; - -/** - * - * The proxy controlling access to WizardTower. - * - */ -public class WizardTowerProxy extends WizardTower { - - private static final int NUM_WIZARDS_ALLOWED = 3; - - private int numWizards; - - @Override - public void enter(Wizard wizard) { - if (numWizards < NUM_WIZARDS_ALLOWED) { - super.enter(wizard); - numWizards++; - } else { - System.out.println(wizard + " is not allowed to enter!"); - } - } -} +package com.iluwatar.proxy; + +/** + * + * The proxy controlling access to the {@link WizardTower}. + * + */ +public class WizardTowerProxy extends WizardTower { + + private static final int NUM_WIZARDS_ALLOWED = 3; + + private int numWizards; + + @Override + public void enter(Wizard wizard) { + if (numWizards < NUM_WIZARDS_ALLOWED) { + super.enter(wizard); + numWizards++; + } else { + System.out.println(wizard + " is not allowed to enter!"); + } + } +} diff --git a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java index 0cd9641df..4d21b3d9a 100644 --- a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java +++ b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.proxy; - -import org.junit.Test; - -import com.iluwatar.proxy.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.proxy; + +import org.junit.Test; + +import com.iluwatar.proxy.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 57a271d4feaed90d221625dd315e0e58efb4d268 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:49:53 +0300 Subject: [PATCH 145/687] #107 Improve Repository example's JavaDoc --- .../src/main/java/com/iluwatar/repository/App.java | 10 +++++++--- .../src/test/java/com/iluwatar/repository/AppTest.java | 5 +++++ 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/repository/src/main/java/com/iluwatar/repository/App.java b/repository/src/main/java/com/iluwatar/repository/App.java index 3e4d46d00..37a5f7962 100644 --- a/repository/src/main/java/com/iluwatar/repository/App.java +++ b/repository/src/main/java/com/iluwatar/repository/App.java @@ -13,14 +13,18 @@ import org.springframework.context.support.ClassPathXmlApplicationContext; * 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 Person - * domain object. Using the PersonDao we perform CRUD operations on the entity. Underneath we have + *

+ * 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. Underneath we have * configured in-memory H2 database for which schema is created and dropped on each run. * */ public class App { + /** + * Program entry point + * @param args command line args + */ public static void main(String[] args) { ClassPathXmlApplicationContext context = new ClassPathXmlApplicationContext( "applicationContext.xml"); diff --git a/repository/src/test/java/com/iluwatar/repository/AppTest.java b/repository/src/test/java/com/iluwatar/repository/AppTest.java index 2e638ba6b..14f597045 100644 --- a/repository/src/test/java/com/iluwatar/repository/AppTest.java +++ b/repository/src/test/java/com/iluwatar/repository/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.repository.App; +/** + * + * Application test + * + */ public class AppTest { @Test From ace8b3e22fa50e9e6f42438c8d81886911239ec7 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:52:22 +0300 Subject: [PATCH 146/687] #107 RAII example JavaDoc --- .../acquisition/is/initialization/App.java | 21 ++++++++++++------- .../is/initialization/AppTest.java | 5 +++++ 2 files changed, 18 insertions(+), 8 deletions(-) diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java index b947d31d0..141aea4ec 100644 --- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java +++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java @@ -5,27 +5,32 @@ package com.iluwatar.resource.acquisition.is.initialization; * 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 Closeable and AutoCloseable. The try-with-resources + * 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 java.lang.AutoCloseable, which - * includes all objects which implement java.io.Closeable, can be used + * 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, SlidingDoor implements AutoCloseable and - * TreasureChest implements Closeable. Running the example, we can + * 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 { + /** + * Program entry point + * @param args command line args + * @throws Exception + */ public static void main( String[] args ) throws Exception { try (SlidingDoor slidingDoor = new SlidingDoor()) { diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java index 097ea4711..e20815c3f 100644 --- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java +++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.resource.acquisition.is.initialization.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 1b2a1fd19fb49d117ad90897a997ab64bb7c3236 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:54:18 +0300 Subject: [PATCH 147/687] #107 JavaDoc for Servant --- .../main/java/com/iluwatar/servant/App.java | 5 +++ .../main/java/com/iluwatar/servant/King.java | 6 ++++ .../main/java/com/iluwatar/servant/Queen.java | 6 ++++ .../java/com/iluwatar/servant/Royalty.java | 5 +++ .../java/com/iluwatar/servant/Servant.java | 6 ++++ .../java/com/iluwatar/servant/AppTest.java | 33 +++++++++++-------- 6 files changed, 47 insertions(+), 14 deletions(-) diff --git a/servant/src/main/java/com/iluwatar/servant/App.java b/servant/src/main/java/com/iluwatar/servant/App.java index 4951c7270..6a0ba6ca4 100644 --- a/servant/src/main/java/com/iluwatar/servant/App.java +++ b/servant/src/main/java/com/iluwatar/servant/App.java @@ -10,9 +10,14 @@ import java.util.ArrayList; * */ public class App { + static Servant jenkins = new Servant("Jenkins"); static Servant travis = new Servant("Travis"); + /** + * Program entry point + * @param args + */ public static void main(String[] args) { scenario(jenkins, 1); scenario(travis, 0); diff --git a/servant/src/main/java/com/iluwatar/servant/King.java b/servant/src/main/java/com/iluwatar/servant/King.java index 24aa1b870..29ec88192 100644 --- a/servant/src/main/java/com/iluwatar/servant/King.java +++ b/servant/src/main/java/com/iluwatar/servant/King.java @@ -1,6 +1,12 @@ package com.iluwatar.servant; +/** + * + * King + * + */ public class King implements Royalty { + private boolean isDrunk; private boolean isHungry = true; private boolean isHappy; diff --git a/servant/src/main/java/com/iluwatar/servant/Queen.java b/servant/src/main/java/com/iluwatar/servant/Queen.java index c581132de..815106725 100644 --- a/servant/src/main/java/com/iluwatar/servant/Queen.java +++ b/servant/src/main/java/com/iluwatar/servant/Queen.java @@ -1,6 +1,12 @@ package com.iluwatar.servant; +/** + * + * Queen + * + */ public class Queen implements Royalty { + private boolean isDrunk = true; private boolean isHungry; private boolean isHappy; diff --git a/servant/src/main/java/com/iluwatar/servant/Royalty.java b/servant/src/main/java/com/iluwatar/servant/Royalty.java index 02ebe3cce..543ffd8d5 100644 --- a/servant/src/main/java/com/iluwatar/servant/Royalty.java +++ b/servant/src/main/java/com/iluwatar/servant/Royalty.java @@ -1,5 +1,10 @@ package com.iluwatar.servant; +/** + * + * Royalty + * + */ interface Royalty { void getFed(); diff --git a/servant/src/main/java/com/iluwatar/servant/Servant.java b/servant/src/main/java/com/iluwatar/servant/Servant.java index b29e7fe20..8e61333d8 100644 --- a/servant/src/main/java/com/iluwatar/servant/Servant.java +++ b/servant/src/main/java/com/iluwatar/servant/Servant.java @@ -2,7 +2,13 @@ package com.iluwatar.servant; import java.util.ArrayList; +/** + * + * Servant + * + */ public class Servant { + public String name; public Servant(String name){ diff --git a/servant/src/test/java/com/iluwatar/servant/AppTest.java b/servant/src/test/java/com/iluwatar/servant/AppTest.java index bf6655f2a..94a12b207 100644 --- a/servant/src/test/java/com/iluwatar/servant/AppTest.java +++ b/servant/src/test/java/com/iluwatar/servant/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.servant; - -import org.junit.Test; - -import com.iluwatar.servant.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.servant; + +import org.junit.Test; + +import com.iluwatar.servant.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 488e5dd2816107f75a7d47e4641175213f0239fa Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:57:24 +0300 Subject: [PATCH 148/687] #107 JavaDoc for Service Layer --- .../main/java/com/iluwatar/servicelayer/app/App.java | 12 ++++++++---- .../servicelayer/hibernate/HibernateUtil.java | 2 +- .../java/com/iluwatar/servicelayer/app/AppTest.java | 5 +++++ 3 files changed, 14 insertions(+), 5 deletions(-) diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java index ea0419606..2d91b43d9 100644 --- a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java +++ b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java @@ -18,7 +18,7 @@ import com.iluwatar.servicelayer.wizard.WizardDaoImpl; /** * 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 @@ -26,15 +26,19 @@ import com.iluwatar.servicelayer.wizard.WizardDaoImpl; * 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 (App) and a service - * (MagicService). The service is implemented with 3-layer architecture (entity, dao, service). + *

+ * 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 { + /** + * Program entry point + * @param args command line args + */ public static void main( String[] args ) { // populate the in-memory database initData(); diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java index 922fe9f21..70d586c08 100644 --- a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java +++ b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java @@ -9,7 +9,7 @@ import com.iluwatar.servicelayer.wizard.Wizard; /** * - * Produces the Hibernate SessionFactory. + * Produces the Hibernate {@link SessionFactory}. * */ public class HibernateUtil { diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java index aabeb1a6c..bbf476c0b 100644 --- a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java +++ b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.servicelayer.app.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 743b6e69c591004594965df463916c620bfedf2b Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 22:59:59 +0300 Subject: [PATCH 149/687] #107 Service Locator JavaDoc --- .../java/com/iluwatar/servicelocator/App.java | 8 ++++- .../com/iluwatar/servicelocator/Service.java | 1 + .../com/iluwatar/servicelocator/AppTest.java | 33 +++++++++++-------- 3 files changed, 27 insertions(+), 15 deletions(-) diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java index 57f188731..f86e1cc32 100644 --- a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java +++ b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java @@ -1,12 +1,18 @@ package com.iluwatar.servicelocator; /** - * Service locator pattern, used to lookup jndi services + * Service locator pattern, used 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(); diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java b/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java index dbb268159..4831add95 100644 --- a/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java +++ b/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java @@ -6,6 +6,7 @@ package com.iluwatar.servicelocator; *

  • service name
    • *
  • unique id
    • *
  • execution work flow
    • + * * @author saifasif * */ diff --git a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java index d6af23f2d..90e091905 100644 --- a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java +++ b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.servicelocator; - -import org.junit.Test; - -import com.iluwatar.servicelocator.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.servicelocator; + +import org.junit.Test; + +import com.iluwatar.servicelocator.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 4bf2e3f16de06dc426994b79bdd4d4901b6fd5e8 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:09:51 +0300 Subject: [PATCH 150/687] #107 JavaDoc for Singleton --- .../main/java/com/iluwatar/singleton/App.java | 106 +++++++++--------- .../InitializingOnDemandHolderIdiom.java | 6 +- .../ThreadSafeDoubleCheckLocking.java | 5 +- .../java/com/iluwatar/singleton/AppTest.java | 33 +++--- .../LazyLoadedSingletonThreadSafetyTest.java | 12 +- 5 files changed, 88 insertions(+), 74 deletions(-) diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java index d14088ca2..67cb6fd00 100644 --- a/singleton/src/main/java/com/iluwatar/singleton/App.java +++ b/singleton/src/main/java/com/iluwatar/singleton/App.java @@ -1,51 +1,55 @@ -package com.iluwatar.singleton; - -/** - * - * Singleton pattern ensures that the class (IvoryTower) can have only one - * existing instance per java classloader instance and provides global access to it. - * - * http://stackoverflow.com/questions/70689/what-is-an-efficient-way-to-implement-a-singleton-pattern-in-java - * - * The risk 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. - * - * http://stackoverflow.com/questions/17721263/singleton-across-jvm-or-application-instance-or-tomcat-instance - */ -public class App { - - public static void main(String[] args) { - - // eagerly initialized singleton - IvoryTower ivoryTower1 = IvoryTower.getInstance(); - IvoryTower ivoryTower2 = IvoryTower.getInstance(); - System.out.println("ivoryTower1=" + ivoryTower1); - System.out.println("ivoryTower2=" + ivoryTower2); - - // lazily initialized singleton - ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower - .getInstance(); - ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower - .getInstance(); - System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1); - System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2); - - // enum singleton - EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE; - EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE; - System.out.println("enumIvoryTower1=" + enumIvoryTower1); - System.out.println("enumIvoryTower2=" + enumIvoryTower2); - - InitializingOnDemandHolderIdiom demandHolderIdiom = InitializingOnDemandHolderIdiom.getInstance(); - System.out.println(demandHolderIdiom); - InitializingOnDemandHolderIdiom demandHolderIdiom2 = InitializingOnDemandHolderIdiom.getInstance(); - System.out.println(demandHolderIdiom2); - - ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance(); - System.out.println(dcl1); - ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance(); - System.out.println(dcl2); - } -} +package com.iluwatar.singleton; + +/** + * + * Singleton pattern ensures that the class ({@link IvoryTower}) can have only one + * existing instance per Java classloader instance and provides global access to it. + *

    + * http://stackoverflow.com/questions/70689/what-is-an-efficient-way-to-implement-a-singleton-pattern-in-java + *

    + * The risk 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. + *

    + * http://stackoverflow.com/questions/17721263/singleton-across-jvm-or-application-instance-or-tomcat-instance + */ +public class App { + + /** + * 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(); + System.out.println("ivoryTower1=" + ivoryTower1); + System.out.println("ivoryTower2=" + ivoryTower2); + + // lazily initialized singleton + ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower + .getInstance(); + ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower + .getInstance(); + System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1); + System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2); + + // enum singleton + EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE; + EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE; + System.out.println("enumIvoryTower1=" + enumIvoryTower1); + System.out.println("enumIvoryTower2=" + enumIvoryTower2); + + InitializingOnDemandHolderIdiom demandHolderIdiom = InitializingOnDemandHolderIdiom.getInstance(); + System.out.println(demandHolderIdiom); + InitializingOnDemandHolderIdiom demandHolderIdiom2 = InitializingOnDemandHolderIdiom.getInstance(); + System.out.println(demandHolderIdiom2); + + ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance(); + System.out.println(dcl1); + ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance(); + System.out.println(dcl2); + } +} diff --git a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java index 329cd6a7e..4fd4c8163 100644 --- a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java +++ b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java @@ -4,12 +4,12 @@ import java.io.Serializable; /** * The Initialize-on-demand-holder idiom is a secure way of - * creating lazy initialize singleton Object in Java. + * creating lazy initialized singleton object in Java. * refer to "The CERT Oracle Secure Coding Standard for Java" * By Dhruv Mohindra, Robert C. Seacord p.378 - * + *

    * Singleton objects usually are heavy to create and sometimes need to serialize them. - * This class also shows how to preserve singleton in Serialized version of singleton. + * This class also shows how to preserve singleton in serialized version of singleton. * * @author mortezaadi@gmail.com * diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java index 352cac2e9..d15509236 100644 --- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java +++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java @@ -2,10 +2,11 @@ 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 * */ diff --git a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java index abe0440fd..c83232037 100644 --- a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java +++ b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.singleton; - -import org.junit.Test; - -import com.iluwatar.singleton.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.singleton; + +import org.junit.Test; + +import com.iluwatar.singleton.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java index f40d8a319..ca88f4169 100644 --- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java +++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java @@ -5,9 +5,9 @@ import org.junit.Test; /** * * This test case demonstrates thread safety issues of lazy loaded Singleton implementation. - * + *

    * Out of the box you should see the test output something like the following: - * + *

    * Thread=Thread-4 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e * Thread=Thread-2 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e * Thread=Thread-0 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e @@ -15,13 +15,17 @@ import org.junit.Test; * Thread=Thread-3 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e * Thread=Thread-1 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@60f330b0 * Thread=Thread-2 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e - * + *

    * By changing the method signature of LazyLoadedIvoryTower#getInstance from + * 

      * 	 public static LazyLoadedIvoryTower getInstance()
+ *

    * into + * 

      *   public synchronized static LazyLoadedIvoryTower getInstance()
+ *

    * you should see the test output change to something like the following: - * + *

    * Thread=Thread-4 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 * Thread=Thread-4 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 * Thread=Thread-0 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490 From cec8e4f1683c49409b6bf3af3bca6c9cf6a23e34 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:11:50 +0300 Subject: [PATCH 151/687] #107 JavaDoc for Specification --- .../src/main/java/com/iluwatar/specification/app/App.java | 6 +++--- .../test/java/com/iluwatar/specification/app/AppTest.java | 5 +++++ 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/specification/src/main/java/com/iluwatar/specification/app/App.java b/specification/src/main/java/com/iluwatar/specification/app/App.java index 7a5f00a5c..642278f16 100644 --- a/specification/src/main/java/com/iluwatar/specification/app/App.java +++ b/specification/src/main/java/com/iluwatar/specification/app/App.java @@ -18,14 +18,14 @@ import com.iluwatar.specification.selector.MovementSelector; /** * - * The central idea of Specification pattern is to separate the statement of how to match a candidate, from the + * 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 * */ diff --git a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java index 8e27167dc..31965336c 100644 --- a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java +++ b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.specification.app.App; +/** + * + * Application test + * + */ public class AppTest { @Test From 9a866dfe345a79c7653033f331823250bfd3053f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:13:31 +0300 Subject: [PATCH 152/687] #107 JavaDoc for State pattern --- .../src/main/java/com/iluwatar/state/App.java | 48 +++++++++---------- .../test/java/com/iluwatar/state/AppTest.java | 33 +++++++------ 2 files changed, 43 insertions(+), 38 deletions(-) diff --git a/state/src/main/java/com/iluwatar/state/App.java b/state/src/main/java/com/iluwatar/state/App.java index eefa8f766..5b39d02f7 100644 --- a/state/src/main/java/com/iluwatar/state/App.java +++ b/state/src/main/java/com/iluwatar/state/App.java @@ -1,24 +1,24 @@ -package com.iluwatar.state; - -/** - * - * In State pattern the container object (Mammoth) has an internal state object (State) that - * defines the current behavior. The state object can be changed to alter the - * behavior. - * - * In this example the mammoth changes its behavior as time passes by. - * - */ -public class App { - - public static void main(String[] args) { - - Mammoth mammoth = new Mammoth(); - mammoth.observe(); - mammoth.timePasses(); - mammoth.observe(); - mammoth.timePasses(); - mammoth.observe(); - - } -} +package com.iluwatar.state; + +/** + * + * In State pattern the container object ({@link Mammoth}) has an internal state object ({@link State}) that + * defines the current behavior. The state object can be changed to alter the + * behavior. + *

    + * In this example the {@link Mammoth} changes its behavior as time passes by. + * + */ +public class App { + + public static void main(String[] args) { + + Mammoth mammoth = new Mammoth(); + mammoth.observe(); + mammoth.timePasses(); + mammoth.observe(); + mammoth.timePasses(); + mammoth.observe(); + + } +} diff --git a/state/src/test/java/com/iluwatar/state/AppTest.java b/state/src/test/java/com/iluwatar/state/AppTest.java index fae8412fc..556cbc01c 100644 --- a/state/src/test/java/com/iluwatar/state/AppTest.java +++ b/state/src/test/java/com/iluwatar/state/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.state; - -import org.junit.Test; - -import com.iluwatar.state.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.state; + +import org.junit.Test; + +import com.iluwatar.state.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From ed416ac75905433d3ffbde2b474c8691fa4693a6 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:15:36 +0300 Subject: [PATCH 153/687] #107 JavaDoc for Step Builder --- .../src/main/java/com/iluwatar/stepbuilder/App.java | 7 ++++++- .../com/iluwatar/stepbuilder/CharacterStepBuilder.java | 1 - .../src/test/java/com/iluwatar/stepbuilder/AppTest.java | 5 +++++ 3 files changed, 11 insertions(+), 2 deletions(-) diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java index 439c5bd11..533394acb 100644 --- a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java +++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java @@ -32,10 +32,15 @@ package com.iluwatar.stepbuilder; * 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 { + + /** + * Program entry point + * @param args command line args + */ public static void main(String[] args) { Character warrior = CharacterStepBuilder.newBuilder() diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java index e042758d9..b1ef3b5af 100644 --- a/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java +++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/CharacterStepBuilder.java @@ -6,7 +6,6 @@ import java.util.List; /** * The Step Builder class. */ - public class CharacterStepBuilder { private CharacterStepBuilder() { diff --git a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java index 61fe82aaf..fbed6798e 100644 --- a/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java +++ b/step-builder/src/test/java/com/iluwatar/stepbuilder/AppTest.java @@ -2,6 +2,11 @@ package com.iluwatar.stepbuilder; import org.junit.Test; +/** + * + * Application test + * + */ public class AppTest { @Test From 934f99e2a9bdc2892d926b6b85e0e7d5be742879 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:17:25 +0300 Subject: [PATCH 154/687] #107 JavaDoc for Strategy --- .../main/java/com/iluwatar/strategy/App.java | 48 ++++++++++--------- .../java/com/iluwatar/strategy/AppTest.java | 33 +++++++------ 2 files changed, 45 insertions(+), 36 deletions(-) diff --git a/strategy/src/main/java/com/iluwatar/strategy/App.java b/strategy/src/main/java/com/iluwatar/strategy/App.java index fc9a31327..992514801 100644 --- a/strategy/src/main/java/com/iluwatar/strategy/App.java +++ b/strategy/src/main/java/com/iluwatar/strategy/App.java @@ -1,22 +1,26 @@ -package com.iluwatar.strategy; - -/** - * - * Strategy (DragonSlayingStrategy) encapsulates an algorithm. The containing - * object (DragonSlayer) can alter its behavior by changing its strategy. - * - */ -public class App { - - public static void main(String[] args) { - System.out.println("Green dragon spotted ahead!"); - DragonSlayer dragonSlayer = new DragonSlayer(new MeleeStrategy()); - dragonSlayer.goToBattle(); - System.out.println("Red dragon emerges."); - dragonSlayer.changeStrategy(new ProjectileStrategy()); - dragonSlayer.goToBattle(); - System.out.println("Black dragon lands before you."); - dragonSlayer.changeStrategy(new SpellStrategy()); - dragonSlayer.goToBattle(); - } -} +package com.iluwatar.strategy; + +/** + * + * Strategy ({@link DragonSlayingStrategy}) encapsulates an algorithm. The containing + * object ({@link DragonSlayer}) can alter its behavior by changing its strategy. + * + */ +public class App { + + /** + * Program entry point + * @param args command line args + */ + public static void main(String[] args) { + System.out.println("Green dragon spotted ahead!"); + DragonSlayer dragonSlayer = new DragonSlayer(new MeleeStrategy()); + dragonSlayer.goToBattle(); + System.out.println("Red dragon emerges."); + dragonSlayer.changeStrategy(new ProjectileStrategy()); + dragonSlayer.goToBattle(); + System.out.println("Black dragon lands before you."); + dragonSlayer.changeStrategy(new SpellStrategy()); + dragonSlayer.goToBattle(); + } +} diff --git a/strategy/src/test/java/com/iluwatar/strategy/AppTest.java b/strategy/src/test/java/com/iluwatar/strategy/AppTest.java index e46708c0a..e6748d30d 100644 --- a/strategy/src/test/java/com/iluwatar/strategy/AppTest.java +++ b/strategy/src/test/java/com/iluwatar/strategy/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.strategy; - -import org.junit.Test; - -import com.iluwatar.strategy.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.strategy; + +import org.junit.Test; + +import com.iluwatar.strategy.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From fde7f71704a82f9a54463a044128e77bc8381305 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:19:55 +0300 Subject: [PATCH 155/687] #107 Template Method JavaDoc --- .../java/com/iluwatar/templatemethod/App.java | 44 ++++++++------- .../templatemethod/HalflingThief.java | 46 ++++++++-------- .../templatemethod/HitAndRunMethod.java | 50 ++++++++--------- .../iluwatar/templatemethod/SubtleMethod.java | 54 +++++++++---------- .../com/iluwatar/templatemethod/AppTest.java | 33 +++++++----- 5 files changed, 118 insertions(+), 109 deletions(-) diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/App.java b/template-method/src/main/java/com/iluwatar/templatemethod/App.java index 9797474cf..c9927e91b 100644 --- a/template-method/src/main/java/com/iluwatar/templatemethod/App.java +++ b/template-method/src/main/java/com/iluwatar/templatemethod/App.java @@ -1,20 +1,24 @@ -package com.iluwatar.templatemethod; - -/** - * - * Template Method defines a skeleton for an algorithm. The algorithm subclasses - * provide implementation for the blank parts. - * - * In this example HalflingThief contains StealingMethod that can be changed. - * First the thief hits with HitAndRunMethod and then with SubtleMethod. - * - */ -public class App { - - public static void main(String[] args) { - HalflingThief thief = new HalflingThief(new HitAndRunMethod()); - thief.steal(); - thief.changeMethod(new SubtleMethod()); - thief.steal(); - } -} +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(); + } +} diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java b/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java index 3cdb2f1b1..4d6cecb9f 100644 --- a/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java +++ b/template-method/src/main/java/com/iluwatar/templatemethod/HalflingThief.java @@ -1,23 +1,23 @@ -package com.iluwatar.templatemethod; - -/** - * - * Halfling thief uses 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; - } -} +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; + } +} diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java index 78ee2031b..633e52895 100644 --- a/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java +++ b/template-method/src/main/java/com/iluwatar/templatemethod/HitAndRunMethod.java @@ -1,25 +1,25 @@ -package com.iluwatar.templatemethod; - -/** - * - * HitAndRunMethod implementation of StealingMethod. - * - */ -public class HitAndRunMethod extends StealingMethod { - - @Override - protected String pickTarget() { - return "old goblin woman"; - } - - @Override - protected void confuseTarget(String target) { - System.out.println("Approach the " + target + " from behind."); - } - - @Override - protected void stealTheItem(String target) { - System.out.println("Grab the handbag and run away fast!"); - } - -} +package com.iluwatar.templatemethod; + +/** + * + * HitAndRunMethod implementation of {@link StealingMethod}. + * + */ +public class HitAndRunMethod extends StealingMethod { + + @Override + protected String pickTarget() { + return "old goblin woman"; + } + + @Override + protected void confuseTarget(String target) { + System.out.println("Approach the " + target + " from behind."); + } + + @Override + protected void stealTheItem(String target) { + System.out.println("Grab the handbag and run away fast!"); + } + +} diff --git a/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java b/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java index c5bd1cfaf..f506d682b 100644 --- a/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java +++ b/template-method/src/main/java/com/iluwatar/templatemethod/SubtleMethod.java @@ -1,27 +1,27 @@ -package com.iluwatar.templatemethod; - -/** - * - * SubtleMethod implementation of StealingMethod. - * - */ -public class SubtleMethod extends StealingMethod { - - @Override - protected String pickTarget() { - return "shop keeper"; - } - - @Override - protected void confuseTarget(String target) { - System.out.println("Approach the " + target - + " with tears running and hug him!"); - } - - @Override - protected void stealTheItem(String target) { - System.out.println("While in close contact grab the " + target - + "'s wallet."); - } - -} +package com.iluwatar.templatemethod; + +/** + * + * SubtleMethod implementation of {@link StealingMethod}. + * + */ +public class SubtleMethod extends StealingMethod { + + @Override + protected String pickTarget() { + return "shop keeper"; + } + + @Override + protected void confuseTarget(String target) { + System.out.println("Approach the " + target + + " with tears running and hug him!"); + } + + @Override + protected void stealTheItem(String target) { + System.out.println("While in close contact grab the " + target + + "'s wallet."); + } + +} diff --git a/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java b/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java index fce07bef1..bd4e2d332 100644 --- a/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java +++ b/template-method/src/test/java/com/iluwatar/templatemethod/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.templatemethod; - -import org.junit.Test; - -import com.iluwatar.templatemethod.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.templatemethod; + +import org.junit.Test; + +import com.iluwatar.templatemethod.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 0bda2bda1ed875d6b3796437e47465d3c86931ea Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:23:01 +0300 Subject: [PATCH 156/687] #107 Thread Pool JavaDoc --- .../src/main/java/com/iluwatar/threadpool/App.java | 11 ++++++++--- .../src/main/java/com/iluwatar/threadpool/Worker.java | 2 +- .../test/java/com/iluwatar/threadpool/AppTest.java | 5 +++++ 3 files changed, 14 insertions(+), 4 deletions(-) diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/App.java b/thread-pool/src/main/java/com/iluwatar/threadpool/App.java index 0a7bed3a0..bfaaead31 100644 --- a/thread-pool/src/main/java/com/iluwatar/threadpool/App.java +++ b/thread-pool/src/main/java/com/iluwatar/threadpool/App.java @@ -13,14 +13,19 @@ import java.util.concurrent.Executors; * 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 Worker object that implements Runnable. We create an ExecutorService with - * fixed number of threads (Thread Pool) and use them to execute the Workers. + * 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 { + /** + * Program entry point + * @param args command line args + */ public static void main( String[] args ) { System.out.println("Program started"); diff --git a/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java b/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java index b6ee5e665..92da4b5dd 100644 --- a/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java +++ b/thread-pool/src/main/java/com/iluwatar/threadpool/Worker.java @@ -2,7 +2,7 @@ package com.iluwatar.threadpool; /** * - * Worker implements Runnable and thus can be executed by ExecutorService + * Worker implements {@link Runnable} and thus can be executed by {@link ExecutorService} * */ public class Worker implements Runnable { diff --git a/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java b/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java index ec5c031ff..71cfea5f7 100644 --- a/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java +++ b/thread-pool/src/test/java/com/iluwatar/threadpool/AppTest.java @@ -4,6 +4,11 @@ import org.junit.Test; import com.iluwatar.threadpool.App; +/** + * Application test + * @author ilkka + * + */ public class AppTest { @Test From 35e1afd7dcb20c03b53b915ae6c921fe3b43c0a4 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:25:22 +0300 Subject: [PATCH 157/687] #107 Tolerant Reader JavaDoc --- .../src/main/java/com/iluwatar/tolerantreader/App.java | 10 +++++----- .../iluwatar/tolerantreader/RainbowFishSerializer.java | 4 ++-- .../test/java/com/iluwatar/tolerantreader/AppTest.java | 6 +++++- 3 files changed, 12 insertions(+), 8 deletions(-) diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java index ab4a8bfad..d4ff933d7 100644 --- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java +++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/App.java @@ -7,14 +7,14 @@ 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 RainbowFish - * objects to file. RainbowFish is the initial version which we can easily read and - * write using RainbowFishSerializer methods. RainbowFish then evolves to RainbowFishV2 + *

    + * 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 RainbowFishV2 has new fields that are serialized. + * pattern and does not break even though {@link RainbowFishV2} has new fields that are serialized. * */ public class App { diff --git a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java index ec482a34a..e788bcad4 100644 --- a/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java +++ b/tolerant-reader/src/main/java/com/iluwatar/tolerantreader/RainbowFishSerializer.java @@ -10,8 +10,8 @@ import java.util.Map; /** * - * RainbowFishSerializer provides methods for reading and writing RainbowFish objects to file. - * Tolerant Reader pattern is implemented here by serializing maps instead of RainbowFish objects. + * 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. * */ diff --git a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java index cba24ada9..bc5066866 100644 --- a/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java +++ b/tolerant-reader/src/test/java/com/iluwatar/tolerantreader/AppTest.java @@ -9,7 +9,11 @@ import org.junit.Test; import com.iluwatar.tolerantreader.App; - +/** + * + * Application test + * + */ public class AppTest { @Test From d220a0753a8598e57d63775f5080e482fb376378 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Fri, 21 Aug 2015 23:27:25 +0300 Subject: [PATCH 158/687] #107 Improve JavaDoc for Visitor example --- .../main/java/com/iluwatar/visitor/App.java | 58 ++++++++++--------- .../java/com/iluwatar/visitor/AppTest.java | 33 ++++++----- 2 files changed, 50 insertions(+), 41 deletions(-) diff --git a/visitor/src/main/java/com/iluwatar/visitor/App.java b/visitor/src/main/java/com/iluwatar/visitor/App.java index d9338777c..dfdd4fcb6 100644 --- a/visitor/src/main/java/com/iluwatar/visitor/App.java +++ b/visitor/src/main/java/com/iluwatar/visitor/App.java @@ -1,27 +1,31 @@ -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 Commander. - * This hierarchy is traversed by visitors. SoldierVisitor applies - * its operation on Soldiers, SergeantVisitor on Sergeants and so - * on. - * - */ -public class App { - - 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()); - - } -} +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()); + + } +} diff --git a/visitor/src/test/java/com/iluwatar/visitor/AppTest.java b/visitor/src/test/java/com/iluwatar/visitor/AppTest.java index 5ba48c6c9..66db8c2e3 100644 --- a/visitor/src/test/java/com/iluwatar/visitor/AppTest.java +++ b/visitor/src/test/java/com/iluwatar/visitor/AppTest.java @@ -1,14 +1,19 @@ -package com.iluwatar.visitor; - -import org.junit.Test; - -import com.iluwatar.visitor.App; - -public class AppTest { - - @Test - public void test() { - String[] args = {}; - App.main(args); - } -} +package com.iluwatar.visitor; + +import org.junit.Test; + +import com.iluwatar.visitor.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 254dc62d836d31cc08573a18680e3e814071fc02 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sat, 22 Aug 2015 13:32:14 +0530 Subject: [PATCH 159/687] Fixed: Broken link in half-sync/half-async The class diagram link was broken fixed it. --- half-sync-half-async/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md index b21c97bc4..afeb20037 100644 --- a/half-sync-half-async/index.md +++ b/half-sync-half-async/index.md @@ -11,7 +11,7 @@ tags: Java asynchronous I/O in a system to simplify concurrent programming effort without degrading execution efficiency. -![Half-Sync/Half-Async class diagram](./half-sync-half-async/etc/half-sync-half-async.png) +![Half-Sync/Half-Async class diagram](./etc/half-sync-half-async.png) **Applicability:** Use Half-Sync/Half-Async pattern when From da6d92d125e3f8d34c41583224ab28c056460ec8 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 12:34:30 +0300 Subject: [PATCH 160/687] Update Maven dependencies --- pom.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/pom.xml b/pom.xml index de87da567..5a154164e 100644 --- a/pom.xml +++ b/pom.xml @@ -9,9 +9,9 @@ UTF-8 - 5.0.0.CR2 - 1.8.1.RELEASE - 1.4.187 + 5.0.0.Final + 1.8.2.RELEASE + 1.4.188 4.12 3.0 3.1.0 From c4912b2a2b3c2fa90a3005c87b6ba6e176cafd77 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 14:54:43 +0300 Subject: [PATCH 161/687] #143 Skeleton for Message Channel EIP example --- message-channel/.gitignore | 1 + message-channel/pom.xml | 19 +++++++++++++++++++ .../com/iluwatar/message/channel/App.java | 8 ++++++++ .../com/iluwatar/message/channel/AppTest.java | 17 +++++++++++++++++ pom.xml | 1 + 5 files changed, 46 insertions(+) create mode 100644 message-channel/.gitignore create mode 100644 message-channel/pom.xml create mode 100644 message-channel/src/main/java/com/iluwatar/message/channel/App.java create mode 100644 message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java diff --git a/message-channel/.gitignore b/message-channel/.gitignore new file mode 100644 index 000000000..b83d22266 --- /dev/null +++ b/message-channel/.gitignore @@ -0,0 +1 @@ +/target/ diff --git a/message-channel/pom.xml b/message-channel/pom.xml new file mode 100644 index 000000000..6b3b3bb94 --- /dev/null +++ b/message-channel/pom.xml @@ -0,0 +1,19 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.5.0 + + message-channel + + + junit + junit + test + + + diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java new file mode 100644 index 000000000..4eeddab85 --- /dev/null +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -0,0 +1,8 @@ +package com.iluwatar.message.channel; + +public class App { + + public static void main(String[] args) { + System.out.println("Hello World!"); + } +} diff --git a/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java b/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java new file mode 100644 index 000000000..05e2aa01e --- /dev/null +++ b/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java @@ -0,0 +1,17 @@ +package com.iluwatar.message.channel; + +import org.junit.Test; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} diff --git a/pom.xml b/pom.xml index 5a154164e..35f442213 100644 --- a/pom.xml +++ b/pom.xml @@ -75,6 +75,7 @@ half-sync-half-async step-builder layers + message-channel From cd4d4203763d50fd97aa2f81ed2ec08a6f2ad273 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 15:43:44 +0300 Subject: [PATCH 162/687] #143 Added Camel dependency --- message-channel/pom.xml | 4 ++++ .../main/java/com/iluwatar/message/channel/App.java | 10 ++++++++-- .../java/com/iluwatar/message/channel/AppTest.java | 2 +- pom.xml | 6 ++++++ 4 files changed, 19 insertions(+), 3 deletions(-) diff --git a/message-channel/pom.xml b/message-channel/pom.xml index 6b3b3bb94..a8a7f4ee2 100644 --- a/message-channel/pom.xml +++ b/message-channel/pom.xml @@ -10,6 +10,10 @@ message-channel + + org.apache.camel + camel-core + junit junit diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java index 4eeddab85..9e8c4ba85 100644 --- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -1,8 +1,14 @@ package com.iluwatar.message.channel; +import org.apache.camel.CamelContext; +import org.apache.camel.impl.DefaultCamelContext; + public class App { - public static void main(String[] args) { - System.out.println("Hello World!"); + public static void main(String[] args) throws Exception { + CamelContext context = new DefaultCamelContext(); + context.start(); + Thread.sleep(10000); + context.stop(); } } diff --git a/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java b/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java index 05e2aa01e..fa3af1161 100644 --- a/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java +++ b/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java @@ -10,7 +10,7 @@ import org.junit.Test; public class AppTest { @Test - public void test() { + public void test() throws Exception { String[] args = {}; App.main(args); } diff --git a/pom.xml b/pom.xml index 35f442213..7300c5f00 100644 --- a/pom.xml +++ b/pom.xml @@ -17,6 +17,7 @@ 3.1.0 0.7.2.201409121644 1.4 + 2.15.3 abstract-factory @@ -105,6 +106,11 @@ commons-dbcp ${commons-dbcp.version} + + org.apache.camel + camel-core + ${camel.version} + junit junit From acd7070831997a37e7cda3e19040a22ffa00b751 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 16:37:19 +0300 Subject: [PATCH 163/687] #143 Work on the example code --- message-channel/pom.xml | 4 ++++ .../java/com/iluwatar/message/channel/App.java | 15 ++++++++++++++- pom.xml | 5 +++++ 3 files changed, 23 insertions(+), 1 deletion(-) diff --git a/message-channel/pom.xml b/message-channel/pom.xml index a8a7f4ee2..ce29ac9fd 100644 --- a/message-channel/pom.xml +++ b/message-channel/pom.xml @@ -14,6 +14,10 @@ org.apache.camel camel-core + + org.apache.camel + camel-stream + junit junit diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java index 9e8c4ba85..64201fdfb 100644 --- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -1,14 +1,27 @@ package com.iluwatar.message.channel; import org.apache.camel.CamelContext; +import org.apache.camel.ProducerTemplate; +import org.apache.camel.builder.RouteBuilder; import org.apache.camel.impl.DefaultCamelContext; public class App { public static void main(String[] args) throws Exception { CamelContext context = new DefaultCamelContext(); + + context.addRoutes(new RouteBuilder() { + + @Override + public void configure() throws Exception { + from("direct:greetings").to("stream:out"); + } + }); + context.start(); - Thread.sleep(10000); + ProducerTemplate template = context.createProducerTemplate(); + template.sendBody("direct:greetings", "jou man"); + Thread.sleep(1000); context.stop(); } } diff --git a/pom.xml b/pom.xml index 7300c5f00..391ddd9c1 100644 --- a/pom.xml +++ b/pom.xml @@ -111,6 +111,11 @@ camel-core ${camel.version} + + org.apache.camel + camel-stream + ${camel.version} + junit junit From b3574e5e23da50a21821b55ed8329a99787b4c77 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 19:07:01 +0300 Subject: [PATCH 164/687] #143 Improve example code and add class diagram --- message-channel/etc/message-channel.png | Bin 0 -> 45921 bytes message-channel/etc/message-channel.ucls | 304 ++++++++++++++++++ .../com/iluwatar/message/channel/App.java | 5 +- 3 files changed, 305 insertions(+), 4 deletions(-) create mode 100644 message-channel/etc/message-channel.png create mode 100644 message-channel/etc/message-channel.ucls diff --git a/message-channel/etc/message-channel.png b/message-channel/etc/message-channel.png new file mode 100644 index 0000000000000000000000000000000000000000..d29490724b688cc934076455d2d17a8f860bf799 GIT binary patch literal 45921 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%0A9IqP>GyB~cl`80v>X=K?~Ox5&J|B9Um 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 literal 0 HcmV?d00001 diff --git a/message-channel/etc/message-channel.ucls b/message-channel/etc/message-channel.ucls new file mode 100644 index 000000000..27e99e539 --- /dev/null +++ b/message-channel/etc/message-channel.ucls @@ -0,0 +1,304 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java index 64201fdfb..b4d7b8576 100644 --- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -1,7 +1,6 @@ package com.iluwatar.message.channel; import org.apache.camel.CamelContext; -import org.apache.camel.ProducerTemplate; import org.apache.camel.builder.RouteBuilder; import org.apache.camel.impl.DefaultCamelContext; @@ -19,9 +18,7 @@ public class App { }); context.start(); - ProducerTemplate template = context.createProducerTemplate(); - template.sendBody("direct:greetings", "jou man"); - Thread.sleep(1000); + context.getRoutes().stream().forEach((r) -> System.out.println(r)); context.stop(); } } From 96dc4cdddb3a9dfd90b267b29b6098344a54a527 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 19:33:11 +0300 Subject: [PATCH 165/687] #143 Commented the example --- .../com/iluwatar/message/channel/App.java | 29 ++++++++++++++++++- 1 file changed, 28 insertions(+), 1 deletion(-) diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java index b4d7b8576..ef4f92d3e 100644 --- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -4,8 +4,35 @@ import org.apache.camel.CamelContext; import org.apache.camel.builder.RouteBuilder; import org.apache.camel.impl.DefaultCamelContext; +/** + * + * 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 Channels are logical addresses in the messaging system. + *

    + * 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 a direct synchronous Message Channel + * that delivers messages to console output. No actual messages are sent, only the established + * routes are printed to standard output. + * + */ public class App { - + + /** + * Program entry point + * @param args command line args + * @throws Exception + */ public static void main(String[] args) throws Exception { CamelContext context = new DefaultCamelContext(); From 6b94390f76060a9b8221dea2a7585348725ec73c Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sat, 22 Aug 2015 19:43:21 +0300 Subject: [PATCH 166/687] #143 Added pattern description to index.md --- message-channel/index.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 message-channel/index.md diff --git a/message-channel/index.md b/message-channel/index.md new file mode 100644 index 000000000..80a068de5 --- /dev/null +++ b/message-channel/index.md @@ -0,0 +1,17 @@ +--- +layout: pattern +title: Message Channel +folder: message-channel +permalink: /patterns/message-channel/ +categories: Integration +tags: Java +--- + +**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 From 99adb5b0cfa9f54962eb82c536a3b714e4a377e7 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sun, 23 Aug 2015 11:48:57 +0530 Subject: [PATCH 167/687] Work on #74 Initial logging server example --- reactor/pom.xml | 18 ++++ .../main/java/com/iluwatar/reactor/App.java | 42 ++++++++ .../java/com/iluwatar/reactor/AppClient.java | 62 ++++++++++++ .../java/com/iluwatar/reactor/NioReactor.java | 96 +++++++++++++++++++ 4 files changed, 218 insertions(+) create mode 100644 reactor/pom.xml create mode 100644 reactor/src/main/java/com/iluwatar/reactor/App.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/AppClient.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/NioReactor.java diff --git a/reactor/pom.xml b/reactor/pom.xml new file mode 100644 index 000000000..0f3271a9c --- /dev/null +++ b/reactor/pom.xml @@ -0,0 +1,18 @@ + + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.5.0 + + reactor + + + junit + junit + test + + + diff --git a/reactor/src/main/java/com/iluwatar/reactor/App.java b/reactor/src/main/java/com/iluwatar/reactor/App.java new file mode 100644 index 000000000..d5cd05fec --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/App.java @@ -0,0 +1,42 @@ +package com.iluwatar.reactor; + +import java.io.IOException; +import java.nio.ByteBuffer; +import java.nio.channels.SocketChannel; + +import com.iluwatar.reactor.NioReactor.NioChannelEventHandler; + +public class App { + + public static void main(String[] args) { + try { + new NioReactor(6666, new LoggingServer()).start(); + } catch (IOException e) { + e.printStackTrace(); + } + } + + static class LoggingServer implements NioChannelEventHandler { + + @Override + public void onReadable(SocketChannel channel) { + ByteBuffer requestBuffer = ByteBuffer.allocate(1024); + try { + int byteCount = channel.read(requestBuffer); + if (byteCount > 0) { + byte[] logRequestContents = new byte[byteCount]; + byte[] array = requestBuffer.array(); + System.arraycopy(array, 0, logRequestContents, 0, byteCount); + doLogging(new String(logRequestContents)); + } + } catch (IOException e) { + e.printStackTrace(); + } + } + + private void doLogging(String log) { + // do logging at server side + System.out.println(log); + } + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java new file mode 100644 index 000000000..a5d871462 --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java @@ -0,0 +1,62 @@ +package com.iluwatar.reactor; + +import java.io.IOException; +import java.io.OutputStream; +import java.io.PrintWriter; +import java.net.InetAddress; +import java.net.Socket; + +public class AppClient { + + public static void main(String[] args) { + new LoggingClient("Client 1", 6666).start(); + } + + + /* + * A logging client that sends logging requests to logging server + */ + static class LoggingClient { + + private int serverPort; + private String clientName; + + public LoggingClient(String clientName, int serverPort) { + this.clientName = clientName; + this.serverPort = serverPort; + } + + public void start() { + Socket socket = null; + try { + socket = new Socket(InetAddress.getLocalHost(), serverPort); + OutputStream outputStream = socket.getOutputStream(); + PrintWriter writer = new PrintWriter(outputStream); + writeLogs(writer); + } catch (IOException e) { + e.printStackTrace(); + throw new RuntimeException(e); + } finally { + if (socket != null) { + try { + socket.close(); + } catch (IOException e) { + e.printStackTrace(); + } + } + } + } + + private void writeLogs(PrintWriter writer) { + for (int i = 0; i < 10; i++) { + writer.println(clientName + " - Log request: " + i); + try { + Thread.sleep(1000); + } catch (InterruptedException e) { + e.printStackTrace(); + } + writer.flush(); + } + } + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java new file mode 100644 index 000000000..b2952397c --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java @@ -0,0 +1,96 @@ +package com.iluwatar.reactor; + +import java.io.IOException; +import java.net.InetSocketAddress; +import java.nio.channels.SelectionKey; +import java.nio.channels.Selector; +import java.nio.channels.ServerSocketChannel; +import java.nio.channels.SocketChannel; +import java.util.Set; + +public class NioReactor { + + private int port; + private Selector selector; + private ServerSocketChannel serverSocketChannel; + private NioChannelEventHandler nioEventhandler; + + public NioReactor(int port, NioChannelEventHandler handler) { + this.port = port; + this.nioEventhandler = handler; + } + + + public void start() throws IOException { + startReactor(); + requestLoop(); + } + + private void startReactor() throws IOException { + selector = Selector.open(); + serverSocketChannel = ServerSocketChannel.open(); + serverSocketChannel.socket().bind(new InetSocketAddress(port)); + serverSocketChannel.configureBlocking(false); + SelectionKey acceptorKey = serverSocketChannel.register(selector, SelectionKey.OP_ACCEPT); + acceptorKey.attach(new Acceptor()); + System.out.println("Reactor started listening on port: " + port); + } + + private void requestLoop() throws IOException { + while (true) { + selector.select(); + Set keys = selector.selectedKeys(); + for (SelectionKey key : keys) { + dispatchEvent(key); + } + keys.clear(); + } + } + + private void dispatchEvent(SelectionKey key) throws IOException { + Object handler = key.attachment(); + if (handler != null) { + ((EventHandler)handler).handle(); + } + } + + interface EventHandler { + void handle() throws IOException; + } + + private class Acceptor implements EventHandler { + + public void handle() throws IOException { + // non-blocking accept as acceptor will only be called when accept event is available + SocketChannel clientChannel = serverSocketChannel.accept(); + if (clientChannel != null) { + new ChannelHandler(clientChannel).handle(); + } + System.out.println("Connection established with a client"); + } + } + + public static interface NioChannelEventHandler { + void onReadable(SocketChannel channel); + } + + private class ChannelHandler implements EventHandler { + + private SocketChannel clientChannel; + private SelectionKey selectionKey; + + public ChannelHandler(SocketChannel clientChannel) throws IOException { + this.clientChannel = clientChannel; + clientChannel.configureBlocking(false); + selectionKey = clientChannel.register(selector, 0); + selectionKey.attach(this); + selectionKey.interestOps(SelectionKey.OP_READ); + selector.wakeup(); + } + + public void handle() throws IOException { + // only read events are supported. + nioEventhandler.onReadable(clientChannel); + } + } +} From d3f2ea22ac422ddac4d7d9733c45e3ebc46e6001 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Sun, 23 Aug 2015 18:51:24 +0530 Subject: [PATCH 168/687] Work on #74, enhanced reactor to allow multiple channels --- .../main/java/com/iluwatar/reactor/App.java | 31 +++++++- .../java/com/iluwatar/reactor/AppClient.java | 9 ++- .../java/com/iluwatar/reactor/NioReactor.java | 79 ++++++++++++------- 3 files changed, 84 insertions(+), 35 deletions(-) diff --git a/reactor/src/main/java/com/iluwatar/reactor/App.java b/reactor/src/main/java/com/iluwatar/reactor/App.java index d5cd05fec..4c7b06e9d 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/App.java +++ b/reactor/src/main/java/com/iluwatar/reactor/App.java @@ -1,7 +1,11 @@ package com.iluwatar.reactor; import java.io.IOException; +import java.net.InetSocketAddress; import java.nio.ByteBuffer; +import java.nio.channels.DatagramChannel; +import java.nio.channels.SelectableChannel; +import java.nio.channels.ServerSocketChannel; import java.nio.channels.SocketChannel; import com.iluwatar.reactor.NioReactor.NioChannelEventHandler; @@ -10,12 +14,35 @@ public class App { public static void main(String[] args) { try { - new NioReactor(6666, new LoggingServer()).start(); + NioReactor reactor = new NioReactor(); + + reactor + .registerChannel(tcpChannel(6666)) + .registerChannel(tcpChannel(6667)) + .start(); + + reactor.registerHandler(new LoggingServer()); } catch (IOException e) { e.printStackTrace(); } } - + + private static SelectableChannel udpChannel(int port) throws IOException { + DatagramChannel channel = DatagramChannel.open(); + channel.socket().bind(new InetSocketAddress(port)); + channel.configureBlocking(false); + System.out.println("Bound UDP socket at port: " + port); + return channel; + } + + private static SelectableChannel tcpChannel(int port) throws IOException { + ServerSocketChannel channel = ServerSocketChannel.open(); + channel.socket().bind(new InetSocketAddress(port)); + channel.configureBlocking(false); + System.out.println("Bound TCP socket at port: " + port); + return channel; + } + static class LoggingServer implements NioChannelEventHandler { @Override diff --git a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java index a5d871462..1181745fb 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java +++ b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java @@ -9,14 +9,15 @@ import java.net.Socket; public class AppClient { public static void main(String[] args) { - new LoggingClient("Client 1", 6666).start(); + new Thread(new LoggingClient("Client 1", 6666)).start(); + new Thread(new LoggingClient("Client 2", 6667)).start(); } /* * A logging client that sends logging requests to logging server */ - static class LoggingClient { + static class LoggingClient implements Runnable { private int serverPort; private String clientName; @@ -26,7 +27,7 @@ public class AppClient { this.serverPort = serverPort; } - public void start() { + public void run() { Socket socket = null; try { socket = new Socket(InetAddress.getLocalHost(), serverPort); @@ -51,7 +52,7 @@ public class AppClient { for (int i = 0; i < 10; i++) { writer.println(clientName + " - Log request: " + i); try { - Thread.sleep(1000); + Thread.sleep(100); } catch (InterruptedException e) { e.printStackTrace(); } diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java index b2952397c..734ea086f 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java +++ b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java @@ -1,44 +1,63 @@ package com.iluwatar.reactor; import java.io.IOException; -import java.net.InetSocketAddress; +import java.nio.channels.SelectableChannel; import java.nio.channels.SelectionKey; import java.nio.channels.Selector; import java.nio.channels.ServerSocketChannel; import java.nio.channels.SocketChannel; +import java.util.List; import java.util.Set; +import java.util.concurrent.CopyOnWriteArrayList; +/* + * Abstractions + * --------------- + * + * 1 - Dispatcher + * 2 - Synchronous Event De-multiplexer + * 3 - Event + * 4 - Event Handler & concrete event handler (application business logic) + * 5 - Selector + */ public class NioReactor { - private int port; private Selector selector; - private ServerSocketChannel serverSocketChannel; - private NioChannelEventHandler nioEventhandler; - - public NioReactor(int port, NioChannelEventHandler handler) { - this.port = port; - this.nioEventhandler = handler; + private Acceptor acceptor; + private List eventHandlers = new CopyOnWriteArrayList<>(); + + public NioReactor() throws IOException { + this.acceptor = new Acceptor(); + this.selector = Selector.open(); } + public NioReactor registerChannel(SelectableChannel channel) throws IOException { + SelectionKey key = channel.register(selector, SelectionKey.OP_ACCEPT); + key.attach(acceptor); + return this; + } + + public void registerHandler(NioChannelEventHandler handler) { + eventHandlers.add(handler); + } public void start() throws IOException { - startReactor(); - requestLoop(); + new Thread( new Runnable() { + @Override + public void run() { + try { + System.out.println("Reactor started, waiting for events..."); + eventLoop(); + } catch (IOException e) { + e.printStackTrace(); + } + } + }).start(); } - private void startReactor() throws IOException { - selector = Selector.open(); - serverSocketChannel = ServerSocketChannel.open(); - serverSocketChannel.socket().bind(new InetSocketAddress(port)); - serverSocketChannel.configureBlocking(false); - SelectionKey acceptorKey = serverSocketChannel.register(selector, SelectionKey.OP_ACCEPT); - acceptorKey.attach(new Acceptor()); - System.out.println("Reactor started listening on port: " + port); - } - - private void requestLoop() throws IOException { + private void eventLoop() throws IOException { while (true) { - selector.select(); + selector.select(1000); Set keys = selector.selectedKeys(); for (SelectionKey key : keys) { dispatchEvent(key); @@ -50,21 +69,21 @@ public class NioReactor { private void dispatchEvent(SelectionKey key) throws IOException { Object handler = key.attachment(); if (handler != null) { - ((EventHandler)handler).handle(); + ((EventHandler)handler).handle(key.channel()); } } interface EventHandler { - void handle() throws IOException; + void handle(SelectableChannel channel) throws IOException; } private class Acceptor implements EventHandler { - public void handle() throws IOException { + public void handle(SelectableChannel channel) throws IOException { // non-blocking accept as acceptor will only be called when accept event is available - SocketChannel clientChannel = serverSocketChannel.accept(); + SocketChannel clientChannel = ((ServerSocketChannel)channel).accept(); if (clientChannel != null) { - new ChannelHandler(clientChannel).handle(); + new ChannelHandler(clientChannel).handle(clientChannel); } System.out.println("Connection established with a client"); } @@ -88,9 +107,11 @@ public class NioReactor { selector.wakeup(); } - public void handle() throws IOException { + public void handle(SelectableChannel channel) throws IOException { // only read events are supported. - nioEventhandler.onReadable(clientChannel); + for (NioChannelEventHandler eventHandler : eventHandlers) { + eventHandler.onReadable(clientChannel); + } } } } From ec8203a196106ac6cbb732775af153ff4b15dfd6 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 26 Aug 2015 20:12:17 +0530 Subject: [PATCH 169/687] Ongoing work on #74 introduced better abstractions in reactor - tcp and udp mode --- .../iluwatar/reactor/AbstractNioChannel.java | 75 ++++++++ .../main/java/com/iluwatar/reactor/App.java | 61 ++----- .../java/com/iluwatar/reactor/AppClient.java | 63 ++++++- .../com/iluwatar/reactor/ChannelHandler.java | 9 + .../java/com/iluwatar/reactor/Dispatcher.java | 8 + .../com/iluwatar/reactor/LoggingHandler.java | 24 +++ .../iluwatar/reactor/NioDatagramChannel.java | 47 +++++ .../java/com/iluwatar/reactor/NioReactor.java | 161 +++++++++++------- .../reactor/NioServerSocketChannel.java | 52 ++++++ .../reactor/SameThreadDispatcher.java | 14 ++ .../reactor/ThreadPoolDispatcher.java | 27 +++ reactor/todo.txt | 4 + 12 files changed, 429 insertions(+), 116 deletions(-) create mode 100644 reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java create mode 100644 reactor/todo.txt diff --git a/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java new file mode 100644 index 000000000..9f6040ade --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java @@ -0,0 +1,75 @@ +package com.iluwatar.reactor; + +import java.io.IOException; +import java.nio.ByteBuffer; +import java.nio.channels.SelectableChannel; +import java.nio.channels.SelectionKey; +import java.util.Map; +import java.util.Queue; +import java.util.concurrent.ConcurrentHashMap; +import java.util.concurrent.ConcurrentLinkedQueue; + +public abstract class AbstractNioChannel { + + private SelectableChannel channel; + private ChannelHandler handler; + private Map> channelToPendingWrites = new ConcurrentHashMap<>(); + private NioReactor reactor; + + public AbstractNioChannel(ChannelHandler handler, SelectableChannel channel) { + this.handler = handler; + this.channel = channel; + } + + public void setReactor(NioReactor reactor) { + this.reactor = reactor; + } + + public SelectableChannel getChannel() { + return channel; + } + + public abstract int getInterestedOps(); + + public abstract ByteBuffer read(SelectionKey key) throws IOException; + + public void setHandler(ChannelHandler handler) { + this.handler = handler; + } + + public ChannelHandler getHandler() { + return handler; + } + + // Called from the context of reactor thread + public void write(SelectionKey key) throws IOException { + Queue pendingWrites = channelToPendingWrites.get(key.channel()); + while (true) { + ByteBuffer pendingWrite = pendingWrites.poll(); + if (pendingWrite == null) { + System.out.println("No more pending writes"); + reactor.changeOps(key, SelectionKey.OP_READ); + break; + } + + doWrite(pendingWrite, key); + } + } + + protected abstract void doWrite(ByteBuffer pendingWrite, SelectionKey key) throws IOException; + + public void write(ByteBuffer buffer, 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(buffer); + reactor.changeOps(key, SelectionKey.OP_WRITE); + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/App.java b/reactor/src/main/java/com/iluwatar/reactor/App.java index 4c7b06e9d..36aa5290d 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/App.java +++ b/reactor/src/main/java/com/iluwatar/reactor/App.java @@ -1,69 +1,32 @@ package com.iluwatar.reactor; import java.io.IOException; -import java.net.InetSocketAddress; -import java.nio.ByteBuffer; -import java.nio.channels.DatagramChannel; -import java.nio.channels.SelectableChannel; -import java.nio.channels.ServerSocketChannel; -import java.nio.channels.SocketChannel; - -import com.iluwatar.reactor.NioReactor.NioChannelEventHandler; public class App { public static void main(String[] args) { try { - NioReactor reactor = new NioReactor(); - + NioReactor reactor = new NioReactor(new ThreadPoolDispatcher(2)); + LoggingHandler loggingHandler = new LoggingHandler(); reactor - .registerChannel(tcpChannel(6666)) - .registerChannel(tcpChannel(6667)) + .registerChannel(tcpChannel(6666, loggingHandler)) + .registerChannel(tcpChannel(6667, loggingHandler)) + .registerChannel(udpChannel(6668, loggingHandler)) .start(); - - reactor.registerHandler(new LoggingServer()); } catch (IOException e) { e.printStackTrace(); } } - private static SelectableChannel udpChannel(int port) throws IOException { - DatagramChannel channel = DatagramChannel.open(); - channel.socket().bind(new InetSocketAddress(port)); - channel.configureBlocking(false); - System.out.println("Bound UDP socket at port: " + port); + private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException { + NioServerSocketChannel channel = new NioServerSocketChannel(port, handler); + channel.bind(); return channel; } - - private static SelectableChannel tcpChannel(int port) throws IOException { - ServerSocketChannel channel = ServerSocketChannel.open(); - channel.socket().bind(new InetSocketAddress(port)); - channel.configureBlocking(false); - System.out.println("Bound TCP socket at port: " + port); + + private static AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException { + NioDatagramChannel channel = new NioDatagramChannel(port, handler); + channel.bind(); return channel; } - - static class LoggingServer implements NioChannelEventHandler { - - @Override - public void onReadable(SocketChannel channel) { - ByteBuffer requestBuffer = ByteBuffer.allocate(1024); - try { - int byteCount = channel.read(requestBuffer); - if (byteCount > 0) { - byte[] logRequestContents = new byte[byteCount]; - byte[] array = requestBuffer.array(); - System.arraycopy(array, 0, logRequestContents, 0, byteCount); - doLogging(new String(logRequestContents)); - } - } catch (IOException e) { - e.printStackTrace(); - } - } - - private void doLogging(String log) { - // do logging at server side - System.out.println(log); - } - } } diff --git a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java index 1181745fb..3d7323a55 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java +++ b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java @@ -1,16 +1,22 @@ package com.iluwatar.reactor; 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.SocketException; public class AppClient { public static void main(String[] args) { - new Thread(new LoggingClient("Client 1", 6666)).start(); - new Thread(new LoggingClient("Client 2", 6667)).start(); +// new Thread(new LoggingClient("Client 1", 6666)).start(); +// new Thread(new LoggingClient("Client 2", 6667)).start(); + new Thread(new UDPLoggingClient(6668)).start(); } @@ -33,7 +39,7 @@ public class AppClient { socket = new Socket(InetAddress.getLocalHost(), serverPort); OutputStream outputStream = socket.getOutputStream(); PrintWriter writer = new PrintWriter(outputStream); - writeLogs(writer); + writeLogs(writer, socket.getInputStream()); } catch (IOException e) { e.printStackTrace(); throw new RuntimeException(e); @@ -48,8 +54,8 @@ public class AppClient { } } - private void writeLogs(PrintWriter writer) { - for (int i = 0; i < 10; i++) { + private void writeLogs(PrintWriter writer, InputStream inputStream) throws IOException { + for (int i = 0; i < 1; i++) { writer.println(clientName + " - Log request: " + i); try { Thread.sleep(100); @@ -57,6 +63,53 @@ public class AppClient { e.printStackTrace(); } writer.flush(); + byte[] data = new byte[1024]; + int read = inputStream.read(data, 0, data.length); + if (read == 0) { + System.out.println("Read zero bytes"); + } else { + System.out.println(new String(data, 0, read)); + } + } + } + } + + static class UDPLoggingClient implements Runnable { + private int port; + + public UDPLoggingClient(int port) { + this.port = port; + } + + @Override + public void run() { + DatagramSocket socket = null; + try { + socket = new DatagramSocket(); + for (int i = 0; i < 1; i++) { + String message = "UDP Client" + " - Log request: " + i; + try { + DatagramPacket packet = new DatagramPacket(message.getBytes(), message.getBytes().length, new InetSocketAddress(InetAddress.getLocalHost(), port)); + socket.send(packet); + + byte[] data = new byte[1024]; + DatagramPacket reply = new DatagramPacket(data, data.length); + socket.receive(reply); + if (reply.getLength() == 0) { + System.out.println("Read zero bytes"); + } else { + System.out.println(new String(reply.getData(), 0, reply.getLength())); + } + } catch (IOException e) { + e.printStackTrace(); + } + } + } catch (SocketException e1) { + e1.printStackTrace(); + } finally { + if (socket != null) { + socket.close(); + } } } } diff --git a/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java new file mode 100644 index 000000000..055e8edd6 --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java @@ -0,0 +1,9 @@ +package com.iluwatar.reactor; + +import java.nio.ByteBuffer; +import java.nio.channels.SelectionKey; + +public interface ChannelHandler { + + void handleChannelRead(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key); +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java new file mode 100644 index 000000000..1bc14c55f --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java @@ -0,0 +1,8 @@ +package com.iluwatar.reactor; + +import java.nio.ByteBuffer; +import java.nio.channels.SelectionKey; + +public interface Dispatcher { + void onChannelReadEvent(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key); +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java new file mode 100644 index 000000000..3744c3d5a --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java @@ -0,0 +1,24 @@ +package com.iluwatar.reactor; + +import java.nio.ByteBuffer; +import java.nio.channels.SelectionKey; + +public class LoggingHandler implements ChannelHandler { + + @Override + public void handleChannelRead(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key) { + byte[] data = readBytes.array(); + doLogging(data); + sendEchoReply(channel, data, key); + } + + private void sendEchoReply(AbstractNioChannel channel, byte[] data, SelectionKey key) { + ByteBuffer buffer = ByteBuffer.wrap("Data logged successfully".getBytes()); + channel.write(buffer, key); + } + + private void doLogging(byte[] data) { + // assuming UTF-8 :( + System.out.println(new String(data)); + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java new file mode 100644 index 000000000..2f655f192 --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java @@ -0,0 +1,47 @@ +package com.iluwatar.reactor; + +import java.io.IOException; +import java.net.InetAddress; +import java.net.InetSocketAddress; +import java.nio.ByteBuffer; +import java.nio.channels.DatagramChannel; +import java.nio.channels.SelectionKey; + +public class NioDatagramChannel extends AbstractNioChannel { + + private int port; + + public NioDatagramChannel(int port, ChannelHandler handler) throws IOException { + super(handler, DatagramChannel.open()); + this.port = port; + } + + @Override + public int getInterestedOps() { + return SelectionKey.OP_READ; + } + + @Override + public ByteBuffer read(SelectionKey key) throws IOException { + ByteBuffer buffer = ByteBuffer.allocate(1024); + getChannel().receive(buffer); + return buffer; + } + + @Override + public DatagramChannel getChannel() { + return (DatagramChannel) super.getChannel(); + } + + public void bind() throws IOException { + getChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port)); + getChannel().configureBlocking(false); + System.out.println("Bound UDP socket at port: " + port); + } + + @Override + protected void doWrite(ByteBuffer pendingWrite, SelectionKey key) throws IOException { + pendingWrite.flip(); + getChannel().write(pendingWrite); + } +} \ No newline at end of file diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java index 734ea086f..05aa609d1 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java +++ b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java @@ -1,46 +1,39 @@ package com.iluwatar.reactor; import java.io.IOException; -import java.nio.channels.SelectableChannel; +import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; import java.nio.channels.Selector; import java.nio.channels.ServerSocketChannel; import java.nio.channels.SocketChannel; -import java.util.List; +import java.util.Iterator; +import java.util.Queue; import java.util.Set; -import java.util.concurrent.CopyOnWriteArrayList; +import java.util.concurrent.ConcurrentLinkedQueue; /* * Abstractions * --------------- - * - * 1 - Dispatcher * 2 - Synchronous Event De-multiplexer - * 3 - Event - * 4 - Event Handler & concrete event handler (application business logic) - * 5 - Selector */ public class NioReactor { private Selector selector; - private Acceptor acceptor; - private List eventHandlers = new CopyOnWriteArrayList<>(); + private Dispatcher dispatcher; + private Queue pendingChanges = new ConcurrentLinkedQueue<>(); - public NioReactor() throws IOException { - this.acceptor = new Acceptor(); + public NioReactor(Dispatcher dispatcher) throws IOException { + this.dispatcher = dispatcher; this.selector = Selector.open(); } - public NioReactor registerChannel(SelectableChannel channel) throws IOException { - SelectionKey key = channel.register(selector, SelectionKey.OP_ACCEPT); - key.attach(acceptor); + public NioReactor registerChannel(AbstractNioChannel channel) throws IOException { + SelectionKey key = channel.getChannel().register(selector, channel.getInterestedOps()); + key.attach(channel); + channel.setReactor(this); return this; } - public void registerHandler(NioChannelEventHandler handler) { - eventHandlers.add(handler); - } - public void start() throws IOException { new Thread( new Runnable() { @Override @@ -52,66 +45,110 @@ public class NioReactor { e.printStackTrace(); } } - }).start(); + }, "Reactor Main").start(); } private void eventLoop() throws IOException { while (true) { - selector.select(1000); + // honor any pending requests first + processPendingChanges(); + + selector.select(); + Set keys = selector.selectedKeys(); - for (SelectionKey key : keys) { - dispatchEvent(key); + + Iterator iterator = keys.iterator(); + + while (iterator.hasNext()) { + SelectionKey key = iterator.next(); + if (!key.isValid()) { + iterator.remove(); + continue; + } + processKey(key); } keys.clear(); } } - private void dispatchEvent(SelectionKey key) throws IOException { - Object handler = key.attachment(); - if (handler != null) { - ((EventHandler)handler).handle(key.channel()); + private void processPendingChanges() { + Iterator iterator = pendingChanges.iterator(); + while (iterator.hasNext()) { + Command command = iterator.next(); + System.out.println("Processing pending change: " + command); + command.execute(); + iterator.remove(); } } - interface EventHandler { - void handle(SelectableChannel channel) throws IOException; - } - - private class Acceptor implements EventHandler { - - public void handle(SelectableChannel channel) throws IOException { - // non-blocking accept as acceptor will only be called when accept event is available - SocketChannel clientChannel = ((ServerSocketChannel)channel).accept(); - if (clientChannel != null) { - new ChannelHandler(clientChannel).handle(clientChannel); - } - System.out.println("Connection established with a client"); + private void processKey(SelectionKey key) throws IOException { + if (key.isAcceptable()) { + acceptConnection(key); + } else if (key.isReadable()) { + System.out.println("Key is readable"); + read(key); + } else if (key.isWritable()) { + System.out.println("Key is writable"); + write(key); } } - - public static interface NioChannelEventHandler { - void onReadable(SocketChannel channel); + + private void write(SelectionKey key) throws IOException { + AbstractNioChannel channel = (AbstractNioChannel) key.attachment(); + channel.write(key); } - - private class ChannelHandler implements EventHandler { - - private SocketChannel clientChannel; - private SelectionKey selectionKey; - public ChannelHandler(SocketChannel clientChannel) throws IOException { - this.clientChannel = clientChannel; - clientChannel.configureBlocking(false); - selectionKey = clientChannel.register(selector, 0); - selectionKey.attach(this); - selectionKey.interestOps(SelectionKey.OP_READ); - selector.wakeup(); - } - - public void handle(SelectableChannel channel) throws IOException { - // only read events are supported. - for (NioChannelEventHandler eventHandler : eventHandlers) { - eventHandler.onReadable(clientChannel); + private void read(SelectionKey key) { + ByteBuffer readBytes; + try { + readBytes = ((AbstractNioChannel)key.attachment()).read(key); + dispatchReadEvent(key, readBytes); + } catch (IOException e) { + try { + key.channel().close(); + } catch (IOException e1) { + e1.printStackTrace(); } } } -} + + private void dispatchReadEvent(SelectionKey key, ByteBuffer readBytes) { + dispatcher.onChannelReadEvent((AbstractNioChannel)key.attachment(), readBytes, key); + } + + private void acceptConnection(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()); + } + + interface Command { + void execute(); + } + + public void changeOps(SelectionKey key, int interestedOps) { + pendingChanges.add(new ChangeKeyOpsCommand(key, interestedOps)); + selector.wakeup(); + } + + class ChangeKeyOpsCommand implements Command { + private SelectionKey key; + private int interestedOps; + + public ChangeKeyOpsCommand(SelectionKey key, int interestedOps) { + this.key = key; + this.interestedOps = interestedOps; + } + + public void execute() { + key.interestOps(interestedOps); + } + + @Override + public String toString() { + return "Change of ops to: " + interestedOps; + } + } +} \ No newline at end of file diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java new file mode 100644 index 000000000..66affdb8d --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java @@ -0,0 +1,52 @@ +package com.iluwatar.reactor; + +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; + +public class NioServerSocketChannel extends AbstractNioChannel { + + private int port; + + public NioServerSocketChannel(int port, ChannelHandler handler) throws IOException { + super(handler, ServerSocketChannel.open()); + this.port = port; + } + + @Override + public int getInterestedOps() { + return SelectionKey.OP_ACCEPT; + } + + @Override + public ServerSocketChannel getChannel() { + return (ServerSocketChannel) super.getChannel(); + } + + @Override + public ByteBuffer read(SelectionKey key) throws IOException { + SocketChannel socketChannel = (SocketChannel) key.channel(); + ByteBuffer buffer = ByteBuffer.allocate(1024); + int read = socketChannel.read(buffer); + if (read == -1) { + throw new IOException("Socket closed"); + } + return buffer; + } + + public void bind() throws IOException { + ((ServerSocketChannel)getChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port)); + ((ServerSocketChannel)getChannel()).configureBlocking(false); + System.out.println("Bound TCP socket at port: " + port); + } + + @Override + protected void doWrite(ByteBuffer pendingWrite, SelectionKey key) throws IOException { + System.out.println("Writing on channel"); + ((SocketChannel)key.channel()).write(pendingWrite); + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java new file mode 100644 index 000000000..9b8029de4 --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java @@ -0,0 +1,14 @@ +package com.iluwatar.reactor; + +import java.nio.ByteBuffer; +import java.nio.channels.SelectionKey; + +public class SameThreadDispatcher implements Dispatcher { + + @Override + public void onChannelReadEvent(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key) { + if (channel.getHandler() != null) { + channel.getHandler().handleChannelRead(channel, readBytes, key); + } + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java new file mode 100644 index 000000000..2f44e4372 --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java @@ -0,0 +1,27 @@ +package com.iluwatar.reactor; + +import java.nio.ByteBuffer; +import java.nio.channels.SelectionKey; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; + +public class ThreadPoolDispatcher extends SameThreadDispatcher { + + private ExecutorService exectorService; + + public ThreadPoolDispatcher(int poolSize) { + this.exectorService = Executors.newFixedThreadPool(poolSize); + } + + @Override + public void onChannelReadEvent(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key) { + exectorService.execute(new Runnable() { + + @Override + public void run() { + ThreadPoolDispatcher.super.onChannelReadEvent(channel, readBytes, key); + } + }); + } + +} diff --git a/reactor/todo.txt b/reactor/todo.txt new file mode 100644 index 000000000..af06a1892 --- /dev/null +++ b/reactor/todo.txt @@ -0,0 +1,4 @@ +* Make UDP channel work (connect is required) +* Cleanup +* Document - Javadoc +* Better design?? Get review of @iluwatar From c745baac86f585b9a4c22cf1f888312d92cace6c Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 27 Aug 2015 19:55:12 +0300 Subject: [PATCH 170/687] #143 Nicer layout for the class diagram --- message-channel/.gitignore | 1 + message-channel/etc/message-channel.png | Bin 45921 -> 47216 bytes message-channel/etc/message-channel.ucls | 220 ++++++++++++----------- 3 files changed, 119 insertions(+), 102 deletions(-) diff --git a/message-channel/.gitignore b/message-channel/.gitignore index b83d22266..1dd333108 100644 --- a/message-channel/.gitignore +++ b/message-channel/.gitignore @@ -1 +1,2 @@ /target/ +/target/ diff --git a/message-channel/etc/message-channel.png b/message-channel/etc/message-channel.png index d29490724b688cc934076455d2d17a8f860bf799..7db473281affe66670f2a7e7488ad26de87107e2 100644 GIT binary patch literal 47216 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 literal 45921 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%0A9IqP>GyB~cl`80v>X=K?~Ox5&J|B9Um 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 diff --git a/message-channel/etc/message-channel.ucls b/message-channel/etc/message-channel.ucls index 27e99e539..3ef0ed4bc 100644 --- a/message-channel/etc/message-channel.ucls +++ b/message-channel/etc/message-channel.ucls @@ -4,7 +4,7 @@ - + @@ -14,7 +14,7 @@ - + @@ -24,7 +24,7 @@ - + @@ -34,7 +34,7 @@ - + @@ -44,7 +44,7 @@ - + @@ -54,7 +54,7 @@ - + @@ -64,7 +64,7 @@ - + @@ -74,7 +74,7 @@ - + @@ -84,7 +84,7 @@ - + @@ -94,7 +94,7 @@ - + @@ -104,7 +104,7 @@ - + @@ -114,7 +114,7 @@ - + @@ -124,7 +124,7 @@ - + @@ -134,7 +134,7 @@ - + @@ -144,7 +144,7 @@ - + @@ -154,7 +154,7 @@ - + @@ -164,137 +164,153 @@ - + - - + + + + + + + + + + + + + - - + + + + + + - - - - + + + + + + + + - + - + - - + + + + + + - - - - - - - - - - - - - - - - - + - - + + + + + + + + + + - - - - - - - - - - - - - - - - + + + - - - - - - - - - - + + + - - - - - + - - - - - - - - - - - - - + - - - - - - + + + - + - - + + + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From 2fc778a98cdd2896402c008ac9c130db999eb431 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 27 Aug 2015 20:59:47 +0300 Subject: [PATCH 171/687] #143 Fixed duplicate line in .gitignore --- message-channel/.gitignore | 1 - 1 file changed, 1 deletion(-) diff --git a/message-channel/.gitignore b/message-channel/.gitignore index 1dd333108..b83d22266 100644 --- a/message-channel/.gitignore +++ b/message-channel/.gitignore @@ -1,2 +1 @@ /target/ -/target/ From e5ef5dbfb6aabbecee521037ac9f00ecaed143cc Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Thu, 27 Aug 2015 21:14:48 +0300 Subject: [PATCH 172/687] #143 Fix intendation in pom.xml --- message-channel/pom.xml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/message-channel/pom.xml b/message-channel/pom.xml index ce29ac9fd..98add90ee 100644 --- a/message-channel/pom.xml +++ b/message-channel/pom.xml @@ -14,10 +14,10 @@ org.apache.camel camel-core - - org.apache.camel - camel-stream - + + org.apache.camel + camel-stream + junit junit From cd32e385e2465e8b9f36d82974b9b8ea756e952e Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Sun, 30 Aug 2015 15:22:37 +0300 Subject: [PATCH 173/687] Added second MVC example. This time the view is registered as observer to the model and gets update notifications that way. --- .../view/controller/with/observer/App.java | 29 +++++++++ .../controller/with/observer/Fatigue.java | 22 +++++++ .../with/observer/GiantController.java | 46 ++++++++++++++ .../controller/with/observer/GiantModel.java | 63 +++++++++++++++++++ .../with/observer/GiantModelObserver.java | 12 ++++ .../controller/with/observer/GiantView.java | 18 ++++++ .../view/controller/with/observer/Health.java | 22 +++++++ .../controller/with/observer/Nourishment.java | 22 +++++++ .../controller/with/observer/AppTest.java | 19 ++++++ 9 files changed, 253 insertions(+) create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java create mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java create mode 100644 model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java new file mode 100644 index 000000000..0b74f4b5a --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java @@ -0,0 +1,29 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * In this second example the model-view relationship is different. This time we use the Observer pattern to notify + * the {@link GiantView} each time the {@link GiantModel} is changed. This way the {@link GiantController} responsibilities + * are narrowed and it only needs to modify the {@link GiantModel} according to the user input. + * + */ +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 + // model modifications trigger the view rendering automatically + controller.setHealth(Health.WOUNDED); + controller.setNourishment(Nourishment.HUNGRY); + controller.setFatigue(Fatigue.TIRED); + } +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java new file mode 100644 index 000000000..301a579fb --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java @@ -0,0 +1,22 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * 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; + } +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java new file mode 100644 index 000000000..e892b2946 --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java @@ -0,0 +1,46 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * GiantController updates the giant model. + * + */ +public class GiantController { + + private GiantModel giant; + private GiantView view; + + public GiantController(GiantModel giant, GiantView view) { + this.giant = giant; + this.view = view; + this.giant.registerObserver(this.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); + } +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java new file mode 100644 index 000000000..84b32a50a --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java @@ -0,0 +1,63 @@ +package com.iluwatar.model.view.controller.with.observer; + +import java.util.ArrayList; +import java.util.List; + +/** + * + * GiantModel contains the giant data. + * + */ +public class GiantModel { + + private Health health; + private Fatigue fatigue; + private Nourishment nourishment; + private List observers = new ArrayList<>(); + + 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; + notifyObservers(); + } + + public Fatigue getFatigue() { + return fatigue; + } + + public void setFatigue(Fatigue fatigue) { + this.fatigue = fatigue; + notifyObservers(); + } + + public Nourishment getNourishment() { + return nourishment; + } + + public void setNourishment(Nourishment nourishment) { + this.nourishment = nourishment; + notifyObservers(); + } + + @Override + public String toString() { + return String.format("The giant looks %s, %s and %s.", health, fatigue, nourishment); + } + + public void registerObserver(GiantModelObserver observer) { + observers.add(observer); + } + + private void notifyObservers() { + observers.stream().forEach((GiantModelObserver o) -> o.modelChanged(this)); + } +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java new file mode 100644 index 000000000..6363ef4f7 --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java @@ -0,0 +1,12 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * GiantModelObserver is the interface for delivering update notifications. + * + */ +public interface GiantModelObserver { + + void modelChanged(GiantModel model); + +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java new file mode 100644 index 000000000..f4cebad80 --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java @@ -0,0 +1,18 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * GiantView displays the giant + * + */ +public class GiantView implements GiantModelObserver { + + public void displayGiant(GiantModel giant) { + System.out.println(giant); + } + + @Override + public void modelChanged(GiantModel model) { + displayGiant(model); + } +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java new file mode 100644 index 000000000..e4b8ed9a7 --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java @@ -0,0 +1,22 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * 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; + } +} diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java new file mode 100644 index 000000000..c1a8253c3 --- /dev/null +++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java @@ -0,0 +1,22 @@ +package com.iluwatar.model.view.controller.with.observer; + +/** + * + * 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; + } +} diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java new file mode 100644 index 000000000..9a43ce7bc --- /dev/null +++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java @@ -0,0 +1,19 @@ +package com.iluwatar.model.view.controller.with.observer; + +import org.junit.Test; + +import com.iluwatar.model.view.controller.with.observer.App; + +/** + * + * Application test + * + */ +public class AppTest { + + @Test + public void test() { + String[] args = {}; + App.main(args); + } +} From 8cc72b15a48a748282ed4939efae29a68e057c28 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Sun, 30 Aug 2015 15:53:33 +0300 Subject: [PATCH 174/687] #228 Moved developer information to project wiki --- README.md | 96 ------------------------------------------------------- 1 file changed, 96 deletions(-) diff --git a/README.md b/README.md index 4724ea332..919671290 100644 --- a/README.md +++ b/README.md @@ -12,15 +12,11 @@ -#### Browse and view all of the patterns on our Website: [iluwatar.github.io/java-design-patterns/](https://iluwatar.github.io/java-design-patterns/) - # Table of Contents - Introduction - Frequently Asked Questions - - How to contribute - - Versioning - Credits - License @@ -97,98 +93,6 @@ blocked waiting for available object from the pool. This is not the case with Flyweight. - -# How to contribute [↑](#top) - -**To work on a new pattern** you need to do the following steps: - -1. If there is no issue for the new pattern yet, raise new issue. Comment on - the issue that you are working on it so that others don't start work on the - same thing. -2. Fork the repository. -3. Create a new folder for the pattern. The rough structure of the new folder would be as follows: - * etc (every resource related to the pattern, like diagrams) - * src (the source code of the pattern) - * index.md (the description of the pattern) - * pom.xml (the maven pom.xml) -4. Implement the code changes in your fork. Remember to add sufficient comments - documenting the implementation. Reference the issue id e.g. #52 in your - commit messages. -5. Format the code according to [Google Java Style Guide](https://google.github.io/styleguide/javaguide.html) - * [Eclipse configuration](https://github.com/google/styleguide/blob/gh-pages/eclipse-java-google-style.xml) - * [IntelliJ configuration](https://github.com/google/styleguide/blob/gh-pages/intellij-java-google-style.xml) -6. Create a simple class diagram from your example code and put it inside of the etc folder. -7. Add description of the pattern in index.md and link to the class diagram. - (Attention, all internal links must be relative to the pattern subdirectory, else the links dont link properly on the website) -8. Create a pull request. - -**Structure of the index.md file** - -```markdown ---- # this is so called 'Yaml Front Matter', read up on it here: http://jekyllrb.com/docs/frontmatter/ -layout: pattern # layout must allways be pattern -title: Best Pattern Ever # the properly formatted title -folder: best-pattern-ever # the folder name in which this pattern lies -permalink: /patterns/best-pattern-ever/ # the permalink to the pattern, to keep this uniform please stick to /patterns/FOLDER/ - -# both categories and tags are Yaml Lists -# you can either just pick one or write a list with '-'s -# usable categories and tags are listed here: https://github.com/iluwatar/java-design-patterns/blob/gh-pages/_config.yml -categories: creational # categories of the pattern -tags: # tags of the pattern - - best - - ever - - awesome ---- - -**Intent:** Makes your code awesome - -![alt text](./etc/best_pattern.png "Best Pattern Ever") - -**Applicability:** Use the Best Pattern Ever pattern when - -* you want to be the best -* you need to ... - -**Real world examples:** - -* [Nowhere](http://no.where.com) -``` - -**To add a new category or tag** you need to edit the _config.yml file of the gh-pages branch. -In there you should find 2 yaml lists with the respective names 'category-list' and 'tag-list' - -**To work on one of the non-pattern issues** you need to do the following steps: - -1. Check that the issue has "help wanted" badge -2. Comment on the issue that you are working on it -3. Fork the repository. -4. Implement the code changes in your fork. Remember to add sufficient comments - documenting the implementation. Reference the issue id e.g. #52 in your - commit messages. -5. Create a pull request. - -**For creating/editing UML diagrams** you need [ObjectAid UML Explorer for Eclipse](http://www.objectaid.com/home). - -**For inspiration** check out the following sources: - -* there is a good list of design patterns at [Wikipedia](http://en.wikipedia.org/wiki/Software_design_pattern) -* Martin Fowler's [Catalog of Patterns of Enterprise Application Architecture](http://martinfowler.com/eaaCatalog/) -* [pattern language for microservices](http://microservices.io/patterns/index.html) -* Microsoft's [Cloud Design Patterns](http://download.microsoft.com/download/B/B/6/BB69622C-AB5D-4D5F-9A12-B81B952C1169/CloudDesignPatternsBook-PDF.pdf) - -**Links to patterns applied in real world applications** are welcome. The links -should be added to the corresponding section of the `index.md`. - - -# Versioning [↑](#top) - -Java-design-patterns project uses [semantic versioning](http://semver.org/) -scheme. However, version numbers in this project do not signify binary releases -(since we don't make any) but rather milestones achieved on the roadmap. In -other words, version numbers are used only for project planning sake. - - # Credits [↑](#top) * [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612) From cc0b93dc508ebfa6bfc3e41561c506f719d81029 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Sun, 30 Aug 2015 15:55:29 +0300 Subject: [PATCH 175/687] #228 Fixed "Introduction" header --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 919671290..b3bad5138 100644 --- a/README.md +++ b/README.md @@ -21,7 +21,7 @@ - License -## Introduction +# Introduction [↑](#top) Design patterns are formalized best practices that the programmer can use to solve common problems when designing an application or system. From 981c0bdcd80a78cc8d77fd4947deff33cddfc01e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Sun, 30 Aug 2015 16:00:06 +0300 Subject: [PATCH 176/687] #228 Added link to developer wiki --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index b3bad5138..1b79013bf 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,7 @@ # Table of Contents - Introduction + - How to contribute - Frequently Asked Questions - Credits - License @@ -34,6 +35,11 @@ problems, and it also improves code readability for coders and architects who are familiar with the patterns. +# How to contribute [↑](#top) + +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). + + # Frequently asked questions [↑](#top) **Q: What is the difference between State and Strategy patterns?** From 374d4617d599e7a6cb1fec9e674ac35f23f7e7d8 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 31 Aug 2015 23:03:00 +0300 Subject: [PATCH 177/687] Set project version to 1.6.0. --- abstract-factory/pom.xml | 2 +- adapter/pom.xml | 2 +- async-method-invocation/pom.xml | 2 +- bridge/pom.xml | 2 +- builder/pom.xml | 2 +- business-delegate/pom.xml | 2 +- callback/pom.xml | 2 +- chain/pom.xml | 2 +- command/pom.xml | 2 +- composite/pom.xml | 2 +- dao/pom.xml | 2 +- decorator/pom.xml | 2 +- dependency-injection/pom.xml | 2 +- double-checked-locking/pom.xml | 2 +- double-dispatch/pom.xml | 2 +- event-aggregator/pom.xml | 2 +- execute-around/pom.xml | 2 +- facade/pom.xml | 2 +- factory-method/pom.xml | 2 +- flux/pom.xml | 2 +- flyweight/pom.xml | 2 +- front-controller/pom.xml | 2 +- half-sync-half-async/pom.xml | 2 +- intercepting-filter/pom.xml | 2 +- interpreter/pom.xml | 2 +- iterator/pom.xml | 2 +- layers/pom.xml | 2 +- lazy-loading/pom.xml | 2 +- mediator/pom.xml | 2 +- memento/pom.xml | 2 +- model-view-controller/pom.xml | 2 +- model-view-presenter/pom.xml | 2 +- multiton/pom.xml | 2 +- naked-objects/dom/pom.xml | 2 +- naked-objects/fixture/pom.xml | 2 +- naked-objects/integtests/pom.xml | 2 +- naked-objects/pom.xml | 8 ++++---- naked-objects/webapp/pom.xml | 2 +- null-object/pom.xml | 2 +- object-pool/pom.xml | 2 +- observer/pom.xml | 2 +- poison-pill/pom.xml | 2 +- pom.xml | 2 +- private-class-data/pom.xml | 2 +- property/pom.xml | 2 +- prototype/pom.xml | 2 +- proxy/pom.xml | 2 +- repository/pom.xml | 2 +- resource-acquisition-is-initialization/pom.xml | 2 +- servant/pom.xml | 2 +- service-layer/pom.xml | 2 +- service-locator/pom.xml | 2 +- singleton/pom.xml | 2 +- specification/pom.xml | 2 +- state/pom.xml | 2 +- step-builder/pom.xml | 2 +- strategy/pom.xml | 2 +- template-method/pom.xml | 2 +- thread-pool/pom.xml | 2 +- tolerant-reader/pom.xml | 2 +- visitor/pom.xml | 2 +- 61 files changed, 64 insertions(+), 64 deletions(-) diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml index 798093c01..ddb7e7b9d 100644 --- a/abstract-factory/pom.xml +++ b/abstract-factory/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 abstract-factory diff --git a/adapter/pom.xml b/adapter/pom.xml index 8def28655..74a58de92 100644 --- a/adapter/pom.xml +++ b/adapter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 adapter diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml index 699258d93..2a5010b74 100644 --- a/async-method-invocation/pom.xml +++ b/async-method-invocation/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 async-method-invocation diff --git a/bridge/pom.xml b/bridge/pom.xml index 01bd26061..947fa2c60 100644 --- a/bridge/pom.xml +++ b/bridge/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 bridge diff --git a/builder/pom.xml b/builder/pom.xml index c5405d0c6..65997c9e6 100644 --- a/builder/pom.xml +++ b/builder/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 builder diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml index 2a7e77e3c..482d59fab 100644 --- a/business-delegate/pom.xml +++ b/business-delegate/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 business-delegate diff --git a/callback/pom.xml b/callback/pom.xml index d54b76172..f8cf6babf 100644 --- a/callback/pom.xml +++ b/callback/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 callback diff --git a/chain/pom.xml b/chain/pom.xml index f4a712260..ebae620d6 100644 --- a/chain/pom.xml +++ b/chain/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 chain diff --git a/command/pom.xml b/command/pom.xml index 10bc00f0c..401acba32 100644 --- a/command/pom.xml +++ b/command/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 command diff --git a/composite/pom.xml b/composite/pom.xml index 4c910e451..ca4daaaad 100644 --- a/composite/pom.xml +++ b/composite/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 composite diff --git a/dao/pom.xml b/dao/pom.xml index 6653741e4..a7a5c74ca 100644 --- a/dao/pom.xml +++ b/dao/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 dao diff --git a/decorator/pom.xml b/decorator/pom.xml index 1b93a171c..57946b711 100644 --- a/decorator/pom.xml +++ b/decorator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 decorator diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml index 70300b617..a6780cb20 100644 --- a/dependency-injection/pom.xml +++ b/dependency-injection/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 dependency-injection diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml index 21eb281c6..46d4a70f0 100644 --- a/double-checked-locking/pom.xml +++ b/double-checked-locking/pom.xml @@ -3,7 +3,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 double-checked-locking diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml index 0d7462486..5f16635f6 100644 --- a/double-dispatch/pom.xml +++ b/double-dispatch/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 double-dispatch diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml index 90f488729..1c9a3b626 100644 --- a/event-aggregator/pom.xml +++ b/event-aggregator/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 event-aggregator diff --git a/execute-around/pom.xml b/execute-around/pom.xml index d8d41f5d8..7d806337b 100644 --- a/execute-around/pom.xml +++ b/execute-around/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 execute-around diff --git a/facade/pom.xml b/facade/pom.xml index 53ac6fd67..17d3d707c 100644 --- a/facade/pom.xml +++ b/facade/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 facade diff --git a/factory-method/pom.xml b/factory-method/pom.xml index 1812b006d..81072a4f9 100644 --- a/factory-method/pom.xml +++ b/factory-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 factory-method diff --git a/flux/pom.xml b/flux/pom.xml index 367598fa2..3efccbfa4 100644 --- a/flux/pom.xml +++ b/flux/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 flux diff --git a/flyweight/pom.xml b/flyweight/pom.xml index 87903217c..54ca5bef2 100644 --- a/flyweight/pom.xml +++ b/flyweight/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 flyweight diff --git a/front-controller/pom.xml b/front-controller/pom.xml index d0fcc001f..a554186f3 100644 --- a/front-controller/pom.xml +++ b/front-controller/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 front-controller diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml index edbc2e420..94c12d797 100644 --- a/half-sync-half-async/pom.xml +++ b/half-sync-half-async/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 half-sync-half-async diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml index b4b5db5ae..35ebd9f59 100644 --- a/intercepting-filter/pom.xml +++ b/intercepting-filter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 intercepting-filter diff --git a/interpreter/pom.xml b/interpreter/pom.xml index f2778e0cd..8583464d3 100644 --- a/interpreter/pom.xml +++ b/interpreter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 interpreter diff --git a/iterator/pom.xml b/iterator/pom.xml index b77939c9d..da5040dce 100644 --- a/iterator/pom.xml +++ b/iterator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 iterator diff --git a/layers/pom.xml b/layers/pom.xml index dd036e74c..de672a3df 100644 --- a/layers/pom.xml +++ b/layers/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 com.iluwatar.layers layers diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml index cbbafae14..b795abf87 100644 --- a/lazy-loading/pom.xml +++ b/lazy-loading/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 lazy-loading diff --git a/mediator/pom.xml b/mediator/pom.xml index 2f3f83ff5..5a9c00042 100644 --- a/mediator/pom.xml +++ b/mediator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 mediator diff --git a/memento/pom.xml b/memento/pom.xml index ccc2bd1e2..182a46204 100644 --- a/memento/pom.xml +++ b/memento/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 memento diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml index 3a9167f5e..7162c71d9 100644 --- a/model-view-controller/pom.xml +++ b/model-view-controller/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 model-view-controller diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml index 5277e57ab..41a2d2013 100644 --- a/model-view-presenter/pom.xml +++ b/model-view-presenter/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 model-view-presenter model-view-presenter diff --git a/multiton/pom.xml b/multiton/pom.xml index 8f1220119..6ea1ad2fa 100644 --- a/multiton/pom.xml +++ b/multiton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 multiton diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml index 620efa9d7..cadf6d82e 100644 --- a/naked-objects/dom/pom.xml +++ b/naked-objects/dom/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.5.0 + 1.6.0 naked-objects-dom diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml index b0146e84e..33cd798f7 100644 --- a/naked-objects/fixture/pom.xml +++ b/naked-objects/fixture/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.5.0 + 1.6.0 naked-objects-fixture diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml index f479896cc..1fd518bb1 100644 --- a/naked-objects/integtests/pom.xml +++ b/naked-objects/integtests/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.5.0 + 1.6.0 naked-objects-integtests diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml index 8860815af..8cac48a09 100644 --- a/naked-objects/pom.xml +++ b/naked-objects/pom.xml @@ -15,7 +15,7 @@ java-design-patterns com.iluwatar - 1.5.0 + 1.6.0 naked-objects @@ -350,17 +350,17 @@ ${project.groupId} naked-objects-dom - 1.5.0 + 1.6.0 ${project.groupId} naked-objects-fixture - 1.5.0 + 1.6.0 ${project.groupId} naked-objects-webapp - 1.5.0 + 1.6.0 diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml index 9873589c7..3e018995a 100644 --- a/naked-objects/webapp/pom.xml +++ b/naked-objects/webapp/pom.xml @@ -16,7 +16,7 @@ com.iluwatar naked-objects - 1.5.0 + 1.6.0 naked-objects-webapp diff --git a/null-object/pom.xml b/null-object/pom.xml index dfa1c6891..eec32fd4d 100644 --- a/null-object/pom.xml +++ b/null-object/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 null-object diff --git a/object-pool/pom.xml b/object-pool/pom.xml index 3226bf71c..4a3b237c6 100644 --- a/object-pool/pom.xml +++ b/object-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 object-pool diff --git a/observer/pom.xml b/observer/pom.xml index 49a484edf..19e93421c 100644 --- a/observer/pom.xml +++ b/observer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 observer diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml index c3a5e46c1..2a0653981 100644 --- a/poison-pill/pom.xml +++ b/poison-pill/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 poison-pill diff --git a/pom.xml b/pom.xml index 5a154164e..961d9b281 100644 --- a/pom.xml +++ b/pom.xml @@ -4,7 +4,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 pom diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml index 6e6817621..70a716062 100644 --- a/private-class-data/pom.xml +++ b/private-class-data/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 private-class-data diff --git a/property/pom.xml b/property/pom.xml index 6b0511fe0..5435f06f5 100644 --- a/property/pom.xml +++ b/property/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 property diff --git a/prototype/pom.xml b/prototype/pom.xml index 39d8b7d33..0ebba706e 100644 --- a/prototype/pom.xml +++ b/prototype/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 prototype diff --git a/proxy/pom.xml b/proxy/pom.xml index 560c456b8..1f625d736 100644 --- a/proxy/pom.xml +++ b/proxy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 proxy diff --git a/repository/pom.xml b/repository/pom.xml index fe3ca4c0d..db0a8af5f 100644 --- a/repository/pom.xml +++ b/repository/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 repository diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml index fb965ca2d..c8382ceb8 100644 --- a/resource-acquisition-is-initialization/pom.xml +++ b/resource-acquisition-is-initialization/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 resource-acquisition-is-initialization diff --git a/servant/pom.xml b/servant/pom.xml index b59a470f2..b6497215f 100644 --- a/servant/pom.xml +++ b/servant/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 servant diff --git a/service-layer/pom.xml b/service-layer/pom.xml index 96e4e6dbf..8e0ea8322 100644 --- a/service-layer/pom.xml +++ b/service-layer/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 service-layer diff --git a/service-locator/pom.xml b/service-locator/pom.xml index 6b287242e..a596e4b0c 100644 --- a/service-locator/pom.xml +++ b/service-locator/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 service-locator diff --git a/singleton/pom.xml b/singleton/pom.xml index dfb5cff82..cdd9b613a 100644 --- a/singleton/pom.xml +++ b/singleton/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 singleton diff --git a/specification/pom.xml b/specification/pom.xml index 53e92fef1..b4d6efe90 100644 --- a/specification/pom.xml +++ b/specification/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 specification diff --git a/state/pom.xml b/state/pom.xml index e9178d0ae..0119146b3 100644 --- a/state/pom.xml +++ b/state/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 state diff --git a/step-builder/pom.xml b/step-builder/pom.xml index 8466266a7..f9c98474b 100644 --- a/step-builder/pom.xml +++ b/step-builder/pom.xml @@ -6,7 +6,7 @@ java-design-patterns com.iluwatar - 1.5.0 + 1.6.0 step-builder diff --git a/strategy/pom.xml b/strategy/pom.xml index c24ccf9af..9532a8079 100644 --- a/strategy/pom.xml +++ b/strategy/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 strategy diff --git a/template-method/pom.xml b/template-method/pom.xml index b0063c79e..53a7dc56e 100644 --- a/template-method/pom.xml +++ b/template-method/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 template-method diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml index 21f0bad3d..42e54de7e 100644 --- a/thread-pool/pom.xml +++ b/thread-pool/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 thread-pool diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml index fb28424d4..7e852d4ee 100644 --- a/tolerant-reader/pom.xml +++ b/tolerant-reader/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 tolerant-reader diff --git a/visitor/pom.xml b/visitor/pom.xml index a420b3269..8adda4855 100644 --- a/visitor/pom.xml +++ b/visitor/pom.xml @@ -5,7 +5,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 visitor From 60de01508a5e65532d930320262b7e1bf1c34b6f Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 31 Aug 2015 23:13:35 +0300 Subject: [PATCH 178/687] Corrected folder structure for Chain of responsibility. --- {chain-of-responsibility => chain}/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename {chain-of-responsibility => chain}/index.md (92%) diff --git a/chain-of-responsibility/index.md b/chain/index.md similarity index 92% rename from chain-of-responsibility/index.md rename to chain/index.md index cf56fe3c6..e1d2791ef 100644 --- a/chain-of-responsibility/index.md +++ b/chain/index.md @@ -1,8 +1,8 @@ --- layout: pattern title: Chain of responsibility -folder: chain-of-responsibility -permalink: /patterns/chain-of-responsibility/ +folder: chain +permalink: /patterns/chain/ categories: Behavioral tags: Java --- From 42eeb50badfbadebbb082289c62c364589fb69d0 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Mon, 31 Aug 2015 23:18:55 +0300 Subject: [PATCH 179/687] Fixed class diagram path. --- chain/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/chain/index.md b/chain/index.md index e1d2791ef..25e14bf06 100644 --- a/chain/index.md +++ b/chain/index.md @@ -11,7 +11,7 @@ tags: Java 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](./chain/etc/chain_1.png "Chain of Responsibility") +![alt text](./etc/chain_1.png "Chain of Responsibility") **Applicability:** Use Chain of Responsibility when From b94c1d37d2248513d98778a4f95ee8290e3806d8 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 2 Sep 2015 12:28:52 +0530 Subject: [PATCH 180/687] Work on #74, server mode works with both UDP and TCP channels --- .../iluwatar/reactor/AbstractNioChannel.java | 17 ++++--- .../java/com/iluwatar/reactor/AppClient.java | 4 +- .../com/iluwatar/reactor/ChannelHandler.java | 3 +- .../java/com/iluwatar/reactor/Dispatcher.java | 3 +- .../com/iluwatar/reactor/LoggingHandler.java | 25 ++++++++--- .../iluwatar/reactor/NioDatagramChannel.java | 45 ++++++++++++++++--- .../java/com/iluwatar/reactor/NioReactor.java | 14 +++--- .../reactor/NioServerSocketChannel.java | 5 ++- .../reactor/SameThreadDispatcher.java | 5 +-- .../reactor/ThreadPoolDispatcher.java | 5 +-- 10 files changed, 83 insertions(+), 43 deletions(-) diff --git a/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java index 9f6040ade..f55cea073 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java +++ b/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java @@ -1,7 +1,6 @@ package com.iluwatar.reactor; import java.io.IOException; -import java.nio.ByteBuffer; import java.nio.channels.SelectableChannel; import java.nio.channels.SelectionKey; import java.util.Map; @@ -13,7 +12,7 @@ public abstract class AbstractNioChannel { private SelectableChannel channel; private ChannelHandler handler; - private Map> channelToPendingWrites = new ConcurrentHashMap<>(); + private Map> channelToPendingWrites = new ConcurrentHashMap<>(); private NioReactor reactor; public AbstractNioChannel(ChannelHandler handler, SelectableChannel channel) { @@ -31,7 +30,7 @@ public abstract class AbstractNioChannel { public abstract int getInterestedOps(); - public abstract ByteBuffer read(SelectionKey key) throws IOException; + public abstract Object read(SelectionKey key) throws IOException; public void setHandler(ChannelHandler handler) { this.handler = handler; @@ -43,9 +42,9 @@ public abstract class AbstractNioChannel { // Called from the context of reactor thread public void write(SelectionKey key) throws IOException { - Queue pendingWrites = channelToPendingWrites.get(key.channel()); + Queue pendingWrites = channelToPendingWrites.get(key.channel()); while (true) { - ByteBuffer pendingWrite = pendingWrites.poll(); + Object pendingWrite = pendingWrites.poll(); if (pendingWrite == null) { System.out.println("No more pending writes"); reactor.changeOps(key, SelectionKey.OP_READ); @@ -56,10 +55,10 @@ public abstract class AbstractNioChannel { } } - protected abstract void doWrite(ByteBuffer pendingWrite, SelectionKey key) throws IOException; + protected abstract void doWrite(Object pendingWrite, SelectionKey key) throws IOException; - public void write(ByteBuffer buffer, SelectionKey key) { - Queue pendingWrites = this.channelToPendingWrites.get(key.channel()); + 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()); @@ -69,7 +68,7 @@ public abstract class AbstractNioChannel { } } } - pendingWrites.add(buffer); + pendingWrites.add(data); reactor.changeOps(key, SelectionKey.OP_WRITE); } } diff --git a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java index 3d7323a55..188b64ea8 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java +++ b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java @@ -14,8 +14,8 @@ import java.net.SocketException; public class AppClient { public static void main(String[] args) { -// new Thread(new LoggingClient("Client 1", 6666)).start(); -// new Thread(new LoggingClient("Client 2", 6667)).start(); + new Thread(new LoggingClient("Client 1", 6666)).start(); + new Thread(new LoggingClient("Client 2", 6667)).start(); new Thread(new UDPLoggingClient(6668)).start(); } diff --git a/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java index 055e8edd6..e84c506f9 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java +++ b/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java @@ -1,9 +1,8 @@ package com.iluwatar.reactor; -import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; public interface ChannelHandler { - void handleChannelRead(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key); + void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key); } diff --git a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java index 1bc14c55f..15fe7774c 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java +++ b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java @@ -1,8 +1,7 @@ package com.iluwatar.reactor; -import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; public interface Dispatcher { - void onChannelReadEvent(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key); + void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key); } diff --git a/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java index 3744c3d5a..fc7efaeed 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java +++ b/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java @@ -3,16 +3,31 @@ package com.iluwatar.reactor; import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; +import com.iluwatar.reactor.NioDatagramChannel.DatagramPacket; + public class LoggingHandler implements ChannelHandler { @Override - public void handleChannelRead(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key) { - byte[] data = readBytes.array(); - doLogging(data); - sendEchoReply(channel, data, key); + public void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key) { + if (readObject instanceof ByteBuffer) { + byte[] data = ((ByteBuffer)readObject).array(); + doLogging(data); + sendReply(channel, data, key); + } else if (readObject instanceof DatagramPacket) { + DatagramPacket datagram = (DatagramPacket)readObject; + byte[] data = datagram.getData().array(); + doLogging(data); + sendReply(channel, datagram, key); + } } - private void sendEchoReply(AbstractNioChannel channel, byte[] data, SelectionKey key) { + private void sendReply(AbstractNioChannel channel, DatagramPacket datagram, SelectionKey key) { + DatagramPacket replyPacket = new DatagramPacket(ByteBuffer.wrap("Data logged successfully".getBytes())); + replyPacket.setReceiver(datagram.getSender()); + channel.write(replyPacket, key); + } + + private void sendReply(AbstractNioChannel channel, byte[] data, SelectionKey key) { ByteBuffer buffer = ByteBuffer.wrap("Data logged successfully".getBytes()); channel.write(buffer, key); } diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java index 2f655f192..4d1690792 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java +++ b/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java @@ -3,6 +3,7 @@ package com.iluwatar.reactor; 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; @@ -22,10 +23,12 @@ public class NioDatagramChannel extends AbstractNioChannel { } @Override - public ByteBuffer read(SelectionKey key) throws IOException { + public Object read(SelectionKey key) throws IOException { ByteBuffer buffer = ByteBuffer.allocate(1024); - getChannel().receive(buffer); - return buffer; + SocketAddress sender = getChannel().receive(buffer); + DatagramPacket packet = new DatagramPacket(buffer); + packet.setSender(sender); + return packet; } @Override @@ -40,8 +43,38 @@ public class NioDatagramChannel extends AbstractNioChannel { } @Override - protected void doWrite(ByteBuffer pendingWrite, SelectionKey key) throws IOException { - pendingWrite.flip(); - getChannel().write(pendingWrite); + protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException { + DatagramPacket pendingPacket = (DatagramPacket) pendingWrite; + getChannel().send(pendingPacket.getData(), pendingPacket.getReceiver()); + } + + static class DatagramPacket { + private SocketAddress sender; + private ByteBuffer data; + private SocketAddress receiver; + + public DatagramPacket(ByteBuffer data) { + this.data = data; + } + + public SocketAddress getSender() { + return sender; + } + + public void setSender(SocketAddress sender) { + this.sender = sender; + } + + public SocketAddress getReceiver() { + return receiver; + } + + public void setReceiver(SocketAddress receiver) { + this.receiver = receiver; + } + + public ByteBuffer getData() { + return data; + } } } \ No newline at end of file diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java index 05aa609d1..f10ea4b82 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java +++ b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java @@ -1,7 +1,6 @@ package com.iluwatar.reactor; import java.io.IOException; -import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; import java.nio.channels.Selector; import java.nio.channels.ServerSocketChannel; @@ -75,7 +74,6 @@ public class NioReactor { Iterator iterator = pendingChanges.iterator(); while (iterator.hasNext()) { Command command = iterator.next(); - System.out.println("Processing pending change: " + command); command.execute(); iterator.remove(); } @@ -85,10 +83,8 @@ public class NioReactor { if (key.isAcceptable()) { acceptConnection(key); } else if (key.isReadable()) { - System.out.println("Key is readable"); read(key); } else if (key.isWritable()) { - System.out.println("Key is writable"); write(key); } } @@ -99,10 +95,10 @@ public class NioReactor { } private void read(SelectionKey key) { - ByteBuffer readBytes; + Object readObject; try { - readBytes = ((AbstractNioChannel)key.attachment()).read(key); - dispatchReadEvent(key, readBytes); + readObject = ((AbstractNioChannel)key.attachment()).read(key); + dispatchReadEvent(key, readObject); } catch (IOException e) { try { key.channel().close(); @@ -112,8 +108,8 @@ public class NioReactor { } } - private void dispatchReadEvent(SelectionKey key, ByteBuffer readBytes) { - dispatcher.onChannelReadEvent((AbstractNioChannel)key.attachment(), readBytes, key); + private void dispatchReadEvent(SelectionKey key, Object readObject) { + dispatcher.onChannelReadEvent((AbstractNioChannel)key.attachment(), readObject, key); } private void acceptConnection(SelectionKey key) throws IOException { diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java index 66affdb8d..ebd8f0ef3 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java +++ b/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java @@ -45,8 +45,9 @@ public class NioServerSocketChannel extends AbstractNioChannel { } @Override - protected void doWrite(ByteBuffer pendingWrite, SelectionKey key) throws IOException { + protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException { + ByteBuffer pendingBuffer = (ByteBuffer) pendingWrite; System.out.println("Writing on channel"); - ((SocketChannel)key.channel()).write(pendingWrite); + ((SocketChannel)key.channel()).write(pendingBuffer); } } diff --git a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java index 9b8029de4..024441b7c 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java +++ b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java @@ -1,14 +1,13 @@ package com.iluwatar.reactor; -import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; public class SameThreadDispatcher implements Dispatcher { @Override - public void onChannelReadEvent(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key) { + public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { if (channel.getHandler() != null) { - channel.getHandler().handleChannelRead(channel, readBytes, key); + channel.getHandler().handleChannelRead(channel, readObject, key); } } } diff --git a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java index 2f44e4372..e9e4ac34c 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java +++ b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java @@ -1,6 +1,5 @@ package com.iluwatar.reactor; -import java.nio.ByteBuffer; import java.nio.channels.SelectionKey; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; @@ -14,12 +13,12 @@ public class ThreadPoolDispatcher extends SameThreadDispatcher { } @Override - public void onChannelReadEvent(AbstractNioChannel channel, ByteBuffer readBytes, SelectionKey key) { + public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { exectorService.execute(new Runnable() { @Override public void run() { - ThreadPoolDispatcher.super.onChannelReadEvent(channel, readBytes, key); + ThreadPoolDispatcher.super.onChannelReadEvent(channel, readObject, key); } }); } From 940a62bc01833ec11bba664af5914687e5a9e59e Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 2 Sep 2015 15:08:34 +0530 Subject: [PATCH 181/687] Work on #74, added unit test cases --- .../main/java/com/iluwatar/reactor/App.java | 27 +++++++++++----- .../java/com/iluwatar/reactor/AppClient.java | 31 +++++++++++++++---- .../java/com/iluwatar/reactor/Dispatcher.java | 1 + .../java/com/iluwatar/reactor/NioReactor.java | 24 ++++++++++++-- .../reactor/SameThreadDispatcher.java | 5 +++ .../reactor/ThreadPoolDispatcher.java | 17 ++++++++-- .../java/com/iluwatar/reactor/AppTest.java | 27 ++++++++++++++++ 7 files changed, 114 insertions(+), 18 deletions(-) create mode 100644 reactor/src/test/java/com/iluwatar/reactor/AppTest.java diff --git a/reactor/src/main/java/com/iluwatar/reactor/App.java b/reactor/src/main/java/com/iluwatar/reactor/App.java index 36aa5290d..7ce27a78b 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/App.java +++ b/reactor/src/main/java/com/iluwatar/reactor/App.java @@ -4,19 +4,32 @@ import java.io.IOException; public class App { + private NioReactor reactor; + public static void main(String[] args) { try { - NioReactor reactor = new NioReactor(new ThreadPoolDispatcher(2)); - LoggingHandler loggingHandler = new LoggingHandler(); - reactor - .registerChannel(tcpChannel(6666, loggingHandler)) - .registerChannel(tcpChannel(6667, loggingHandler)) - .registerChannel(udpChannel(6668, loggingHandler)) - .start(); + new App().start(); } catch (IOException e) { e.printStackTrace(); } } + + public void start() throws IOException { + reactor = new NioReactor(new ThreadPoolDispatcher(2)); + + LoggingHandler loggingHandler = new LoggingHandler(); + + reactor + .registerChannel(tcpChannel(6666, loggingHandler)) + .registerChannel(tcpChannel(6667, loggingHandler)) + .registerChannel(udpChannel(6668, loggingHandler)) + .start(); + } + + public void stop() { + reactor.stop(); + } + private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException { NioServerSocketChannel channel = new NioServerSocketChannel(port, handler); diff --git a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java index 188b64ea8..2ffb6c0de 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java +++ b/reactor/src/main/java/com/iluwatar/reactor/AppClient.java @@ -10,15 +10,34 @@ import java.net.InetAddress; import java.net.InetSocketAddress; import java.net.Socket; import java.net.SocketException; +import java.util.concurrent.ExecutorService; +import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; public class AppClient { - + private ExecutorService service = Executors.newFixedThreadPool(3); + public static void main(String[] args) { - new Thread(new LoggingClient("Client 1", 6666)).start(); - new Thread(new LoggingClient("Client 2", 6667)).start(); - new Thread(new UDPLoggingClient(6668)).start(); + new AppClient().start(); } + public void start() { + service.execute(new LoggingClient("Client 1", 6666)); + service.execute(new LoggingClient("Client 2", 6667)); + service.execute(new UDPLoggingClient(6668)); + } + + public void stop() { + service.shutdown(); + if (!service.isTerminated()) { + service.shutdownNow(); + try { + service.awaitTermination(1000, TimeUnit.SECONDS); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } + } /* * A logging client that sends logging requests to logging server @@ -55,7 +74,7 @@ public class AppClient { } private void writeLogs(PrintWriter writer, InputStream inputStream) throws IOException { - for (int i = 0; i < 1; i++) { + for (int i = 0; i < 4; i++) { writer.println(clientName + " - Log request: " + i); try { Thread.sleep(100); @@ -86,7 +105,7 @@ public class AppClient { DatagramSocket socket = null; try { socket = new DatagramSocket(); - for (int i = 0; i < 1; i++) { + for (int i = 0; i < 4; i++) { String message = "UDP Client" + " - Log request: " + i; try { DatagramPacket packet = new DatagramPacket(message.getBytes(), message.getBytes().length, new InetSocketAddress(InetAddress.getLocalHost(), port)); diff --git a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java index 15fe7774c..7c05a6c1d 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java +++ b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java @@ -4,4 +4,5 @@ import java.nio.channels.SelectionKey; public interface Dispatcher { void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key); + void stop(); } diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java index f10ea4b82..6ee0cb989 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java +++ b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java @@ -9,6 +9,9 @@ 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; /* * Abstractions @@ -20,6 +23,7 @@ public class NioReactor { private Selector selector; private Dispatcher dispatcher; private Queue pendingChanges = new ConcurrentLinkedQueue<>(); + private ExecutorService reactorService = Executors.newSingleThreadExecutor(); public NioReactor(Dispatcher dispatcher) throws IOException { this.dispatcher = dispatcher; @@ -34,7 +38,7 @@ public class NioReactor { } public void start() throws IOException { - new Thread( new Runnable() { + reactorService.execute(new Runnable() { @Override public void run() { try { @@ -44,11 +48,27 @@ public class NioReactor { e.printStackTrace(); } } - }, "Reactor Main").start(); + }); + } + + public void stop() { + reactorService.shutdownNow(); + selector.wakeup(); + try { + reactorService.awaitTermination(4, TimeUnit.SECONDS); + } catch (InterruptedException e) { + e.printStackTrace(); + } + dispatcher.stop(); } private void eventLoop() throws IOException { while (true) { + + if (Thread.interrupted()) { + break; + } + // honor any pending requests first processPendingChanges(); diff --git a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java index 024441b7c..c27050a15 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java +++ b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java @@ -10,4 +10,9 @@ public class SameThreadDispatcher implements Dispatcher { channel.getHandler().handleChannelRead(channel, readObject, key); } } + + @Override + public void stop() { + // no-op + } } diff --git a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java index e9e4ac34c..600cb4da4 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java +++ b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java @@ -3,18 +3,19 @@ package com.iluwatar.reactor; import java.nio.channels.SelectionKey; import java.util.concurrent.ExecutorService; import java.util.concurrent.Executors; +import java.util.concurrent.TimeUnit; public class ThreadPoolDispatcher extends SameThreadDispatcher { - private ExecutorService exectorService; + private ExecutorService executorService; public ThreadPoolDispatcher(int poolSize) { - this.exectorService = Executors.newFixedThreadPool(poolSize); + this.executorService = Executors.newFixedThreadPool(poolSize); } @Override public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { - exectorService.execute(new Runnable() { + executorService.execute(new Runnable() { @Override public void run() { @@ -22,5 +23,15 @@ public class ThreadPoolDispatcher extends SameThreadDispatcher { } }); } + + @Override + public void stop() { + executorService.shutdownNow(); + try { + executorService.awaitTermination(1000, TimeUnit.SECONDS); + } catch (InterruptedException e) { + e.printStackTrace(); + } + } } diff --git a/reactor/src/test/java/com/iluwatar/reactor/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/AppTest.java new file mode 100644 index 000000000..17ce0b912 --- /dev/null +++ b/reactor/src/test/java/com/iluwatar/reactor/AppTest.java @@ -0,0 +1,27 @@ +package com.iluwatar.reactor; + +import java.io.IOException; + +import org.junit.Test; + +public class AppTest { + + @Test + public void testApp() throws IOException { + App app = new App(); + app.start(); + + AppClient client = new AppClient(); + client.start(); + + try { + Thread.sleep(2000); + } catch (InterruptedException e) { + e.printStackTrace(); + } + + client.stop(); + + app.stop(); + } +} From 4135179040ba9c06b347802d51d75952284dfae7 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 2 Sep 2015 15:17:06 +0530 Subject: [PATCH 182/687] Updated build badge to redirect to Travis on click This allows for quick review of last build. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1b79013bf..1e0a77c04 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ [![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) -![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master) [![Coverage Status](https://coveralls.io/repos/iluwatar/java-design-patterns/badge.svg?branch=master)](https://coveralls.io/r/iluwatar/java-design-patterns?branch=master) +[![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master)](https://travis-ci.org/iluwatar/java-design-patterns) [![Coverage Status](https://coveralls.io/repos/iluwatar/java-design-patterns/badge.svg?branch=master)](https://coveralls.io/r/iluwatar/java-design-patterns?branch=master) Coverity Scan Build Status From e5ea9f5c0d1ee162a3733bf086421a51b396b5f0 Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Wed, 2 Sep 2015 15:21:09 +0530 Subject: [PATCH 183/687] Work on #74, added reactor to parent pom --- pom.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/pom.xml b/pom.xml index 5a154164e..ce298d61b 100644 --- a/pom.xml +++ b/pom.xml @@ -75,6 +75,7 @@ half-sync-half-async step-builder layers + reactor @@ -196,4 +197,4 @@ - \ No newline at end of file + From b99d2b76de87ca82e3cacdfb487df047f27b69d2 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 2 Sep 2015 21:23:08 +0300 Subject: [PATCH 184/687] #143 Improved example documentation --- .../src/main/java/com/iluwatar/message/channel/App.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java index ef4f92d3e..bf86fe3f9 100644 --- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -8,7 +8,7 @@ import org.apache.camel.impl.DefaultCamelContext; * * 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 Channels are logical addresses in the messaging system. + * 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 From f74c8c27d1afdcacfac71318f9efd8337a129bca Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 2 Sep 2015 21:42:32 +0300 Subject: [PATCH 185/687] #143 Added second message channel. --- .../src/main/java/com/iluwatar/message/channel/App.java | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java index bf86fe3f9..f9a334a8a 100644 --- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java +++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java @@ -21,9 +21,10 @@ import org.apache.camel.impl.DefaultCamelContext; * 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 a direct synchronous Message Channel - * that delivers messages to console output. No actual messages are sent, only the established - * routes are printed to standard output. + * 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 { @@ -40,6 +41,7 @@ public class App { @Override public void configure() throws Exception { + from("stream:in").to("direct:greetings"); from("direct:greetings").to("stream:out"); } }); From 4fc4409d7def94b6526ddfe51395f7c97e696634 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 2 Sep 2015 21:51:14 +0300 Subject: [PATCH 186/687] #143 Added real world example --- message-channel/index.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/message-channel/index.md b/message-channel/index.md index 80a068de5..b5fb1761a 100644 --- a/message-channel/index.md +++ b/message-channel/index.md @@ -15,3 +15,7 @@ of the system, so called Message Channels. **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) From b5d03b6727ff351f6c142e571eafb91c1e7d4de3 Mon Sep 17 00:00:00 2001 From: Ilkka Seppala Date: Wed, 2 Sep 2015 22:13:17 +0300 Subject: [PATCH 187/687] #143 Fixed version number --- message-channel/pom.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/message-channel/pom.xml b/message-channel/pom.xml index 98add90ee..ef66f2401 100644 --- a/message-channel/pom.xml +++ b/message-channel/pom.xml @@ -6,7 +6,7 @@ com.iluwatar java-design-patterns - 1.5.0 + 1.6.0 message-channel From 782c0b8320506dc5e65086356940fe64464dc3ea Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Thu, 3 Sep 2015 18:17:07 +0530 Subject: [PATCH 188/687] Work on #226, moved pattern specific credits to respective pattern pages in website --- README.md | 10 ---------- event-aggregator/index.md | 4 ++++ flux/index.md | 4 ++++ half-sync-half-async/index.md | 4 ++++ intercepting-filter/index.md | 4 ++++ model-view-controller/index.md | 4 ++++ naked-objects/index.md | 4 ++++ service-layer/index.md | 4 ++++ specification/index.md | 4 ++++ step-builder/index.md | 4 ++++ tolerant-reader/index.md | 4 ++++ 11 files changed, 40 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 1e0a77c04..4715c3b9b 100644 --- a/README.md +++ b/README.md @@ -106,21 +106,11 @@ Flyweight. * [Java Generics and Collections](http://www.amazon.com/Java-Generics-Collections-Maurice-Naftalin/dp/0596527756/) * [Let's Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf) * [Pattern Languages of Program Design](http://www.amazon.com/Pattern-Languages-Program-Design-Coplien/dp/0201607344/ref=sr_1_1) -* [Martin Fowler - Event Aggregator](http://martinfowler.com/eaaDev/EventAggregator.html) -* [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) * [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) -* [Martin Fowler - Service Layer](http://martinfowler.com/eaaCatalog/serviceLayer.html) -* [Martin Fowler - Specifications](http://martinfowler.com/apsupp/spec.pdf) -* [Martin Fowler - Tolerant Reader](http://martinfowler.com/bliki/TolerantReader.html) -* [Trygve Reenskaug - Model-view-controller](http://en.wikipedia.org/wiki/Model%E2%80%93view%E2%80%93controller) -* [Flux - Application architecture for building user interfaces](http://facebook.github.io/flux/) -* [Richard Pawson - Naked Objects](http://downloads.nakedobjects.net/resources/Pawson%20thesis.pdf) * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420) * [Spring Data](http://www.amazon.com/Spring-Data-Mark-Pollack/dp/1449323952/ref=sr_1_1) * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2) -* [Marco Castigliego - Step Builder](http://rdafbn.blogspot.co.uk/2012/07/step-builder-pattern_28.html) -* [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) diff --git a/event-aggregator/index.md b/event-aggregator/index.md index fd42e9811..1c89c7188 100644 --- a/event-aggregator/index.md +++ b/event-aggregator/index.md @@ -23,3 +23,7 @@ allowing clients to register with just the aggregator. 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) diff --git a/flux/index.md b/flux/index.md index c96b2b56a..227237168 100644 --- a/flux/index.md +++ b/flux/index.md @@ -17,3 +17,7 @@ logic, which updates all of the views that are affected. **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/) diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md index afeb20037..0ea0254b8 100644 --- a/half-sync-half-async/index.md +++ b/half-sync-half-async/index.md @@ -26,3 +26,7 @@ degrading execution efficiency. * [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) diff --git a/intercepting-filter/index.md b/intercepting-filter/index.md index 66cf04b62..9625e445d 100644 --- a/intercepting-filter/index.md +++ b/intercepting-filter/index.md @@ -17,3 +17,7 @@ post-processing to requests from a client to a target * 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 + +**Credits:** + +* [TutorialsPoint - Intercepting Filter](http://www.tutorialspoint.com/design_pattern/intercepting_filter_pattern.htm) diff --git a/model-view-controller/index.md b/model-view-controller/index.md index 5a12bc656..f96daf243 100644 --- a/model-view-controller/index.md +++ b/model-view-controller/index.md @@ -17,3 +17,7 @@ display. **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) diff --git a/naked-objects/index.md b/naked-objects/index.md index cef2a9ede..805cea810 100644 --- a/naked-objects/index.md +++ b/naked-objects/index.md @@ -22,3 +22,7 @@ everything else is autogenerated by the framework. **Real world examples:** * [Apache Isis](https://isis.apache.org/) + +**Credits:** + +* [Richard Pawson - Naked Objects](http://downloads.nakedobjects.net/resources/Pawson%20thesis.pdf) diff --git a/service-layer/index.md b/service-layer/index.md index 22afc1669..f9e7ac1cb 100644 --- a/service-layer/index.md +++ b/service-layer/index.md @@ -20,3 +20,7 @@ its business logic. The Service Layer fulfills this role. * 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) diff --git a/specification/index.md b/specification/index.md index 2609f50e5..6b76d5102 100644 --- a/specification/index.md +++ b/specification/index.md @@ -18,3 +18,7 @@ order * 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) + +**Credits:** + +* [Martin Fowler - Specifications](http://martinfowler.com/apsupp/spec.pdf) diff --git a/step-builder/index.md b/step-builder/index.md index 636504598..766479358 100644 --- a/step-builder/index.md +++ b/step-builder/index.md @@ -13,3 +13,7 @@ The user experience will be much more improved by the fact that he will only see ![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) diff --git a/tolerant-reader/index.md b/tolerant-reader/index.md index 7e0ef4f32..b2bfd376a 100644 --- a/tolerant-reader/index.md +++ b/tolerant-reader/index.md @@ -17,3 +17,7 @@ changes, the readers must not break. **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) From 2c9288b83ad40a50d35b36728ae1016c5f17f4cb Mon Sep 17 00:00:00 2001 From: Simon Legner Date: Thu, 3 Sep 2015 16:22:26 +0200 Subject: [PATCH 189/687] Jekyll does not like enumerations w/o blank lines --- flyweight/index.md | 1 + interpreter/index.md | 1 + model-view-presenter/index.md | 1 + 3 files changed, 3 insertions(+) diff --git a/flyweight/index.md b/flyweight/index.md index 699c1ed54..85fa54ad1 100644 --- a/flyweight/index.md +++ b/flyweight/index.md @@ -15,6 +15,7 @@ efficiently. **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 diff --git a/interpreter/index.md b/interpreter/index.md index 40030917a..c7c4539d5 100644 --- a/interpreter/index.md +++ b/interpreter/index.md @@ -16,5 +16,6 @@ language. **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 diff --git a/model-view-presenter/index.md b/model-view-presenter/index.md index 6b0994077..609c59c13 100644 --- a/model-view-presenter/index.md +++ b/model-view-presenter/index.md @@ -14,5 +14,6 @@ developers to build and test user interfaces. **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. From 7ac262b880f9ab5b52dd000a5728c965109b9d8c Mon Sep 17 00:00:00 2001 From: Narendra Pathai Date: Fri, 4 Sep 2015 17:43:01 +0530 Subject: [PATCH 190/687] Work on #74, repackaged and added javadocs --- .../iluwatar/reactor/AbstractNioChannel.java | 74 ------ .../main/java/com/iluwatar/reactor/App.java | 45 ---- .../com/iluwatar/reactor/ChannelHandler.java | 8 - .../java/com/iluwatar/reactor/Dispatcher.java | 8 - .../com/iluwatar/reactor/LoggingHandler.java | 39 --- .../iluwatar/reactor/NioDatagramChannel.java | 80 ------ .../java/com/iluwatar/reactor/NioReactor.java | 170 ------------ .../reactor/SameThreadDispatcher.java | 18 -- .../reactor/ThreadPoolDispatcher.java | 37 --- .../java/com/iluwatar/reactor/app/App.java | 106 ++++++++ .../iluwatar/reactor/{ => app}/AppClient.java | 2 +- .../iluwatar/reactor/app/LoggingHandler.java | 62 +++++ .../reactor/framework/AbstractNioChannel.java | 150 +++++++++++ .../reactor/framework/ChannelHandler.java | 25 ++ .../reactor/framework/Dispatcher.java | 38 +++ .../reactor/framework/NioDatagramChannel.java | 156 +++++++++++ .../reactor/framework/NioReactor.java | 242 ++++++++++++++++++ .../NioServerSocketChannel.java | 38 ++- .../framework/SameThreadDispatcher.java | 43 ++++ .../framework/ThreadPoolDispatcher.java | 55 ++++ .../iluwatar/reactor/{ => app}/AppTest.java | 2 +- reactor/todo.txt | 9 + 22 files changed, 925 insertions(+), 482 deletions(-) delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/App.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/NioReactor.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java delete mode 100644 reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/app/App.java rename reactor/src/main/java/com/iluwatar/reactor/{ => app}/AppClient.java (99%) create mode 100644 reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java rename reactor/src/main/java/com/iluwatar/reactor/{ => framework}/NioServerSocketChannel.java (52%) create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java create mode 100644 reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java rename reactor/src/test/java/com/iluwatar/reactor/{ => app}/AppTest.java (91%) diff --git a/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java deleted file mode 100644 index f55cea073..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/AbstractNioChannel.java +++ /dev/null @@ -1,74 +0,0 @@ -package com.iluwatar.reactor; - -import java.io.IOException; -import java.nio.channels.SelectableChannel; -import java.nio.channels.SelectionKey; -import java.util.Map; -import java.util.Queue; -import java.util.concurrent.ConcurrentHashMap; -import java.util.concurrent.ConcurrentLinkedQueue; - -public abstract class AbstractNioChannel { - - private SelectableChannel channel; - private ChannelHandler handler; - private Map> channelToPendingWrites = new ConcurrentHashMap<>(); - private NioReactor reactor; - - public AbstractNioChannel(ChannelHandler handler, SelectableChannel channel) { - this.handler = handler; - this.channel = channel; - } - - public void setReactor(NioReactor reactor) { - this.reactor = reactor; - } - - public SelectableChannel getChannel() { - return channel; - } - - public abstract int getInterestedOps(); - - public abstract Object read(SelectionKey key) throws IOException; - - public void setHandler(ChannelHandler handler) { - this.handler = handler; - } - - public ChannelHandler getHandler() { - return handler; - } - - // Called from the context of reactor thread - public void write(SelectionKey key) throws IOException { - Queue pendingWrites = channelToPendingWrites.get(key.channel()); - while (true) { - Object pendingWrite = pendingWrites.poll(); - if (pendingWrite == null) { - System.out.println("No more pending writes"); - reactor.changeOps(key, SelectionKey.OP_READ); - break; - } - - doWrite(pendingWrite, key); - } - } - - protected abstract void doWrite(Object pendingWrite, SelectionKey key) throws IOException; - - 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); - } -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/App.java b/reactor/src/main/java/com/iluwatar/reactor/App.java deleted file mode 100644 index 7ce27a78b..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/App.java +++ /dev/null @@ -1,45 +0,0 @@ -package com.iluwatar.reactor; - -import java.io.IOException; - -public class App { - - private NioReactor reactor; - - public static void main(String[] args) { - try { - new App().start(); - } catch (IOException e) { - e.printStackTrace(); - } - } - - public void start() throws IOException { - reactor = new NioReactor(new ThreadPoolDispatcher(2)); - - LoggingHandler loggingHandler = new LoggingHandler(); - - reactor - .registerChannel(tcpChannel(6666, loggingHandler)) - .registerChannel(tcpChannel(6667, loggingHandler)) - .registerChannel(udpChannel(6668, loggingHandler)) - .start(); - } - - public void stop() { - reactor.stop(); - } - - - private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException { - NioServerSocketChannel channel = new NioServerSocketChannel(port, handler); - channel.bind(); - return channel; - } - - private static AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException { - NioDatagramChannel channel = new NioDatagramChannel(port, handler); - channel.bind(); - return channel; - } -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java deleted file mode 100644 index e84c506f9..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/ChannelHandler.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.iluwatar.reactor; - -import java.nio.channels.SelectionKey; - -public interface ChannelHandler { - - void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key); -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java deleted file mode 100644 index 7c05a6c1d..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/Dispatcher.java +++ /dev/null @@ -1,8 +0,0 @@ -package com.iluwatar.reactor; - -import java.nio.channels.SelectionKey; - -public interface Dispatcher { - void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key); - void stop(); -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java deleted file mode 100644 index fc7efaeed..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/LoggingHandler.java +++ /dev/null @@ -1,39 +0,0 @@ -package com.iluwatar.reactor; - -import java.nio.ByteBuffer; -import java.nio.channels.SelectionKey; - -import com.iluwatar.reactor.NioDatagramChannel.DatagramPacket; - -public class LoggingHandler implements ChannelHandler { - - @Override - public void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key) { - if (readObject instanceof ByteBuffer) { - byte[] data = ((ByteBuffer)readObject).array(); - doLogging(data); - sendReply(channel, data, key); - } else if (readObject instanceof DatagramPacket) { - DatagramPacket datagram = (DatagramPacket)readObject; - byte[] data = datagram.getData().array(); - doLogging(data); - sendReply(channel, datagram, key); - } - } - - private void sendReply(AbstractNioChannel channel, DatagramPacket datagram, SelectionKey key) { - DatagramPacket replyPacket = new DatagramPacket(ByteBuffer.wrap("Data logged successfully".getBytes())); - replyPacket.setReceiver(datagram.getSender()); - channel.write(replyPacket, key); - } - - private void sendReply(AbstractNioChannel channel, byte[] data, SelectionKey key) { - ByteBuffer buffer = ByteBuffer.wrap("Data logged successfully".getBytes()); - channel.write(buffer, key); - } - - private void doLogging(byte[] data) { - // assuming UTF-8 :( - System.out.println(new String(data)); - } -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java deleted file mode 100644 index 4d1690792..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/NioDatagramChannel.java +++ /dev/null @@ -1,80 +0,0 @@ -package com.iluwatar.reactor; - -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; - -public class NioDatagramChannel extends AbstractNioChannel { - - private int port; - - public NioDatagramChannel(int port, ChannelHandler handler) throws IOException { - super(handler, DatagramChannel.open()); - this.port = port; - } - - @Override - public int getInterestedOps() { - return SelectionKey.OP_READ; - } - - @Override - public Object read(SelectionKey key) throws IOException { - ByteBuffer buffer = ByteBuffer.allocate(1024); - SocketAddress sender = getChannel().receive(buffer); - DatagramPacket packet = new DatagramPacket(buffer); - packet.setSender(sender); - return packet; - } - - @Override - public DatagramChannel getChannel() { - return (DatagramChannel) super.getChannel(); - } - - public void bind() throws IOException { - getChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port)); - getChannel().configureBlocking(false); - System.out.println("Bound UDP socket at port: " + port); - } - - @Override - protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException { - DatagramPacket pendingPacket = (DatagramPacket) pendingWrite; - getChannel().send(pendingPacket.getData(), pendingPacket.getReceiver()); - } - - static class DatagramPacket { - private SocketAddress sender; - private ByteBuffer data; - private SocketAddress receiver; - - public DatagramPacket(ByteBuffer data) { - this.data = data; - } - - public SocketAddress getSender() { - return sender; - } - - public void setSender(SocketAddress sender) { - this.sender = sender; - } - - public SocketAddress getReceiver() { - return receiver; - } - - public void setReceiver(SocketAddress receiver) { - this.receiver = receiver; - } - - public ByteBuffer getData() { - return data; - } - } -} \ No newline at end of file diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java deleted file mode 100644 index 6ee0cb989..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/NioReactor.java +++ /dev/null @@ -1,170 +0,0 @@ -package com.iluwatar.reactor; - -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; - -/* - * Abstractions - * --------------- - * 2 - Synchronous Event De-multiplexer - */ -public class NioReactor { - - private Selector selector; - private Dispatcher dispatcher; - private Queue pendingChanges = new ConcurrentLinkedQueue<>(); - private ExecutorService reactorService = Executors.newSingleThreadExecutor(); - - public NioReactor(Dispatcher dispatcher) throws IOException { - this.dispatcher = dispatcher; - this.selector = Selector.open(); - } - - public NioReactor registerChannel(AbstractNioChannel channel) throws IOException { - SelectionKey key = channel.getChannel().register(selector, channel.getInterestedOps()); - key.attach(channel); - channel.setReactor(this); - return this; - } - - public void start() throws IOException { - reactorService.execute(new Runnable() { - @Override - public void run() { - try { - System.out.println("Reactor started, waiting for events..."); - eventLoop(); - } catch (IOException e) { - e.printStackTrace(); - } - } - }); - } - - public void stop() { - reactorService.shutdownNow(); - selector.wakeup(); - try { - reactorService.awaitTermination(4, TimeUnit.SECONDS); - } catch (InterruptedException e) { - e.printStackTrace(); - } - dispatcher.stop(); - } - - private void eventLoop() throws IOException { - while (true) { - - if (Thread.interrupted()) { - break; - } - - // honor any pending requests first - processPendingChanges(); - - selector.select(); - - 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 processPendingChanges() { - Iterator iterator = pendingChanges.iterator(); - while (iterator.hasNext()) { - Command command = iterator.next(); - command.execute(); - iterator.remove(); - } - } - - private void processKey(SelectionKey key) throws IOException { - if (key.isAcceptable()) { - acceptConnection(key); - } else if (key.isReadable()) { - read(key); - } else if (key.isWritable()) { - write(key); - } - } - - private void write(SelectionKey key) throws IOException { - AbstractNioChannel channel = (AbstractNioChannel) key.attachment(); - channel.write(key); - } - - private void read(SelectionKey key) { - Object readObject; - try { - readObject = ((AbstractNioChannel)key.attachment()).read(key); - dispatchReadEvent(key, readObject); - } catch (IOException e) { - try { - key.channel().close(); - } catch (IOException e1) { - e1.printStackTrace(); - } - } - } - - private void dispatchReadEvent(SelectionKey key, Object readObject) { - dispatcher.onChannelReadEvent((AbstractNioChannel)key.attachment(), readObject, key); - } - - private void acceptConnection(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()); - } - - interface Command { - void execute(); - } - - public void changeOps(SelectionKey key, int interestedOps) { - pendingChanges.add(new ChangeKeyOpsCommand(key, interestedOps)); - selector.wakeup(); - } - - class ChangeKeyOpsCommand implements Command { - private SelectionKey key; - private int interestedOps; - - public ChangeKeyOpsCommand(SelectionKey key, int interestedOps) { - this.key = key; - this.interestedOps = interestedOps; - } - - public void execute() { - key.interestOps(interestedOps); - } - - @Override - public String toString() { - return "Change of ops to: " + interestedOps; - } - } -} \ No newline at end of file diff --git a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java deleted file mode 100644 index c27050a15..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/SameThreadDispatcher.java +++ /dev/null @@ -1,18 +0,0 @@ -package com.iluwatar.reactor; - -import java.nio.channels.SelectionKey; - -public class SameThreadDispatcher implements Dispatcher { - - @Override - public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { - if (channel.getHandler() != null) { - channel.getHandler().handleChannelRead(channel, readObject, key); - } - } - - @Override - public void stop() { - // no-op - } -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java deleted file mode 100644 index 600cb4da4..000000000 --- a/reactor/src/main/java/com/iluwatar/reactor/ThreadPoolDispatcher.java +++ /dev/null @@ -1,37 +0,0 @@ -package com.iluwatar.reactor; - -import java.nio.channels.SelectionKey; -import java.util.concurrent.ExecutorService; -import java.util.concurrent.Executors; -import java.util.concurrent.TimeUnit; - -public class ThreadPoolDispatcher extends SameThreadDispatcher { - - private ExecutorService executorService; - - public ThreadPoolDispatcher(int poolSize) { - this.executorService = Executors.newFixedThreadPool(poolSize); - } - - @Override - public void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key) { - executorService.execute(new Runnable() { - - @Override - public void run() { - ThreadPoolDispatcher.super.onChannelReadEvent(channel, readObject, key); - } - }); - } - - @Override - public void stop() { - executorService.shutdownNow(); - try { - executorService.awaitTermination(1000, TimeUnit.SECONDS); - } catch (InterruptedException e) { - e.printStackTrace(); - } - } - -} diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java new file mode 100644 index 000000000..d7b280465 --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java @@ -0,0 +1,106 @@ +package com.iluwatar.reactor.app; + +import java.io.IOException; + +import com.iluwatar.reactor.framework.AbstractNioChannel; +import com.iluwatar.reactor.framework.ChannelHandler; +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. It represents a Distributed Logging Service + * where it can listen 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
      • + *
    + * + *

    + * 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. + * + * @author npathai + * + */ +public class App { + + private NioReactor reactor; + + /** + * App entry. + */ + public static void main(String[] args) { + try { + new App().start(); + } catch (IOException e) { + e.printStackTrace(); + } + } + + /** + * 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(new ThreadPoolDispatcher(2)); + + /* + * This represents application specific business logic that dispatcher will call + * on appropriate events. These events are read and write event in our example. + */ + LoggingHandler loggingHandler = new LoggingHandler(); + + /* + * Our application binds to multiple I/O 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. + */ + public void stop() { + reactor.stop(); + } + + private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException { + NioServerSocketChannel channel = new NioServerSocketChannel(port, handler); + channel.bind(); + return channel; + } + + private static AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException { + NioDatagramChannel channel = new NioDatagramChannel(port, handler); + channel.bind(); + return channel; + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java similarity index 99% rename from reactor/src/main/java/com/iluwatar/reactor/AppClient.java rename to reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java index 2ffb6c0de..e5a7dd145 100644 --- a/reactor/src/main/java/com/iluwatar/reactor/AppClient.java +++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java @@ -1,4 +1,4 @@ -package com.iluwatar.reactor; +package com.iluwatar.reactor.app; import java.io.IOException; import java.io.InputStream; diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java new file mode 100644 index 000000000..6fa95de2d --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java @@ -0,0 +1,62 @@ +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; + +/** + * Logging server application logic. It logs the incoming requests on standard console and returns + * a canned acknowledgement back to the remote peer. + * + * @author npathai + */ +public class LoggingHandler implements ChannelHandler { + + 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 channel is attached to 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) { + byte[] data = ((ByteBuffer)readObject).array(); + doLogging(data); + sendReply(channel, data, key); + } else if (readObject instanceof DatagramPacket) { + DatagramPacket datagram = (DatagramPacket)readObject; + byte[] data = datagram.getData().array(); + doLogging(data); + sendReply(channel, datagram, key); + } else { + throw new IllegalStateException("Unknown data received"); + } + } + + private 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 void sendReply(AbstractNioChannel channel, byte[] data, SelectionKey key) { + ByteBuffer buffer = ByteBuffer.wrap(ACK); + channel.write(buffer, key); + } + + private void doLogging(byte[] data) { + // assuming UTF-8 :( + System.out.println(new String(data)); + } +} diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java new file mode 100644 index 000000000..a4b18179a --- /dev/null +++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java @@ -0,0 +1,150 @@ +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. + * + * @author npathai + * + */ +public abstract class AbstractNioChannel { + + private SelectableChannel channel; + private ChannelHandler handler; + private 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 getChannel() { + return channel; + } + + /** + * The operation in which the channel is interested, this operation is be provided to {@link Selector}. + * + * @return interested operation. + * @see SelectionKey + */ + public abstract int getInterestedOps(); + + /** + * Requests the channel to bind. + * + * @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. + * @param key the key which is readable. + * @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 data which was queued for writing in batch mode. + * @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);
+	}
+}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
new file mode 100644
index 000000000..e1df57020
--- /dev/null
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
@@ -0,0 +1,25 @@
+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} is 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.
+ *  
+ * @author npathai
+ */
+public interface ChannelHandler {
+
+	/**
+	 * Called when the {@code channel} has received some data from remote peer.
+	 *   
+	 * @param channel the channel from which the data is received.
+	 * @param readObject the data read.
+	 * @param key the key from which the data is received.
+	 */
+	void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key);
+}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
new file mode 100644
index 000000000..120a11085
--- /dev/null
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
@@ -0,0 +1,38 @@
+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 event. 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
+ * 
+ * @author npathai
+ */
+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.
+	 *  
+	 * @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 the dispatching events and cleans up any acquired resources such as threads.
+	 */
+	void stop();
+}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
new file mode 100644
index 000000000..2666f05b8
--- /dev/null
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -0,0 +1,156 @@
+package com.iluwatar.reactor.framework;
+
+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.
+ * 
+ * @author npathai
+ */
+public class NioDatagramChannel extends AbstractNioChannel {
+
+	private 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 = getChannel().receive(buffer);
+		
+		/*
+		 * It is required to create a DatagramPacket because we need to preserve which
+		 * socket address acts as destination for sending reply packets. 
+		 */
+		DatagramPacket packet = new DatagramPacket(buffer);
+		packet.setSender(sender);
+		
+		return packet;
+	}
+	
+	/**
+	 * @return the underlying datagram channel.
+	 */
+	@Override
+	public DatagramChannel getChannel() {
+		return (DatagramChannel) super.getChannel();
+	}
+	
+	/**
+	 * Binds UDP socket on the provided port.
+	 *  
+	 * @throws IOException if any I/O error occurs.
+	 */
+	@Override
+	public void bind() throws IOException {
+		getChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
+		getChannel().configureBlocking(false);
+		System.out.println("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;
+		getChannel().send(pendingPacket.getData(), pendingPacket.getReceiver());
+	}
+
+	/**
+	 * Write 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;
+		}
+	}
+}
\ No newline at end of file
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
new file mode 100644
index 000000000..b92f4a9ba
--- /dev/null
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -0,0 +1,242 @@
+package com.iluwatar.reactor.framework;
+
+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} as a mechanism for achieving Synchronous Event De-multiplexing.
+ * 
+ * 
    
+ * NOTE: This is one of the way to implement NIO reactor and it does not take care of all possible edge cases
+ * which may be required in a real application. This implementation is meant to demonstrate the fundamental
+ * concepts that lie behind Reactor pattern.
+ * 
+ * @author npathai
+ *
+ */
+public class NioReactor {
+
+	private Selector selector;
+	private 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 Queue pendingCommands = new ConcurrentLinkedQueue<>();
+	private 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(new Runnable() {
+			@Override
+			public void run() {
+				try {
+					System.out.println("Reactor started, waiting for events...");
+					eventLoop();
+				} catch (IOException e) {
+					e.printStackTrace();
+				}
+			}
+		});
+	}
+	
+	/**
+	 * Stops the reactor and related resources such as dispatcher.
+	 */
+	public void stop() {
+		reactorMain.shutdownNow();
+		selector.wakeup();
+		try {
+			reactorMain.awaitTermination(4, TimeUnit.SECONDS);
+		} catch (InterruptedException e) {
+			e.printStackTrace();
+		}
+		dispatcher.stop();
+	}
+
+	/**
+	 * Registers a new channel (handle) with this reactor after which the reactor will wait for events
+	 * on this channel. While registering the channel the reactor uses {@link AbstractNioChannel#getInterestedOps()}
+	 * to know about the interested operation of this channel.
+	 * 
+	 * @param channel a new handle 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.getChannel().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 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 respective handlers.
+	 */
+	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 are changed when
+	 * this method returns.
+	 * 
+	 * @param key the key for which operations are 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;
+		}
+	}
+}
\ No newline at end of file
diff --git a/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
similarity index 52%
rename from reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java
rename to reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index ebd8f0ef3..92fa9234f 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -1,4 +1,4 @@
-package com.iluwatar.reactor;
+package com.iluwatar.reactor.framework;
 
 import java.io.IOException;
 import java.net.InetAddress;
@@ -8,25 +8,51 @@ 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}.
+ * 
+ * @author npathai
+ */
 public class NioServerSocketChannel extends AbstractNioChannel {
 
 	private 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 to be bound to listen for incoming requests.
+	 * @param handler the handler to be used for handling 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 clients.
 		return SelectionKey.OP_ACCEPT;
 	}
 
+	/**
+	 * @return the underlying {@link ServerSocketChannel}.
+	 */
 	@Override
 	public ServerSocketChannel getChannel() {
 		return (ServerSocketChannel) super.getChannel();
 	}
 	
+	/**
+	 * 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();
@@ -38,12 +64,22 @@ public class NioServerSocketChannel extends AbstractNioChannel {
 		return buffer;
 	}
 
+	/**
+	 * Binds TCP socket on the provided port.
+	 *  
+	 * @throws IOException if any I/O error occurs.
+	 */
+	@Override
 	public void bind() throws IOException {
 		((ServerSocketChannel)getChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
 		((ServerSocketChannel)getChannel()).configureBlocking(false);
 		System.out.println("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;
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
new file mode 100644
index 000000000..2300d7c74
--- /dev/null
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
@@ -0,0 +1,43 @@
+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 real applications use {@link ThreadPoolDispatcher}.
+ * 
+ * @see ThreadPoolDispatcher
+ * 
+ * @author npathai
+ */
+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) {
+		if (channel.getHandler() != null) {
+			/*
+			 * 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
+	}
+}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
new file mode 100644
index 000000000..b514d1824
--- /dev/null
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
@@ -0,0 +1,55 @@
+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
+ * for better scalability as the application specific processing is not performed in the context
+ * of I/O thread.
+ * 
+ * @author npathai
+ *
+ */
+public class ThreadPoolDispatcher extends SameThreadDispatcher {
+
+	private 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(() -> 
+			ThreadPoolDispatcher.super.onChannelReadEvent(channel, readObject, key));
+	}
+
+	/**
+	 * Stops the pool of workers.
+	 */
+	@Override
+	public void stop() {
+		executorService.shutdownNow();
+		try {
+			executorService.awaitTermination(1000, TimeUnit.SECONDS);
+		} catch (InterruptedException e) {
+			e.printStackTrace();
+		}
+	}
+
+}
diff --git a/reactor/src/test/java/com/iluwatar/reactor/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
similarity index 91%
rename from reactor/src/test/java/com/iluwatar/reactor/AppTest.java
rename to reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
index 17ce0b912..9447aac01 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/AppTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
@@ -1,4 +1,4 @@
-package com.iluwatar.reactor;
+package com.iluwatar.reactor.app;
 
 import java.io.IOException;
 
diff --git a/reactor/todo.txt b/reactor/todo.txt
index af06a1892..a59af62b9 100644
--- a/reactor/todo.txt
+++ b/reactor/todo.txt
@@ -2,3 +2,12 @@
 * Cleanup
 * Document - Javadoc
 * Better design?? Get review of @iluwatar
+
+
+Design view:
+
+Handles ---> AbstractNioChannel
+Selector ---> Synchronous Event Demultiplexer
+NioReactor ---> Initiation Dispatcher
+
+

From 5956873fc9d7069c4386cafc18cda143e82e6b91 Mon Sep 17 00:00:00 2001
From: Alan 
Date: Sat, 5 Sep 2015 00:31:35 +0100
Subject: [PATCH 191/687] Improved unit tests so assertions are used.

---
 .../com/iluwatar/abstractfactory/App.java     | 68 ++++++++++++----
 .../com/iluwatar/abstractfactory/Army.java    |  1 +
 .../com/iluwatar/abstractfactory/Castle.java  |  1 +
 .../com/iluwatar/abstractfactory/ElfArmy.java |  9 ++-
 .../iluwatar/abstractfactory/ElfCastle.java   |  9 ++-
 .../com/iluwatar/abstractfactory/ElfKing.java |  7 +-
 .../com/iluwatar/abstractfactory/King.java    |  1 +
 .../com/iluwatar/abstractfactory/OrcArmy.java |  9 ++-
 .../iluwatar/abstractfactory/OrcCastle.java   |  9 ++-
 .../com/iluwatar/abstractfactory/OrcKing.java |  7 +-
 .../com/iluwatar/abstractfactory/AppTest.java | 79 ++++++++++++++++---
 11 files changed, 152 insertions(+), 48 deletions(-)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index d18f1abed..29e9272f6 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -1,5 +1,6 @@
 package com.iluwatar.abstractfactory;
 
+
 /**
  * 
  * The essence of the Abstract Factory pattern is a factory interface
@@ -12,26 +13,61 @@ package com.iluwatar.abstractfactory;
  */
 public class App {
 
-	/**
-	 * Program entry point
-	 * @param args command line arguments
-	 */
-	public static void main(String[] args) {
-		createKingdom(new ElfKingdomFactory());
-		createKingdom(new OrcKingdomFactory());
-	}
+	private King king;
+	private Castle castle;
+	private Army army;
 
 	/**
 	 * Creates kingdom
 	 * @param factory
 	 */
-	public static void createKingdom(KingdomFactory factory) {
-		King king = factory.createKing();
-		Castle castle = factory.createCastle();
-		Army army = factory.createArmy();
-		System.out.println("The kingdom was created.");
-		System.out.println(king);
-		System.out.println(castle);
-		System.out.println(army);
+	public void createKingdom(final KingdomFactory factory) {
+		setKing(factory.createKing());
+		setCastle(factory.createCastle());
+		setArmy(factory.createArmy());
+	}
+	
+	ElfKingdomFactory getElfKingdomFactory() {
+		return new ElfKingdomFactory();
+	}
+	
+	OrcKingdomFactory getOrcKingdomFactory() {
+		return new OrcKingdomFactory();
+	}
+	
+	King getKing(final KingdomFactory factory) {
+		return factory.createKing();
+	}
+	
+	Castle getCastle(final KingdomFactory factory) {
+		return factory.createCastle();
+	}
+	
+	Army getArmy(final KingdomFactory factory) {
+		return factory.createArmy();
+	}
+	
+	public King getKing() {
+		return king;
+	}
+	
+	private void setKing(final King king) {
+		this.king = king;
+	}
+	
+	public Castle getCastle() {
+		return castle;
+	}
+	
+	private void setCastle(final Castle castle) {
+		this.castle = castle;
+	}
+	
+	public Army getArmy() {
+		return army;
+	}
+	
+	private void setArmy(final Army army) {
+		this.army = army;
 	}
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
index 225331517..333b5c2cd 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
@@ -7,4 +7,5 @@ package com.iluwatar.abstractfactory;
  */
 public interface Army {
 
+	String getDescription();
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
index 272a97bf3..0290cb67c 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
@@ -7,4 +7,5 @@ package com.iluwatar.abstractfactory;
  */
 public interface Castle {
 
+	String getDescription();
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
index d77fe8ebd..410f46951 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
@@ -7,9 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfArmy implements Army {
 
-	@Override
-	public String toString() {
-		return "This is the Elven Army!";
-	}
+	static final String DESCRIPTION = "This is the Elven Army!";
 
+	@Override
+	public String getDescription() {
+		return DESCRIPTION;
+	}
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
index 5c2b2a62a..fe2e9a0e7 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
@@ -7,9 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfCastle implements Castle {
 
-	@Override
-	public String toString() {
-		return "This is the Elven castle!";
-	}
+	static final String DESCRIPTION = "This is the Elven castle!";
 
+	@Override
+	public String getDescription() {
+		return DESCRIPTION;
+	}
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
index df475a354..66571ee01 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
@@ -7,9 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfKing implements King {
 
+	static final String DESCRIPTION = "This is the Elven king!";
+	
 	@Override
-	public String toString() {
-		return "This is the Elven king!";
+	public String getDescription() {
+		return DESCRIPTION;
 	}
-
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
index 0b75dbb0a..c7b9a867c 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
@@ -7,4 +7,5 @@ package com.iluwatar.abstractfactory;
  */
 public interface King {
 
+	String getDescription();
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
index d331252dc..108700511 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
@@ -7,9 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcArmy implements Army {
 
-	@Override
-	public String toString() {
-		return "This is the Orcish Army!";
-	}
+	static final String DESCRIPTION = "This is the Orc Army!";
 
+	@Override
+	public String getDescription() {
+		return DESCRIPTION;
+	}
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
index fd09d9c17..5012f9200 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
@@ -7,9 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcCastle implements Castle {
 
-	@Override
-	public String toString() {
-		return "This is the Orcish castle!";
-	}
+	static final String DESCRIPTION = "This is the Orc castle!";
 
+	@Override
+	public String getDescription() {
+		return DESCRIPTION;
+	}
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
index 5bae8f31b..a5657d4e4 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
@@ -7,9 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcKing implements King {
 
+static final String DESCRIPTION = "This is the Orc king!";
+	
 	@Override
-	public String toString() {
-		return "This is the Orc king!";
+	public String getDescription() {
+		return DESCRIPTION;
 	}
-
 }
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
index 91db0a4be..78cdf8a44 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
@@ -1,18 +1,77 @@
 package com.iluwatar.abstractfactory;
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertTrue;
+
+import org.junit.Before;
 import org.junit.Test;
 
-import com.iluwatar.abstractfactory.App;
-
-/**
- * 
- * Application test
- *
- */
 public class AppTest {
 
+	private App app = new App();;
+	private KingdomFactory elfFactory;
+	private KingdomFactory orcFactory;
+	
+	@Before
+	public void setUp() {
+		elfFactory = app.getElfKingdomFactory();
+		orcFactory = app.getOrcKingdomFactory();
+	}
+	
 	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
+	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());
 	}
 }

From 3da48d970c40552aabd662bf0d1ec29ca5d7b302 Mon Sep 17 00:00:00 2001
From: Alan 
Date: Sat, 5 Sep 2015 21:54:14 +0100
Subject: [PATCH 192/687] Inclusion of log4j dependency rather than relying on
 System.out.println() statements. Added unit tests for doa module.

---
 dao/pom.xml                                   | 42 +++++----
 dao/src/main/java/com/iluwatar/dao/App.java   | 47 +++++-----
 .../main/java/com/iluwatar/dao/Customer.java  | 41 +++++----
 .../java/com/iluwatar/dao/CustomerDao.java    | 10 +--
 .../com/iluwatar/dao/CustomerDaoImpl.java     | 28 +++---
 .../test/java/com/iluwatar/dao/AppTest.java   | 19 ----
 .../com/iluwatar/dao/CustomerDaoImplTest.java | 81 +++++++++++++++++
 .../java/com/iluwatar/dao/CustomerTest.java   | 87 +++++++++++++++++++
 dao/src/test/resources/log4j.xml              | 17 ++++
 pom.xml                                       |  6 ++
 10 files changed, 282 insertions(+), 96 deletions(-)
 delete mode 100644 dao/src/test/java/com/iluwatar/dao/AppTest.java
 create mode 100644 dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
 create mode 100644 dao/src/test/java/com/iluwatar/dao/CustomerTest.java
 create mode 100644 dao/src/test/resources/log4j.xml

diff --git a/dao/pom.xml b/dao/pom.xml
index a7a5c74ca..b55a8b1f3 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -1,18 +1,28 @@
 
-
-  4.0.0
-  
-    com.iluwatar
-    java-design-patterns
-    1.6.0
-  
-  dao
-  
-    
-      junit
-      junit
-      test
-    
-  
+
+	4.0.0
+	
+		com.iluwatar
+		java-design-patterns
+		1.6.0
+	
+	dao
+	
+	
+		
+	
+	
+	
+		
+			junit
+			junit
+			test
+		
+		
+			log4j
+			log4j
+		
+	
 
diff --git a/dao/src/main/java/com/iluwatar/dao/App.java b/dao/src/main/java/com/iluwatar/dao/App.java
index ac6794973..d3ee667ce 100644
--- a/dao/src/main/java/com/iluwatar/dao/App.java
+++ b/dao/src/main/java/com/iluwatar/dao/App.java
@@ -3,6 +3,8 @@ package com.iluwatar.dao;
 import java.util.ArrayList;
 import java.util.List;
 
+import org.apache.log4j.Logger;
+
 /**
  * 
  * With the DAO pattern, we can use various method calls to retrieve/add/delete/update data without directly
@@ -11,43 +13,38 @@ import java.util.List;
  */
 public class App {
 
+	private static Logger LOGGER = Logger.getLogger(App.class);
+
 	/**
-	 * Program entry point
-	 * @param args command line args
+	 * Program entry point.
+	 * 
+	 * @param args command line args.
 	 */
-	public static void main(String[] args) {
-
-		CustomerDaoImpl customerDao = new CustomerDaoImpl(generateSampleCustomers());
-
-		System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-		System.out.println("customerDao.getCusterById(2): " + customerDao.getCusterById(2));
-
-		Customer customer = new Customer(4, "Dan", "Danson");
+	public static void main(final String[] args) {
+		final CustomerDaoImpl customerDao = new CustomerDaoImpl(generateSampleCustomers());
+		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
+		LOGGER.info("customerDao.getCusterById(2): " + customerDao.getCustomerById(2));
+		final Customer customer = new Customer(4, "Dan", "Danson");
 		customerDao.addCustomer(customer);
-
-		System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-
+		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
 		customer.setFirstName("Daniel");
 		customer.setLastName("Danielson");
 		customerDao.updateCustomer(customer);
-
-		System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-
+		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
 		customerDao.deleteCustomer(customer);
-
-		System.out.println("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
+		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
 	}
 
 	/**
-	 * Generate customers
-	 * @return list of customers
+	 * Generate customers.
+	 * 
+	 * @return list of customers.
 	 */
 	public static List generateSampleCustomers() {
-		Customer customer1 = new Customer(1, "Adam", "Adamson");
-		Customer customer2 = new Customer(2, "Bob", "Bobson");
-		Customer customer3 = new Customer(3, "Carl", "Carlson");
-
-		List customers = new ArrayList();
+		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);
diff --git a/dao/src/main/java/com/iluwatar/dao/Customer.java b/dao/src/main/java/com/iluwatar/dao/Customer.java
index 8cfdd8034..652eda7b2 100644
--- a/dao/src/main/java/com/iluwatar/dao/Customer.java
+++ b/dao/src/main/java/com/iluwatar/dao/Customer.java
@@ -11,7 +11,7 @@ public class Customer {
     private String firstName;
     private String lastName;
 
-    public Customer(int id, String firstName, String lastName) {
+    public Customer(final int id, final String firstName, final String lastName) {
         this.id = id;
         this.firstName = firstName;
         this.lastName = lastName;
@@ -21,7 +21,7 @@ public class Customer {
         return id;
     }
 
-    public void setId(int id) {
+    public void setId(final int id) {
         this.id = id;
     }
 
@@ -29,7 +29,7 @@ public class Customer {
         return firstName;
     }
 
-    public void setFirstName(String firstName) {
+    public void setFirstName(final String firstName) {
         this.firstName = firstName;
     }
 
@@ -37,34 +37,39 @@ public class Customer {
         return lastName;
     }
 
-    public void setLastName(String lastName) {
+    public void setLastName(final String lastName) {
         this.lastName = lastName;
     }
 
     @Override
     public String toString() {
         return "Customer{" +
-                "id=" + id +
-                ", firstName='" + firstName + '\'' +
-                ", lastName='" + lastName + '\'' +
+                "id=" + getId() +
+                ", firstName='" + getFirstName() + '\'' +
+                ", lastName='" + getLastName() + '\'' +
                 '}';
     }
 
+    /**
+     * Checks if two objects are the same.
+     * 
+     * @return true if the two objects are Customer objects and have the same id value, false otherwise.
+     */
     @Override
-    public boolean equals(Object o) {
-        if (this == o) return true;
-        if (o == null || getClass() != o.getClass()) return false;
-
-        Customer customer = (Customer) o;
-
-        if (id != customer.id) return false;
-
-        return true;
+    public boolean equals(final Object o) {
+    	boolean isEqual = false;
+    	final Customer customer = (Customer) o;
+        if (getId() == customer.getId()) {
+        	isEqual = true;
+        }
+        return isEqual;
     }
-
+    
     @Override
     public int hashCode() {
-        int result = id;
+        int result = getId();
+        id += getFirstName().hashCode();
+        id += getLastName().hashCode();
         return result;
     }
 }
\ No newline at end of file
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
index 2a50d2bfb..54f388dde 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
@@ -9,9 +9,9 @@ import java.util.List;
  */
 public interface CustomerDao {
 	
-    public List getAllCustomers();
-    public Customer getCusterById(int id);
-    public void addCustomer(Customer customer);
-    public void updateCustomer(Customer customer);
-    public void deleteCustomer(Customer customer);
+    List getAllCustomers();
+    Customer getCustomerById(final int id);
+    void addCustomer(final Customer customer);
+    void updateCustomer(final Customer customer);
+    void deleteCustomer(final Customer customer);
 }
\ No newline at end of file
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java b/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java
index 4403b57ed..e5c431452 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java
@@ -17,7 +17,7 @@ public class CustomerDaoImpl implements CustomerDao {
     // Note: Normally this would be in the form of an actual database and not part of the Dao Impl.
     private List customers;
 
-    public CustomerDaoImpl(List customers) {
+    public CustomerDaoImpl(final List customers) {
         this.customers = customers;
     }
 
@@ -27,31 +27,33 @@ public class CustomerDaoImpl implements CustomerDao {
     }
 
     @Override
-    public Customer getCusterById(int id) {
-        for (int i = 0; i < customers.size(); i++) {
-            if (customers.get(i).getId() == id) {
-                return customers.get(i);
+    public Customer getCustomerById(final int id) {
+    	Customer customer = null;
+        for (final Customer cus : getAllCustomers()) {
+            if (cus.getId() == id) {
+                customer = cus;
+                break;
             }
         }
-        // No customer found
-        return null;
+        return customer;
     }
 
     @Override
-    public void addCustomer(Customer customer) {
+    public void addCustomer(final Customer customer) {
         customers.add(customer);
     }
 
 
     @Override
-    public void updateCustomer(Customer customer) {
-        if (customers.contains(customer)) {
-            customers.set(customers.indexOf(customer), customer);
+    public void updateCustomer(final Customer customer) {
+        if (getAllCustomers().contains(customer)) {
+        	final int index = getAllCustomers().indexOf(customer);
+            getAllCustomers().set(index, customer);
         }
     }
 
     @Override
-    public void deleteCustomer(Customer customer) {
-        customers.remove(customer);
+    public void deleteCustomer(final Customer customer) {
+        getAllCustomers().remove(customer);
     }
 }
\ No newline at end of file
diff --git a/dao/src/test/java/com/iluwatar/dao/AppTest.java b/dao/src/test/java/com/iluwatar/dao/AppTest.java
deleted file mode 100644
index 5eb1ebb11..000000000
--- a/dao/src/test/java/com/iluwatar/dao/AppTest.java
+++ /dev/null
@@ -1,19 +0,0 @@
-package com.iluwatar.dao;
-
-import org.junit.Test;
-
-import com.iluwatar.dao.App;
-
-/**
- * 
- * Application test
- *
- */
-public class AppTest {
-
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
-}
diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
new file mode 100644
index 000000000..ae87be156
--- /dev/null
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
@@ -0,0 +1,81 @@
+package com.iluwatar.dao;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
+import static org.junit.Assert.assertTrue;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.junit.Before;
+import org.junit.Test;
+
+public class CustomerDaoImplTest {
+
+	private CustomerDaoImpl impl;
+	private List customers;
+	private static final Customer CUSTOMER = new Customer(1, "Freddy", "Kruger");
+	
+	@Before
+	public void setUp() {
+		customers = new ArrayList();
+		customers.add(CUSTOMER);
+		impl = new CustomerDaoImpl(customers);
+	}
+	
+	@Test
+	public void deleteExistingCustomer() {
+		assertEquals(1, impl.getAllCustomers().size());
+		impl.deleteCustomer(CUSTOMER);
+		assertTrue(impl.getAllCustomers().isEmpty());
+	}
+	
+	@Test
+	public void deleteNonExistingCustomer() {
+		final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund");
+		impl.deleteCustomer(nonExistingCustomer);
+		assertEquals(1, impl.getAllCustomers().size());
+	}
+	
+	@Test
+	public void updateExistingCustomer() {
+		final String newFirstname = "Bernard";
+		final String newLastname = "Montgomery";
+		final Customer customer = new Customer(CUSTOMER.getId(), newFirstname, newLastname);
+		impl.updateCustomer(customer);
+		final Customer cust = impl.getCustomerById(CUSTOMER.getId());
+		assertEquals(newFirstname, cust.getFirstName());
+		assertEquals(newLastname, cust.getLastName());
+	}
+	
+	@Test
+	public void updateNonExistingCustomer() {
+		final int nonExistingId = 999;
+		final String newFirstname = "Douglas";
+		final String newLastname = "MacArthur";
+		final Customer customer = new Customer(nonExistingId, newFirstname, newLastname);
+		impl.updateCustomer(customer);
+		assertNull(impl.getCustomerById(nonExistingId));
+		final Customer existingCustomer = impl.getCustomerById(CUSTOMER.getId());
+		assertEquals(CUSTOMER.getFirstName(), existingCustomer.getFirstName());
+		assertEquals(CUSTOMER.getLastName(), existingCustomer.getLastName());
+	}
+	
+	@Test
+	public void addCustomer() {
+		final Customer newCustomer = new Customer(3, "George", "Patton");
+		impl.addCustomer(newCustomer);
+		assertEquals(2, impl.getAllCustomers().size());
+	}
+	
+	@Test
+	public void getExistinCustomerById() {
+		assertEquals(CUSTOMER, impl.getCustomerById(CUSTOMER.getId()));
+	}
+	
+	@Test
+	public void getNonExistinCustomerById() {
+		final int nonExistingId = 999;
+		assertNull(impl.getCustomerById(nonExistingId));
+	}
+}
diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
new file mode 100644
index 000000000..cd90a6643
--- /dev/null
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
@@ -0,0 +1,87 @@
+package com.iluwatar.dao;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertFalse;
+import static org.junit.Assert.assertTrue;
+
+import org.junit.Before;
+import org.junit.Test;
+
+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 getIndex() {
+		assertEquals(ID, customer.getId());
+	}
+	
+	@Test
+	public void getFirstname() {
+		assertEquals(FIRSTNAME, customer.getFirstName());
+	}
+	
+	@Test
+	public void getLastname() {
+		assertEquals(LASTNAME, customer.getLastName());
+	}
+	
+	@Test
+	public void setIndex() {
+		final int newId = 2;
+		customer.setId(newId);
+		assertEquals(newId, customer.getId());
+	}
+	
+	@Test
+	public void setFirstname() {
+		final String newFirstname = "Bill";
+		customer.setFirstName(newFirstname);
+		assertEquals(newFirstname, customer.getFirstName());
+	}
+	
+	@Test
+	public void setLastname() {
+		final String newLastname = "Clinton";
+		customer.setLastName(newLastname);
+		assertEquals(newLastname, customer.getLastName());
+	}
+	
+	@Test
+	public void equalsWithDifferentId() {
+		final int newId = 2;
+		final Customer otherCustomer = new Customer(newId, FIRSTNAME, LASTNAME);
+		assertFalse(customer.equals(otherCustomer));
+	}
+	
+	@Test
+	public void equalsWithSameObjects() {
+		final Customer otherCustomer = new Customer(ID, FIRSTNAME, LASTNAME);
+		assertTrue(customer.equals(otherCustomer));
+	}
+	
+	@Test
+	public void testHashCode() {
+		assertTrue(customer.hashCode() > 0);
+	}
+	
+	@Test
+	public void testToString() {
+		final StringBuffer buffer = new StringBuffer();
+		buffer.append("Customer{id=");
+        buffer.append(""+customer.getId());
+        buffer.append(", firstName='");
+        buffer.append(customer.getFirstName());
+        buffer.append("\', lastName='");
+        buffer.append(customer.getLastName() + "\'}");
+		assertEquals(buffer.toString(), customer.toString());
+	}
+}
diff --git a/dao/src/test/resources/log4j.xml b/dao/src/test/resources/log4j.xml
new file mode 100644
index 000000000..136817f50
--- /dev/null
+++ b/dao/src/test/resources/log4j.xml
@@ -0,0 +1,17 @@
+
+
+
+
+	
+		
+			
+		
+	
+
+	
+		
+		
+	
+
+
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 7b0d80bd8..a4cabcd13 100644
--- a/pom.xml
+++ b/pom.xml
@@ -18,6 +18,7 @@
 		0.7.2.201409121644
 		1.4
 		2.15.3
+		1.2.17
 	
 	
 		abstract-factory
@@ -122,6 +123,11 @@
 				${junit.version}
 				test
 			
+			
+				log4j
+				log4j
+				${log4j.version}
+			
 		
 	
 

From 9c4382700455fb11aaf9893d1d4b870bf60e7522 Mon Sep 17 00:00:00 2001
From: Alan 
Date: Sat, 5 Sep 2015 22:00:27 +0100
Subject: [PATCH 193/687] Removed erroneous semi-colon.

---
 .../src/test/java/com/iluwatar/abstractfactory/AppTest.java     | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
index 78cdf8a44..4d3659245 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
@@ -7,7 +7,7 @@ import org.junit.Test;
 
 public class AppTest {
 
-	private App app = new App();;
+	private App app = new App();
 	private KingdomFactory elfFactory;
 	private KingdomFactory orcFactory;
 	

From 363d2c38456a152ee09858d42e9f3b5644d5b2b0 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Sun, 6 Sep 2015 14:01:29 +0530
Subject: [PATCH 194/687] Work on #74, improved documentation and minor changes

---
 .../java/com/iluwatar/reactor/app/App.java    |  17 +-
 .../com/iluwatar/reactor/app/AppClient.java   | 153 +++++++++++-------
 .../iluwatar/reactor/app/LoggingHandler.java  |  18 +--
 .../reactor/framework/AbstractNioChannel.java |  12 +-
 .../reactor/framework/ChannelHandler.java     |   8 +-
 .../reactor/framework/Dispatcher.java         |   7 +-
 .../reactor/framework/NioDatagramChannel.java |   5 +-
 .../reactor/framework/NioReactor.java         |  25 ++-
 .../framework/NioServerSocketChannel.java     |   8 +-
 .../framework/SameThreadDispatcher.java       |   2 +-
 .../framework/ThreadPoolDispatcher.java       |   6 +-
 11 files changed, 144 insertions(+), 117 deletions(-)

diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index d7b280465..947173494 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -10,8 +10,8 @@ import com.iluwatar.reactor.framework.NioServerSocketChannel;
 import com.iluwatar.reactor.framework.ThreadPoolDispatcher;
 
 /**
- * This application demonstrates Reactor pattern. It represents a Distributed Logging Service
- * where it can listen on multiple TCP or UDP sockets for incoming log requests.
+ * 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
@@ -49,13 +49,10 @@ public class App {
 
 	/**
 	 * App entry.
+	 * @throws IOException 
 	 */
-	public static void main(String[] args) {
-		try {
-			new App().start();
-		} catch (IOException e) {
-			e.printStackTrace();
-		}
+	public static void main(String[] args) throws IOException {
+		new App().start();
 	}
 	
 	/**
@@ -70,12 +67,12 @@ public class App {
 		
 		/*
 		 *  This represents application specific business logic that dispatcher will call
-		 *  on appropriate events. These events are read and write event in our example.
+		 *  on appropriate events. These events are read events in our example.
 		 */
 		LoggingHandler loggingHandler = new LoggingHandler();
 		
 		/*
-		 * Our application binds to multiple I/O channels and uses same logging handler to handle
+		 * Our application binds to multiple channels and uses same logging handler to handle
 		 * incoming log requests.
 		 */
 		reactor
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
index e5a7dd145..033711569 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
@@ -9,24 +9,43 @@ import java.net.DatagramSocket;
 import java.net.InetAddress;
 import java.net.InetSocketAddress;
 import java.net.Socket;
-import java.net.SocketException;
+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.
+ *  
+ * @author npathai
+ */
 public class AppClient {
-	private ExecutorService service = Executors.newFixedThreadPool(3);
-	
-	public static void main(String[] args) {
-		new AppClient().start();
+	private 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();
 	}
 
-	public void start() {
-		service.execute(new LoggingClient("Client 1", 6666));
-		service.execute(new LoggingClient("Client 2", 6667));
-		service.execute(new UDPLoggingClient(6668));
+	/**
+	 * 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()) {
@@ -39,49 +58,49 @@ public class AppClient {
 		}
 	}
 	
-	/*
-	 * A logging client that sends logging requests to logging server
+	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 LoggingClient implements Runnable {
+	static class TCPLoggingClient implements Runnable {
 
 		private int serverPort;
 		private String clientName;
 
-		public LoggingClient(String clientName, int serverPort) {
+		/**
+		 * 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() {
-			Socket socket = null;
-			try {
-				socket = new Socket(InetAddress.getLocalHost(), serverPort);
+			try (Socket socket = new Socket(InetAddress.getLocalHost(), serverPort)) {
 				OutputStream outputStream = socket.getOutputStream();
 				PrintWriter writer = new PrintWriter(outputStream);
-				writeLogs(writer, socket.getInputStream());
+				sendLogRequests(writer, socket.getInputStream());
 			} catch (IOException e) {
 				e.printStackTrace();
 				throw new RuntimeException(e);
-			} finally {
-				if (socket != null) {
-					try {
-						socket.close();
-					} catch (IOException e) {
-						e.printStackTrace();
-					}
-				}
 			}
 		}
 
-		private void writeLogs(PrintWriter writer, InputStream inputStream) throws IOException {
+		private void sendLogRequests(PrintWriter writer, InputStream inputStream) throws IOException {
 			for (int i = 0; i < 4; i++) {
 				writer.println(clientName + " - Log request: " + i);
-				try {
-					Thread.sleep(100);
-				} catch (InterruptedException e) {
-					e.printStackTrace();
-				}
 				writer.flush();
+
 				byte[] data = new byte[1024];
 				int read = inputStream.read(data, 0, data.length);
 				if (read == 0) {
@@ -89,46 +108,56 @@ public class AppClient {
 				} else {
 					System.out.println(new String(data, 0, read));
 				}
+
+				artificialDelayOf(100);
 			}
 		}
-	}
-	
-	static class UDPLoggingClient implements Runnable {
-		private int port;
 
-		public UDPLoggingClient(int port) {
-			this.port = port;
+	}
+
+	/**
+	 * A logging client that sends requests to Reactor on UDP socket.  
+	 */
+	static class UDPLoggingClient implements Runnable {
+		private String clientName;
+		private 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() {
-			DatagramSocket socket = null;
-			try {
-				socket = new DatagramSocket();
+			try (DatagramSocket socket = new DatagramSocket()) {
 				for (int i = 0; i < 4; i++) {
-					String message = "UDP Client" + " - Log request: " + i;
-					try {
-						DatagramPacket packet = new DatagramPacket(message.getBytes(), message.getBytes().length, new InetSocketAddress(InetAddress.getLocalHost(), port));
-						socket.send(packet);
-						
-						byte[] data = new byte[1024];
-						DatagramPacket reply = new DatagramPacket(data, data.length);
-						socket.receive(reply);
-						if (reply.getLength() == 0) {
-							System.out.println("Read zero bytes");
-						} else {
-							System.out.println(new String(reply.getData(), 0, reply.getLength()));
-						}
-					} catch (IOException e) {
-						e.printStackTrace();
+					
+					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) {
+						System.out.println("Read zero bytes");
+					} else {
+						System.out.println(new String(reply.getData(), 0, reply.getLength()));
 					}
+					
+					artificialDelayOf(100);
 				}
-			} catch (SocketException e1) {
+			} catch (IOException e1) {
 				e1.printStackTrace();
-			} finally {
-				if (socket != null) {
-					socket.close();
-				}
 			}
 		}
 	}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
index 6fa95de2d..eed26b078 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
@@ -9,7 +9,7 @@ import com.iluwatar.reactor.framework.NioDatagramChannel.DatagramPacket;
 
 /**
  * Logging server application logic. It logs the incoming requests on standard console and returns
- * a canned acknowledgement back to the remote peer. 
+ * a canned acknowledgement back to the remote peer.
  * 
  * @author npathai
  */
@@ -23,17 +23,15 @@ public class LoggingHandler implements ChannelHandler {
 	@Override
 	public void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key) {
 		/*
-		 * As this channel is attached to both TCP and UDP channels we need to check whether
+		 * 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) {
-			byte[] data = ((ByteBuffer)readObject).array();
-			doLogging(data);
-			sendReply(channel, data, key);
+			doLogging(((ByteBuffer)readObject));
+			sendReply(channel, key);
 		} else if (readObject instanceof DatagramPacket) {
 			DatagramPacket datagram = (DatagramPacket)readObject;
-			byte[] data = datagram.getData().array();
-			doLogging(data);
+			doLogging(datagram.getData());
 			sendReply(channel, datagram, key);
 		} else {
 			throw new IllegalStateException("Unknown data received");
@@ -50,13 +48,13 @@ public class LoggingHandler implements ChannelHandler {
 		channel.write(replyPacket, key);
 	}
 
-	private void sendReply(AbstractNioChannel channel, byte[] data, SelectionKey key) {
+	private void sendReply(AbstractNioChannel channel, SelectionKey key) {
 		ByteBuffer buffer = ByteBuffer.wrap(ACK);
 		channel.write(buffer, key);
 	}
 
-	private void doLogging(byte[] data) {
+	private void doLogging(ByteBuffer data) {
 		// assuming UTF-8 :(
-		System.out.println(new String(data));
+		System.out.println(new String(data.array(), 0, data.limit()));
 	}
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
index a4b18179a..24862644d 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
@@ -55,7 +55,7 @@ public abstract class AbstractNioChannel {
 	}
 
 	/**
-	 * The operation in which the channel is interested, this operation is be provided to {@link Selector}.
+	 * The operation in which the channel is interested, this operation is provided to {@link Selector}.
 	 * 
 	 * @return interested operation.
 	 * @see SelectionKey
@@ -63,15 +63,17 @@ public abstract class AbstractNioChannel {
 	public abstract int getInterestedOps();
 	
 	/**
-	 * Requests the channel to bind.
+	 * 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.
-	 * @param key the key which is readable.
+	 * 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.
 	 */
@@ -106,7 +108,7 @@ public abstract class AbstractNioChannel {
 	/**
 	 * Writes the data to the channel.
 	 * 
-	 * @param pendingWrite data which was queued for writing in batch mode. 
+	 * @param pendingWrite the data to be written on channel.
 	 * @param key the key which is writable.
 	 * @throws IOException if any I/O error occurs.
 	 */
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
index e1df57020..0aae9db75 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
@@ -7,7 +7,7 @@ import java.nio.channels.SelectionKey;
  * to it by the {@link Dispatcher}. This is where the application logic resides.
  * 
  * 
    
- * A {@link ChannelHandler} is associated with one or many {@link AbstractNioChannel}s, and whenever
+ * 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.
  *  
  * @author npathai
@@ -15,11 +15,11 @@ import java.nio.channels.SelectionKey;
 public interface ChannelHandler {
 
 	/**
-	 * Called when the {@code channel} has received some data from remote peer.
+	 * Called when the {@code channel} receives some data from remote peer.
 	 *   
-	 * @param channel the channel from which the data is received.
+	 * @param channel the channel from which the data was received.
 	 * @param readObject the data read.
-	 * @param key the key from which the data is received.
+	 * @param key the key on which read event occurred.
 	 */
 	void handleChannelRead(AbstractNioChannel channel, Object readObject, SelectionKey key);
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
index 120a11085..c563ef9d3 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
@@ -5,7 +5,7 @@ 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 event. This decouples the I/O
+ * 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.
@@ -24,6 +24,9 @@ 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
@@ -32,7 +35,7 @@ public interface Dispatcher {
 	void onChannelReadEvent(AbstractNioChannel channel, Object readObject, SelectionKey key);
 	
 	/**
-	 * Stops the dispatching events and cleans up any acquired resources such as threads.
+	 * Stops dispatching events and cleans up any acquired resources such as threads.
 	 */
 	void stop();
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
index 2666f05b8..f338ce4a3 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -48,12 +48,13 @@ public class NioDatagramChannel extends AbstractNioChannel {
 	@Override
 	public DatagramPacket read(SelectionKey key) throws IOException {
 		ByteBuffer buffer = ByteBuffer.allocate(1024);
-		SocketAddress sender = getChannel().receive(buffer);
+		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);
 		
@@ -91,7 +92,7 @@ public class NioDatagramChannel extends AbstractNioChannel {
 	}
 
 	/**
-	 * Write the outgoing {@link DatagramPacket} to the channel. The intended receiver of the 
+	 * 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
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
index b92f4a9ba..273898ae3 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -22,11 +22,11 @@ import java.util.concurrent.TimeUnit;
  * 
    
  * Implementation:
  * A NIO reactor runs in its own thread when it is started using {@link #start()} method. 
- * {@link NioReactor} uses {@link Selector} as a mechanism for achieving Synchronous Event De-multiplexing.
+ * {@link NioReactor} uses {@link Selector} for realizing Synchronous Event De-multiplexing.
  * 
  * 
    
- * NOTE: This is one of the way to implement NIO reactor and it does not take care of all possible edge cases
- * which may be required in a real application. This implementation is meant to demonstrate the fundamental
+ * 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.
  * 
  * @author npathai
@@ -64,16 +64,13 @@ public class NioReactor {
 	 * @throws IOException if any I/O error occurs.
 	 */
 	public void start() throws IOException {
-		reactorMain.execute(new Runnable() {
-			@Override
-			public void run() {
+		reactorMain.execute(() -> {
 				try {
 					System.out.println("Reactor started, waiting for events...");
 					eventLoop();
 				} catch (IOException e) {
 					e.printStackTrace();
 				}
-			}
 		});
 	}
 	
@@ -92,11 +89,11 @@ public class NioReactor {
 	}
 
 	/**
-	 * Registers a new channel (handle) with this reactor after which the reactor will wait for events
-	 * on this channel. While registering the channel the reactor uses {@link AbstractNioChannel#getInterestedOps()}
+	 * 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 handle on which reactor will wait for events. The channel must be bound
+	 * @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.
@@ -111,7 +108,7 @@ public class NioReactor {
 	private void eventLoop() throws IOException {
 		while (true) {
 			
-			// Honor interrupt request
+			// honor interrupt request
 			if (Thread.interrupted()) {
 				break;
 			}
@@ -189,7 +186,7 @@ public class NioReactor {
 	}
 
 	/*
-	 * Uses the application provided dispatcher to dispatch events to respective handlers.
+	 * 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);
@@ -207,10 +204,10 @@ public class NioReactor {
 	 * 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 are changed when
+	 * 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 are to be changed.
+	 * @param key the key for which operations have to be changed.
 	 * @param interestedOps the new interest operations.
 	 */
 	public void changeOps(SelectionKey key, int interestedOps) {
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index 92fa9234f..ae54af643 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -24,8 +24,8 @@ public class NioServerSocketChannel extends AbstractNioChannel {
 	 * 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 requests.
-	 * @param handler the handler to be used for handling incoming requests on this channel.
+	 * @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 {
@@ -36,7 +36,7 @@ public class NioServerSocketChannel extends AbstractNioChannel {
 	
 	@Override
 	public int getInterestedOps() {
-		// being a server socket channel it is interested in accepting connection from remote clients.
+		// being a server socket channel it is interested in accepting connection from remote peers.
 		return SelectionKey.OP_ACCEPT;
 	}
 
@@ -58,6 +58,7 @@ public class NioServerSocketChannel extends AbstractNioChannel {
 		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");
 		}
@@ -83,7 +84,6 @@ public class NioServerSocketChannel extends AbstractNioChannel {
 	@Override
 	protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException {
 		ByteBuffer pendingBuffer = (ByteBuffer) pendingWrite;
-		System.out.println("Writing on channel");
 		((SocketChannel)key.channel()).write(pendingBuffer);
 	}
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
index 2300d7c74..b5392ac8f 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
@@ -8,7 +8,7 @@ import java.nio.channels.SelectionKey;
  * because the I/O thread performs the application specific processing.
  * 
  * 
    
- * For real applications use {@link ThreadPoolDispatcher}.
+ * For better performance use {@link ThreadPoolDispatcher}.
  * 
  * @see ThreadPoolDispatcher
  * 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
index b514d1824..8624b878e 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
@@ -7,8 +7,8 @@ import java.util.concurrent.TimeUnit;
 
 /**
  * An implementation that uses a pool of worker threads to dispatch the events. This provides
- * for better scalability as the application specific processing is not performed in the context
- * of I/O thread.
+ * better scalability as the application specific processing is not performed in the context
+ * of I/O (reactor) thread.
  * 
  * @author npathai
  *
@@ -46,7 +46,7 @@ public class ThreadPoolDispatcher extends SameThreadDispatcher {
 	public void stop() {
 		executorService.shutdownNow();
 		try {
-			executorService.awaitTermination(1000, TimeUnit.SECONDS);
+			executorService.awaitTermination(4, TimeUnit.SECONDS);
 		} catch (InterruptedException e) {
 			e.printStackTrace();
 		}

From 57ff154e0a9dac01a7a929eee3de0629c261c4ab Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Sun, 6 Sep 2015 14:09:00 +0530
Subject: [PATCH 195/687] Changed version

---
 reactor/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reactor/pom.xml b/reactor/pom.xml
index 0f3271a9c..516a4b93c 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.5.0
+    1.7.0
   
   reactor
   

From 30f60651952056e775dd7194c882e23263df4b9e Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Sun, 6 Sep 2015 14:10:31 +0530
Subject: [PATCH 196/687] Removed todo file

---
 reactor/todo.txt | 13 -------------
 1 file changed, 13 deletions(-)
 delete mode 100644 reactor/todo.txt

diff --git a/reactor/todo.txt b/reactor/todo.txt
deleted file mode 100644
index a59af62b9..000000000
--- a/reactor/todo.txt
+++ /dev/null
@@ -1,13 +0,0 @@
-* Make UDP channel work (connect is required)
-* Cleanup
-* Document - Javadoc
-* Better design?? Get review of @iluwatar
-
-
-Design view:
-
-Handles ---> AbstractNioChannel
-Selector ---> Synchronous Event Demultiplexer
-NioReactor ---> Initiation Dispatcher
-
-

From 9e401b0f34776f6357b2691ed28cf884e3d2e538 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Sun, 6 Sep 2015 14:14:38 +0530
Subject: [PATCH 197/687] Fixed version number

---
 reactor/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reactor/pom.xml b/reactor/pom.xml
index 516a4b93c..599376e32 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.6.0
   
   reactor
   

From 1bef44c4e8aec017a31dc235cf93123b5f476e26 Mon Sep 17 00:00:00 2001
From: Markus 
Date: Sun, 6 Sep 2015 18:54:23 +0200
Subject: [PATCH 198/687] fix #237

- Removed Self-Links and instead used another way of making custom id's
- Removed TOC
- Removed Back to top arrows
- Made FAQ an extra page
---
 README.md | 87 +++++--------------------------------------------------
 faq.md    | 63 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 70 insertions(+), 80 deletions(-)
 create mode 100644 faq.md

diff --git a/README.md b/README.md
index 4715c3b9b..307d6cde8 100644
--- a/README.md
+++ b/README.md
@@ -4,25 +4,12 @@
 
 # Design pattern samples in Java
 
+[![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master)](https://travis-ci.org/iluwatar/java-design-patterns)
+[![Coverage Status](https://coveralls.io/repos/iluwatar/java-design-patterns/badge.svg?branch=master)](https://coveralls.io/r/iluwatar/java-design-patterns?branch=master)
+[![Coverity Scan Build Status](https://scan.coverity.com/projects/5634/badge.svg)](https://scan.coverity.com/projects/5634)
 [![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)
 
-[![Build status](https://travis-ci.org/iluwatar/java-design-patterns.svg?branch=master)](https://travis-ci.org/iluwatar/java-design-patterns) [![Coverage Status](https://coveralls.io/repos/iluwatar/java-design-patterns/badge.svg?branch=master)](https://coveralls.io/r/iluwatar/java-design-patterns?branch=master) 
-  Coverity Scan Build Status
-
-
-
-
-
-# Table of Contents
- - Introduction
- - How to contribute
- - Frequently Asked Questions
- - Credits
- - License
-
-
-# Introduction [↑](#top)
+# Introduction {#intro}
 
 Design patterns are formalized best practices that the programmer can use to
 solve common problems when designing an application or system.
@@ -35,71 +22,11 @@ problems, and it also improves code readability for coders and architects who
 are familiar with the patterns.
 
 
-# How to contribute [↑](#top)
+# How to contribute {#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).
 
-
-# Frequently asked questions [↑](#top)
-
-**Q: What is the difference between State and Strategy patterns?**
-
-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.
-
-**Q: What is the difference between Strategy and Template Method patterns?**
-
-In Template Method the algorithm is chosen at compile time via inheritance.
-With Strategy pattern the algorithm is chosen at runtime via composition.
-
-**Q: What is the difference between Proxy and Decorator patterns?**
-
-The difference is the intent of the patterns. While Proxy controls access to
-the object Decorator is used to add responsibilities to the object.
-
-**Q: What is the difference between Chain of Responsibility and Intercepting Filter patterns?**
-
-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.
-
-**Q: What is the difference between Visitor and Double Dispatch patterns?**
-
-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.
-
-**Q: What are the differences between Flyweight and Object Pool patterns?**
-
-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.
-
-
-# Credits [↑](#top)
+# Credits {#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)
@@ -114,6 +41,6 @@ Flyweight.
 * [Pattern Oriented Software Architecture Vol I-V](http://www.amazon.com/Pattern-Oriented-Software-Architecture-Volume-Patterns/dp/0471958697)
 
 
-# License [↑](#top)
+# License {#license}
 
 This project is licensed under the terms of the MIT license.
diff --git a/faq.md b/faq.md
new file mode 100644
index 000000000..5633a693d
--- /dev/null
+++ b/faq.md
@@ -0,0 +1,63 @@
+---
+layout: page
+title: FAQ
+permalink: /faq/
+icon: fa-question
+page-index: 2
+---
+
+### 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.

From 9eb64bc0e5b1040ed6d2e81fdde51fb918c751b3 Mon Sep 17 00:00:00 2001
From: Markus 
Date: Sun, 6 Sep 2015 19:33:56 +0200
Subject: [PATCH 199/687] Removed the Markdown Plus custom heading id's

Because the renderer of github doesnt support markdown plus...
---
 README.md | 10 ++++------
 1 file changed, 4 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 307d6cde8..a4ec970c9 100644
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@
 [![Coverity Scan Build Status](https://scan.coverity.com/projects/5634/badge.svg)](https://scan.coverity.com/projects/5634)
 [![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)
 
-# Introduction {#intro}
+# Introduction
 
 Design patterns are formalized best practices that the programmer can use to
 solve common problems when designing an application or system.
@@ -21,12 +21,11 @@ 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.
 
-
-# How to contribute {#contribute}
+# 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).
 
-# Credits {#credits}
+# 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)
@@ -40,7 +39,6 @@ If you are willing to contribute to the project you will find the relevant infor
 * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2)
 * [Pattern Oriented Software Architecture Vol I-V](http://www.amazon.com/Pattern-Oriented-Software-Architecture-Volume-Patterns/dp/0471958697)
 
-
-# License {#license}
+# License
 
 This project is licensed under the terms of the MIT license.

From 02162994a30c500518bf2c9e199b2ee80dfc6f2c Mon Sep 17 00:00:00 2001
From: Hannes Pernpeintner 
Date: Mon, 17 Aug 2015 03:54:37 +0200
Subject: [PATCH 200/687] #184 Fluent Interface pattern

---
 fluentinterface/pom.xml                       |  20 ++
 .../com/iluwatar/fluentinterface/App.java     |  90 ++++++++
 .../fluentiterable/FluentIterable.java        | 192 ++++++++++++++++++
 .../com/iluwatar/fluentinterface/AppTest.java |  12 ++
 pom.xml                                       |   3 +-
 5 files changed, 316 insertions(+), 1 deletion(-)
 create mode 100644 fluentinterface/pom.xml
 create mode 100644 fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
 create mode 100644 fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
 create mode 100644 fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java

diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
new file mode 100644
index 000000000..c78c182e3
--- /dev/null
+++ b/fluentinterface/pom.xml
@@ -0,0 +1,20 @@
+
+
+    
+        java-design-patterns
+        com.iluwatar
+        1.5.0
+    
+    4.0.0
+
+    fluentinterface
+    
+        
+            junit
+            junit
+            test
+        
+    
+
\ No newline at end of file
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
new file mode 100644
index 000000000..fded13624
--- /dev/null
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
@@ -0,0 +1,90 @@
+package com.iluwatar.fluentinterface;
+
+import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
+
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+import java.util.StringJoiner;
+import java.util.function.Function;
+import java.util.function.Predicate;
+
+public class App {
+
+    public static void main(String[] args) {
+
+        List integerList = new ArrayList() {{
+            add(1);
+            add(-61);
+            add(14);
+            add(-22);
+            add(18);
+            add(-87);
+            add(6);
+            add(64);
+            add(-82);
+            add(26);
+            add(-98);
+            add(97);
+            add(45);
+            add(23);
+            add(2);
+            add(-68);
+            add(45);
+        }};
+        prettyPrint("The initial list contains: ", integerList);
+
+        List firstFiveNegatives = FluentIterable.from(integerList)
+                .filter(negatives())
+                .first(3)
+                .asList();
+        prettyPrint("The first three negative values are: ", firstFiveNegatives);
+
+
+        List lastTwoPositives = FluentIterable.from(integerList)
+                .filter(positives())
+                .last(2)
+                .asList();
+        prettyPrint("The last two positive values are: ", lastTwoPositives);
+
+        FluentIterable.from(integerList)
+                .filter(number -> number%2 == 0)
+                .first()
+                .ifPresent(evenNumber -> System.out.println(String.format("The first even number is: %d", evenNumber)));
+
+
+        List transformedList = FluentIterable.from(integerList)
+                .filter(negatives())
+                .map(transformToString())
+                .asList();
+        prettyPrint("A string-mapped list of negative numbers contains: ", transformedList);
+
+    }
+
+    private static Function transformToString() {
+        return integer -> "String[" + 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 prefix, String suffix, Iterable iterable) {
+        prettyPrint(", ", prefix, suffix, iterable);
+    }
+
+    private static  void prettyPrint(String delimiter, String prefix, String suffix, Iterable iterable) {
+        StringJoiner joiner = new StringJoiner(delimiter, prefix, ".");
+        Iterator iterator = iterable.iterator();
+        while (iterator.hasNext()) {
+            joiner.add(iterator.next().toString());
+        }
+
+        System.out.println(joiner);
+    }
+}
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
new file mode 100644
index 000000000..edb9275c1
--- /dev/null
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
@@ -0,0 +1,192 @@
+package com.iluwatar.fluentinterface.fluentiterable;
+
+import java.util.*;
+import java.util.function.Consumer;
+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 implementation demonstrates a possible way to implement this functionality, 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 class FluentIterable implements Iterable {
+
+    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 FluentIterable(Iterable iterable) {
+        ArrayList copy = new ArrayList<>();
+        Iterator iterator = iterable.iterator();
+        while (iterator.hasNext()) {
+            copy.add(iterator.next());
+        }
+        this.iterable = copy;
+    }
+
+    /**
+     * Iterates over all elements of this iterator and filters them.
+     * @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
+     */
+    public final FluentIterable filter(Predicate predicate) {
+        Iterator iterator = iterator();
+        while (iterator.hasNext()) {
+            TYPE nextElement = iterator.next();
+            if(!predicate.test(nextElement)) {
+                iterator.remove();
+            }
+        }
+        return this;
+    }
+
+    /**
+     * Uses the Iterable interface's forEach method to apply a given function
+     * for each object of the iterator.
+     * @param action the action for each object
+     * @return the same FluentIterable with an untouched collection
+     */
+    public final FluentIterable forEachDo(Consumer action) {
+        iterable.forEach(action);
+        return this;
+    }
+
+    /**
+     * Can be used to collect objects from the iteration.
+     * @return an option of the first object of the iteration
+     */
+    public final Optional first() {
+        List list = first(1).asList();
+        if(list.isEmpty()) {
+            return Optional.empty();
+        }
+        return Optional.of(list.get(0));
+    }
+
+    /**
+     * 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.
+     */
+    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 iteration.
+     * @return an option of the last object of the iteration
+     */
+    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 iteration.
+     * @param count defines the number of objects to return
+     * @return the same FluentIterable with a collection decimated to a maximum of 'count' last objects
+     */
+    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 NEW_TYPE.
+     * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
+     * @param  the target type of the transformation
+     * @return a new FluentIterable of the new type
+     */
+    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 iteration into a list.
+     * @return a list with all remaining objects of this iteration
+     */
+    public List asList() {
+        return toList(iterable.iterator());
+    }
+
+    /**
+     * @return a FluentIterable from a given iterable. Calls the FluentIterable constructor.
+     */
+    public static final  FluentIterable from(Iterable iterable) {
+        return new FluentIterable<>(iterable);
+    }
+
+    @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 in the current iteration
+     */
+    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 iterators iteration into an 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;
+    }
+}
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
new file mode 100644
index 000000000..32bbca430
--- /dev/null
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
@@ -0,0 +1,12 @@
+package com.iluwatar.fluentinterface;
+
+import org.junit.Test;
+
+public class AppTest {
+
+	@Test
+	public void test() {
+		String[] args = {};
+		App.main(args);
+	}
+}
diff --git a/pom.xml b/pom.xml
index 7b0d80bd8..2c040005b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -77,7 +77,8 @@
 		step-builder
 		layers
 		message-channel
-  
+		fluentinterface
+	
 
 	
 		

From ded21b70acdbfa746343a0ebd6e5d33c5bf37dfb Mon Sep 17 00:00:00 2001
From: Hannes Pernpeintner 
Date: Sat, 22 Aug 2015 20:22:00 +0200
Subject: [PATCH 201/687] #184 Fluent interface pattern, lazy fluentiterable
 added

---
 .../com/iluwatar/fluentinterface/App.java     |  34 ++-
 .../fluentiterable/FluentIterable.java        | 175 +++----------
 .../lazy/DecoratingIterator.java              |  53 ++++
 .../lazy/LazyFluentIterable.java              | 236 ++++++++++++++++++
 .../simple/SimpleFluentIterable.java          | 194 ++++++++++++++
 5 files changed, 539 insertions(+), 153 deletions(-)
 create mode 100644 fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
 create mode 100644 fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
 create mode 100644 fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java

diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
index fded13624..96a2db323 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
@@ -1,14 +1,14 @@
 package com.iluwatar.fluentinterface;
 
-import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
+import com.iluwatar.fluentinterface.fluentiterable.lazy.LazyFluentIterable;
+import com.iluwatar.fluentinterface.fluentiterable.simple.SimpleFluentIterable;
 
-import java.util.ArrayList;
-import java.util.Iterator;
-import java.util.List;
-import java.util.StringJoiner;
+import java.util.*;
 import java.util.function.Function;
 import java.util.function.Predicate;
 
+import static java.lang.String.valueOf;
+
 public class App {
 
     public static void main(String[] args) {
@@ -34,35 +34,49 @@ public class App {
         }};
         prettyPrint("The initial list contains: ", integerList);
 
-        List firstFiveNegatives = FluentIterable.from(integerList)
+        List firstFiveNegatives = SimpleFluentIterable.from(integerList)
                 .filter(negatives())
                 .first(3)
                 .asList();
         prettyPrint("The first three negative values are: ", firstFiveNegatives);
 
 
-        List lastTwoPositives = FluentIterable.from(integerList)
+        List lastTwoPositives = SimpleFluentIterable.from(integerList)
                 .filter(positives())
                 .last(2)
                 .asList();
         prettyPrint("The last two positive values are: ", lastTwoPositives);
 
-        FluentIterable.from(integerList)
+        SimpleFluentIterable.from(integerList)
                 .filter(number -> number%2 == 0)
                 .first()
                 .ifPresent(evenNumber -> System.out.println(String.format("The first even number is: %d", evenNumber)));
 
 
-        List transformedList = FluentIterable.from(integerList)
+        List transformedList = SimpleFluentIterable.from(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[" + 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 -> System.out.println(String.format("The last of the first two negatives is: %d", lastOfFirstTwo)));
     }
 
     private static Function transformToString() {
-        return integer -> "String[" + String.valueOf(integer) + "]";
+        return integer -> "String[" + valueOf(integer) + "]";
     }
     private static Predicate negatives() {
         return integer -> (integer < 0);
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
index edb9275c1..7bdaf274c 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
@@ -1,6 +1,9 @@
 package com.iluwatar.fluentinterface.fluentiterable;
 
-import java.util.*;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Optional;
 import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.function.Predicate;
@@ -8,116 +11,49 @@ 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 implementation demonstrates a possible way to implement this functionality, but
+ * 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 class FluentIterable implements Iterable {
-
-    private final Iterable iterable;
+public interface FluentIterable extends Iterable {
 
     /**
-     * This constructor creates a copy of a given iterable's contents.
-     * @param iterable the iterable this interface copies to work on.
-     */
-    protected FluentIterable(Iterable iterable) {
-        ArrayList copy = new ArrayList<>();
-        Iterator iterator = iterable.iterator();
-        while (iterator.hasNext()) {
-            copy.add(iterator.next());
-        }
-        this.iterable = copy;
-    }
-
-    /**
-     * Iterates over all elements of this iterator and filters them.
+     * Filters the iteration with the given 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
+     * @return a filtered FluentIterable
      */
-    public final FluentIterable filter(Predicate predicate) {
-        Iterator iterator = iterator();
-        while (iterator.hasNext()) {
-            TYPE nextElement = iterator.next();
-            if(!predicate.test(nextElement)) {
-                iterator.remove();
-            }
-        }
-        return this;
-    }
+    FluentIterable filter(Predicate predicate);
 
     /**
      * Uses the Iterable interface's forEach method to apply a given function
-     * for each object of the iterator.
-     * @param action the action for each object
-     * @return the same FluentIterable with an untouched collection
+     * for each object of the iterator. This is a terminating operation.
      */
-    public final FluentIterable forEachDo(Consumer action) {
-        iterable.forEach(action);
-        return this;
-    }
+    void forEachDo(Consumer action);
 
     /**
-     * Can be used to collect objects from the iteration.
-     * @return an option of the first object of the iteration
+     * Evaluates the iteration and returns the first element. This is a terminating operation.
+     * @return the first element after the iteration is evaluated
      */
-    public final Optional first() {
-        List list = first(1).asList();
-        if(list.isEmpty()) {
-            return Optional.empty();
-        }
-        return Optional.of(list.get(0));
-    }
+    Optional first();
 
     /**
-     * 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.
+     * Evaluates the iteration and leaves only the count first elements.
+     * @return the first count elements as an Iterable
      */
-    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;
-    }
+    FluentIterable first(int count);
 
     /**
-     * Can be used to collect objects from the iteration.
-     * @return an option of the last object of the iteration
+     * Evaluates the iteration and returns the last element. This is a terminating operation.
+     * @return the last element after the iteration is evaluated
      */
-    public final Optional last() {
-        List list = last(1).asList();
-        if(list.isEmpty()) {
-            return Optional.empty();
-        }
-        return Optional.of(list.get(0));
-    }
+    Optional last();
 
     /**
-     * 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' last objects
+     * Evaluates the iteration and leaves only the count last elements.
+     * @return the last counts elements as an Iterable
      */
-    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;
-    }
+    FluentIterable last(int count);
 
     /**
      * Transforms this FluentIterable into a new one containing objects of the type NEW_TYPE.
@@ -125,65 +61,18 @@ public class FluentIterable implements Iterable {
      * @param  the target type of the transformation
      * @return a new FluentIterable of the new type
      */
-    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);
-    }
+     FluentIterable map(Function function);
+    List asList();
 
     /**
-     * Collects all remaining objects of this iteration into a list.
-     * @return a list with all remaining objects of this iteration
+     * 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
      */
-    public List asList() {
-        return toList(iterable.iterator());
-    }
-
-    /**
-     * @return a FluentIterable from a given iterable. Calls the FluentIterable constructor.
-     */
-    public static final  FluentIterable from(Iterable iterable) {
-        return new FluentIterable<>(iterable);
-    }
-
-    @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 in the current iteration
-     */
-    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 iterators iteration into an List.
-     * @return a new List with the remaining objects.
-     */
-    public static  List toList(Iterator iterator) {
-        List copy = new ArrayList<>();
+    static  List copyToList(Iterable iterable) {
+        ArrayList copy = new ArrayList<>();
+        Iterator iterator = iterable.iterator();
         while (iterator.hasNext()) {
             copy.add(iterator.next());
         }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
new file mode 100644
index 000000000..0e5b410cc
--- /dev/null
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
@@ -0,0 +1,53 @@
+package com.iluwatar.fluentinterface.fluentiterable.lazy;
+
+import java.util.Iterator;
+
+/**
+ * This class is used to realize LazyFluentIterables. It decorates
+ * a given iterator.
+ * @param 
+ */
+public abstract class DecoratingIterator implements Iterator {
+
+    protected final Iterator fromIterator;
+
+    private TYPE next = null;
+
+    /**
+     * Creates an iterator that decorates the given iterator.
+     * @param fromIterator
+     */
+    public DecoratingIterator(Iterator fromIterator) {
+        this.fromIterator = fromIterator;
+    }
+
+    /**
+     * Precomputes and caches the next element of the iteration.
+     * @return true if a next element is available
+     */
+    @Override
+    public final boolean hasNext() {
+        next = computeNext();
+        return next != null;
+    }
+
+    /**
+     * Returns the next element of the iteration. This implementation caches it.
+     * If no next element is cached, it is computed.
+     * @return the next element obf the iteration
+     */
+    @Override
+    public final TYPE next() {
+        TYPE result = next;
+        next = null;
+        result = (result == null ? fromIterator.next() : result);
+        return result;
+    }
+
+    /**
+     * Computes the next object of the iteration. Can be implemented to
+     * realize custom behaviour for an iteration process.
+     * @return
+     */
+    public abstract TYPE computeNext();
+}
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
new file mode 100644
index 000000000..c6db4d2cd
--- /dev/null
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -0,0 +1,236 @@
+package com.iluwatar.fluentinterface.fluentiterable.lazy;
+
+import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
+
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+import java.util.Optional;
+import java.util.function.Consumer;
+import java.util.function.Function;
+import java.util.function.Predicate;
+
+/**
+ * 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;
+    }
+
+    /**
+     * Adds a filter operation to the operation chain and returns a new iterable.
+     * @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 TYPE computeNext() {
+                        while(true) {
+                            if(fromIterator.hasNext()) {
+                                TYPE candidate = fromIterator.next();
+                                if(!predicate.test(candidate)) {
+                                    continue;
+                                }
+                                return candidate;
+                            }
+
+                            return null;
+                        }
+                    }
+                };
+            }
+        };
+    }
+
+    /**
+     * Uses the Iterable interface's forEach method to apply a given function
+     * for each object of the iterator. Is a terminating operation.
+     * @param action the action for each object
+     */
+    @Override
+    public void forEachDo(Consumer action) {
+        Iterator newIterator = iterable.iterator();
+        while(newIterator.hasNext()) {
+            action.accept(newIterator.next());
+        }
+    }
+
+    /**
+     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * @return an option of the first object of the iteration
+     */
+    @Override
+    public Optional first() {
+        Optional result = Optional.empty();
+        List list = first(1).asList();
+        if(!list.isEmpty()) {
+            result = Optional.of(list.get(0));
+        }
+
+        return result;
+    }
+
+    /**
+     * Can be used to collect objects from the iteration. 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 FluentIterable first(int count) {
+        return new LazyFluentIterable() {
+            @Override
+            public Iterator iterator() {
+                return new DecoratingIterator(iterable.iterator()) {
+                    int currentIndex = 0;
+
+                    @Override
+                    public TYPE computeNext() {
+                        if(currentIndex < count) {
+                            if(fromIterator.hasNext()) {
+                                TYPE candidate = fromIterator.next();
+                                currentIndex++;
+                                return candidate;
+                            }
+                        }
+                        return null;
+                    }
+                };
+            }
+        };
+    }
+
+    /**
+     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * @return an option of the last object of the iteration
+     */
+    @Override
+    public Optional last() {
+        Optional result = Optional.empty();
+        List list = last(1).asList();
+        if(!list.isEmpty()) {
+            result = Optional.of(list.get(0));
+        }
+
+        return result;
+    }
+
+    /**
+     * Can be used to collect objects from the iteration. 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 FluentIterable last(int count) {return new LazyFluentIterable() {
+        @Override
+        public Iterator iterator() {
+            return new DecoratingIterator(iterable.iterator()) {
+                int currentIndex = 0;
+
+                @Override
+                public TYPE computeNext() {
+                    List list = new ArrayList<>();
+
+                    Iterator newIterator = iterable.iterator();
+                    while(newIterator.hasNext()) {
+                        list.add(newIterator.next());
+                    }
+
+                    int totalElementsCount = list.size();
+                    int stopIndex = totalElementsCount - count;
+
+                    TYPE candidate = null;
+                    while(currentIndex < stopIndex && fromIterator.hasNext()) {
+                        currentIndex++;
+                        fromIterator.next();
+                    }
+                    if(currentIndex >= stopIndex && fromIterator.hasNext()) {
+                        candidate = fromIterator.next();
+                    }
+                    return candidate;
+                }
+            };
+        }
+    };
+    }
+
+    /**
+     * Transforms this FluentIterable into a new one containing objects of the type NEW_TYPE.
+     * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
+     * @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 NEW_TYPE computeNext() {
+                        while(true) {
+                            if(oldTypeIterator.hasNext()) {
+                                TYPE candidate = oldTypeIterator.next();
+                                return function.apply(candidate);
+                            }
+                            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() {
+        List copy = FluentIterable.copyToList(iterable);
+        return copy;
+    }
+
+    @Override
+    public Iterator iterator() {
+        return new DecoratingIterator(iterable.iterator()) {
+            @Override
+            public TYPE computeNext() {
+                return fromIterator.next();
+            }
+        };
+    }
+
+    /**
+     * @return a FluentIterable from a given iterable. Calls the LazyFluentIterable constructor.
+     */
+    public static final  FluentIterable from(Iterable iterable) {
+        return new LazyFluentIterable<>(iterable);
+    }
+
+}
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
new file mode 100644
index 000000000..efaa87bbb
--- /dev/null
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -0,0 +1,194 @@
+package com.iluwatar.fluentinterface.fluentiterable.simple;
+
+import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
+
+import java.util.*;
+import java.util.function.Consumer;
+import java.util.function.Function;
+import java.util.function.Predicate;
+
+/**
+ * This is a simple implementation of the FluentIterable interface. It evaluates
+ * all chained operations eagerly.
+ * @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) {
+        List copy = FluentIterable.copyToList(iterable);
+        this.iterable = copy;
+    }
+
+    /**
+     * Iterates over all elements of this iterator and filters them.
+     * @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()) {
+            TYPE nextElement = iterator.next();
+            if(!predicate.test(nextElement)) {
+                iterator.remove();
+            }
+        }
+        return this;
+    }
+
+    /**
+     * Uses the Iterable interface's forEach method to apply a given function
+     * for each object of the iterator. Is a terminating operation.
+     * @param action the action for each object
+     */
+    @Override
+    public void forEachDo(Consumer action) {
+        iterable.forEach(action);
+    }
+
+    /**
+     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * @return an option of the first object of the iteration
+     */
+    @Override
+    public final Optional first() {
+        List list = first(1).asList();
+        if(list.isEmpty()) {
+            return Optional.empty();
+        }
+        return Optional.of(list.get(0));
+    }
+
+    /**
+     * Can be used to collect objects from the iteration. 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 iteration. Is a terminating operation.
+     * @return an option of the last object of the iteration
+     */
+    @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 iteration. 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 NEW_TYPE.
+     * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
+     * @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 iteration into a list.
+     * @return a list with all remaining objects of this iteration
+     */
+    @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);
+    }
+
+    @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 in the current iteration
+     */
+    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 iterators iteration into an 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;
+    }
+}

From a90fcc23916c8768087135e68d8499053b41e860 Mon Sep 17 00:00:00 2001
From: Hannes Pernpeintner 
Date: Wed, 2 Sep 2015 17:21:20 +0200
Subject: [PATCH 202/687] #184 Fluent interface pattern, documentation changed,
 collecting operations optimized

---
 .../fluentiterable/FluentIterable.java        | 17 +++--
 .../lazy/DecoratingIterator.java              | 24 ++++---
 .../lazy/LazyFluentIterable.java              | 69 ++++++-------------
 .../simple/SimpleFluentIterable.java          | 39 ++++-------
 4 files changed, 56 insertions(+), 93 deletions(-)

diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
index 7bdaf274c..919cf5664 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
@@ -4,7 +4,6 @@ import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Optional;
-import java.util.function.Consumer;
 import java.util.function.Function;
 import java.util.function.Predicate;
 
@@ -18,7 +17,7 @@ import java.util.function.Predicate;
 public interface FluentIterable extends Iterable {
 
     /**
-     * Filters the iteration with the given predicate.
+     * 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
@@ -26,13 +25,8 @@ public interface FluentIterable extends Iterable {
     FluentIterable filter(Predicate predicate);
 
     /**
-     * Uses the Iterable interface's forEach method to apply a given function
-     * for each object of the iterator. This is a terminating operation.
-     */
-    void forEachDo(Consumer action);
-
-    /**
-     * Evaluates the iteration and returns the first element. This is a terminating operation.
+     * 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();
@@ -62,6 +56,11 @@ public interface FluentIterable extends Iterable {
      * @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();
 
     /**
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
index 0e5b410cc..35c4cc0ae 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
@@ -22,7 +22,7 @@ public abstract class DecoratingIterator implements Iterator {
     }
 
     /**
-     * Precomputes and caches the next element of the iteration.
+     * 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
@@ -32,22 +32,24 @@ public abstract class DecoratingIterator implements Iterator {
     }
 
     /**
-     * Returns the next element of the iteration. This implementation caches it.
-     * If no next element is cached, it is computed.
-     * @return the next element obf the iteration
+     * Returns the next element of the Iterable.
+     * @return the next element of the Iterable, or null if not present.
      */
     @Override
     public final TYPE next() {
-        TYPE result = next;
-        next = null;
-        result = (result == null ? fromIterator.next() : result);
-        return result;
+        if (next == null) {
+            return fromIterator.next();
+        } else {
+            final TYPE result = next;
+            next = null;
+            return result;
+        }
     }
 
     /**
-     * Computes the next object of the iteration. Can be implemented to
-     * realize custom behaviour for an iteration process.
-     * @return
+     * 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 TYPE computeNext();
 }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index c6db4d2cd..27bca1bf6 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -37,7 +37,7 @@ public class LazyFluentIterable implements FluentIterable {
     }
 
     /**
-     * Adds a filter operation to the operation chain and returns a new 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 new FluentIterable object that decorates the source iterable
@@ -50,53 +50,33 @@ public class LazyFluentIterable implements FluentIterable {
                 return new DecoratingIterator(iterable.iterator()) {
                     @Override
                     public TYPE computeNext() {
-                        while(true) {
-                            if(fromIterator.hasNext()) {
-                                TYPE candidate = fromIterator.next();
-                                if(!predicate.test(candidate)) {
-                                    continue;
-                                }
-                                return candidate;
+                        while(fromIterator.hasNext()) {
+                            TYPE candidate = fromIterator.next();
+                            if(!predicate.test(candidate)) {
+                                continue;
                             }
-
-                            return null;
+                            return candidate;
                         }
+
+                        return null;
                     }
                 };
             }
         };
     }
 
-    /**
-     * Uses the Iterable interface's forEach method to apply a given function
-     * for each object of the iterator. Is a terminating operation.
-     * @param action the action for each object
-     */
-    @Override
-    public void forEachDo(Consumer action) {
-        Iterator newIterator = iterable.iterator();
-        while(newIterator.hasNext()) {
-            action.accept(newIterator.next());
-        }
-    }
-
     /**
      * Can be used to collect objects from the iteration. Is a terminating operation.
-     * @return an option of the first object of the iteration
+     * @return an Optional containing the first object of this Iterable
      */
     @Override
     public Optional first() {
-        Optional result = Optional.empty();
-        List list = first(1).asList();
-        if(!list.isEmpty()) {
-            result = Optional.of(list.get(0));
-        }
-
-        return result;
+        Iterator resultIterator = first(1).iterator();
+        return resultIterator.hasNext() ? Optional.of(resultIterator.next()) : Optional.empty();
     }
 
     /**
-     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * 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.
      */
@@ -126,21 +106,18 @@ public class LazyFluentIterable implements FluentIterable {
 
     /**
      * Can be used to collect objects from the iteration. Is a terminating operation.
-     * @return an option of the last object of the iteration
+     * @return an Optional containing the last object of this Iterable
      */
     @Override
     public Optional last() {
-        Optional result = Optional.empty();
-        List list = last(1).asList();
-        if(!list.isEmpty()) {
-            result = Optional.of(list.get(0));
-        }
-
-        return result;
+        Iterator resultIterator = last(1).iterator();
+        return resultIterator.hasNext() ? Optional.of(resultIterator.next()) : Optional.empty();
     }
 
     /**
-     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * 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
      */
@@ -193,13 +170,11 @@ public class LazyFluentIterable implements FluentIterable {
                     Iterator oldTypeIterator = iterable.iterator();
                     @Override
                     public NEW_TYPE computeNext() {
-                        while(true) {
-                            if(oldTypeIterator.hasNext()) {
-                                TYPE candidate = oldTypeIterator.next();
-                                return function.apply(candidate);
-                            }
-                            return null;
+                        while(oldTypeIterator.hasNext()) {
+                            TYPE candidate = oldTypeIterator.next();
+                            return function.apply(candidate);
                         }
+                        return null;
                     }
                 };
             }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
index efaa87bbb..a4bf77218 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -26,7 +26,7 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * Iterates over all elements of this iterator and filters them.
+     * 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
@@ -44,30 +44,17 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * Uses the Iterable interface's forEach method to apply a given function
-     * for each object of the iterator. Is a terminating operation.
-     * @param action the action for each object
-     */
-    @Override
-    public void forEachDo(Consumer action) {
-        iterable.forEach(action);
-    }
-
-    /**
-     * Can be used to collect objects from the iteration. Is a terminating operation.
-     * @return an option of the first object of the iteration
+     * 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() {
-        List list = first(1).asList();
-        if(list.isEmpty()) {
-            return Optional.empty();
-        }
-        return Optional.of(list.get(0));
+        Iterator resultIterator = first(1).iterator();
+        return resultIterator.hasNext() ? Optional.of(resultIterator.next()) : Optional.empty();
     }
 
     /**
-     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * 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.
      */
@@ -86,8 +73,8 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * Can be used to collect objects from the iteration. Is a terminating operation.
-     * @return an option of the last object of the iteration
+     * 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() {
@@ -99,7 +86,7 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * Can be used to collect objects from the iteration. Is a terminating operation.
+     * 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
      */
@@ -136,8 +123,8 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * Collects all remaining objects of this iteration into a list.
-     * @return a list with all remaining objects of this iteration
+     * Collects all remaining objects of this Iterable into a list.
+     * @return a list with all remaining objects of this Iterable
      */
     @Override
     public List asList() {
@@ -168,7 +155,7 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * @return the count of remaining objects in the current iteration
+     * @return the count of remaining objects of the current Iterable
      */
     public final int getRemainingElementsCount() {
         int counter = 0;
@@ -181,7 +168,7 @@ public class SimpleFluentIterable implements FluentIterable {
     }
 
     /**
-     * Collects the remaining objects of the given iterators iteration into an List.
+     * 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) {

From ee47ae021aed75b1c467e31f75729224c02f943b Mon Sep 17 00:00:00 2001
From: Hannes Pernpeintner 
Date: Thu, 3 Sep 2015 18:49:52 +0200
Subject: [PATCH 203/687] #184 Fluent interface pattern, added cached
 initialization to anonymous iterator for lazy fluentiterable, small
 documentation changes

---
 .../lazy/DecoratingIterator.java              |  2 +-
 .../lazy/LazyFluentIterable.java              | 28 ++++++++++++-------
 .../simple/SimpleFluentIterable.java          |  1 +
 3 files changed, 20 insertions(+), 11 deletions(-)

diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
index 35c4cc0ae..3c1230bce 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
@@ -4,7 +4,7 @@ import java.util.Iterator;
 
 /**
  * This class is used to realize LazyFluentIterables. It decorates
- * a given iterator.
+ * a given iterator. Does not support consecutive hasNext() calls.
  * @param 
  */
 public abstract class DecoratingIterator implements Iterator {
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index 27bca1bf6..998bbd659 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -126,19 +126,14 @@ public class LazyFluentIterable implements FluentIterable {
         @Override
         public Iterator iterator() {
             return new DecoratingIterator(iterable.iterator()) {
-                int currentIndex = 0;
+                public int stopIndex;
+                public int totalElementsCount;
+                private List list;
+                private int currentIndex = 0;
 
                 @Override
                 public TYPE computeNext() {
-                    List list = new ArrayList<>();
-
-                    Iterator newIterator = iterable.iterator();
-                    while(newIterator.hasNext()) {
-                        list.add(newIterator.next());
-                    }
-
-                    int totalElementsCount = list.size();
-                    int stopIndex = totalElementsCount - count;
+                    initialize();
 
                     TYPE candidate = null;
                     while(currentIndex < stopIndex && fromIterator.hasNext()) {
@@ -150,6 +145,19 @@ public class LazyFluentIterable implements FluentIterable {
                     }
                     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;
+                    }
+                }
             };
         }
     };
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
index a4bf77218..0736387e5 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -10,6 +10,7 @@ import java.util.function.Predicate;
 /**
  * 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 {

From 7a1c2ee41310b5974589428d975401380e085322 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Tue, 8 Sep 2015 12:49:54 +0530
Subject: [PATCH 204/687] Work on #208, added getting started section in README
 and linked it to programming priciples site

---
 README.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/README.md b/README.md
index a4ec970c9..38936193c 100644
--- a/README.md
+++ b/README.md
@@ -21,6 +21,11 @@ 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](http://webpro.github.io/programming-principles/).
+
 # 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).

From fb13ddc5d6ca34975c5c0bf474987e6b1c19c34a Mon Sep 17 00:00:00 2001
From: Hannes Pernpeintner 
Date: Mon, 7 Sep 2015 13:25:26 +0200
Subject: [PATCH 205/687] #184 Fluent interface pattern, added uml, adjusted
 style, added pattern description

---
 faq.md                                        |   4 +
 fluentinterface/etc/fluentinterface.png       | Bin 0 -> 59199 bytes
 fluentinterface/etc/fluentinterface.ucls      | 100 +++++
 fluentinterface/index.md                      |  28 ++
 fluentinterface/pom.xml                       |   2 +-
 .../com/iluwatar/fluentinterface/App.java     | 174 ++++----
 .../fluentiterable/FluentIterable.java        | 123 +++---
 .../lazy/DecoratingIterator.java              |  87 ++--
 .../lazy/LazyFluentIterable.java              | 400 +++++++++---------
 .../simple/SimpleFluentIterable.java          | 334 ++++++++-------
 .../com/iluwatar/fluentinterface/AppTest.java |  10 +-
 11 files changed, 727 insertions(+), 535 deletions(-)
 create mode 100644 fluentinterface/etc/fluentinterface.png
 create mode 100644 fluentinterface/etc/fluentinterface.ucls
 create mode 100644 fluentinterface/index.md

diff --git a/faq.md b/faq.md
index 5633a693d..b98bc7589 100644
--- a/faq.md
+++ b/faq.md
@@ -61,3 +61,7 @@ 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. 
\ No newline at end of file
diff --git a/fluentinterface/etc/fluentinterface.png b/fluentinterface/etc/fluentinterface.png
new file mode 100644
index 0000000000000000000000000000000000000000..4a79ce0b7f69395cb81822042ae9c85f90da5e17
GIT binary patch
literal 59199
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

literal 0
HcmV?d00001

diff --git a/fluentinterface/etc/fluentinterface.ucls b/fluentinterface/etc/fluentinterface.ucls
new file mode 100644
index 000000000..3277148cd
--- /dev/null
+++ b/fluentinterface/etc/fluentinterface.ucls
@@ -0,0 +1,100 @@
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/fluentinterface/index.md b/fluentinterface/index.md
new file mode 100644
index 000000000..942867933
--- /dev/null
+++ b/fluentinterface/index.md
@@ -0,0 +1,28 @@
+---
+layout: pattern
+title: Fluent Interface
+folder: fluentinterface
+permalink: /patterns/fluentinterface/
+categories: Architectural
+tags: Java
+---
+
+**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.
+
+![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/)
+
+**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/)
\ No newline at end of file
diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
index c78c182e3..be8ab8039 100644
--- a/fluentinterface/pom.xml
+++ b/fluentinterface/pom.xml
@@ -5,7 +5,7 @@
     
         java-design-patterns
         com.iluwatar
-        1.5.0
+        1.6.0
     
     4.0.0
 
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
index 96a2db323..b9e5909f1 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
@@ -1,5 +1,6 @@
 package com.iluwatar.fluentinterface;
 
+import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
 import com.iluwatar.fluentinterface.fluentiterable.lazy.LazyFluentIterable;
 import com.iluwatar.fluentinterface.fluentiterable.simple.SimpleFluentIterable;
 
@@ -9,96 +10,113 @@ import java.util.function.Predicate;
 
 import static java.lang.String.valueOf;
 
+/**
+ * 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
+ * SimpleFluentIterable evaluates eagerly and would be too costly for real world applications. The
+ * 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 {
 
-    public static void main(String[] args) {
+  public static void main(String[] args) {
 
-        List integerList = new ArrayList() {{
-            add(1);
-            add(-61);
-            add(14);
-            add(-22);
-            add(18);
-            add(-87);
-            add(6);
-            add(64);
-            add(-82);
-            add(26);
-            add(-98);
-            add(97);
-            add(45);
-            add(23);
-            add(2);
-            add(-68);
-            add(45);
-        }};
-        prettyPrint("The initial list contains: ", integerList);
+    List integerList = new ArrayList() {
+      {
+        add(1);
+        add(-61);
+        add(14);
+        add(-22);
+        add(18);
+        add(-87);
+        add(6);
+        add(64);
+        add(-82);
+        add(26);
+        add(-98);
+        add(97);
+        add(45);
+        add(23);
+        add(2);
+        add(-68);
+        add(45);
+      }
+    };
+    prettyPrint("The initial list contains: ", integerList);
 
-        List firstFiveNegatives = SimpleFluentIterable.from(integerList)
-                .filter(negatives())
-                .first(3)
-                .asList();
-        prettyPrint("The first three negative values are: ", firstFiveNegatives);
+    List firstFiveNegatives =
+        SimpleFluentIterable.fromCopyOf(integerList).filter(negatives()).first(3).asList();
+    prettyPrint("The first three negative values are: ", firstFiveNegatives);
 
 
-        List lastTwoPositives = SimpleFluentIterable.from(integerList)
-                .filter(positives())
-                .last(2)
-                .asList();
-        prettyPrint("The last two positive values are: ", lastTwoPositives);
+    List lastTwoPositives =
+        SimpleFluentIterable.fromCopyOf(integerList).filter(positives()).last(2).asList();
+    prettyPrint("The last two positive values are: ", lastTwoPositives);
 
-        SimpleFluentIterable.from(integerList)
-                .filter(number -> number%2 == 0)
-                .first()
-                .ifPresent(evenNumber -> System.out.println(String.format("The first even number is: %d", evenNumber)));
+    SimpleFluentIterable
+        .fromCopyOf(integerList)
+        .filter(number -> number % 2 == 0)
+        .first()
+        .ifPresent(
+            evenNumber -> System.out.println(String.format("The first even number is: %d",
+                evenNumber)));
 
 
-        List transformedList = SimpleFluentIterable.from(integerList)
-                .filter(negatives())
-                .map(transformToString())
-                .asList();
-        prettyPrint("A string-mapped list of negative numbers contains: ", transformedList);
+    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[" + String.valueOf(number) + "]")
-                .asList();
-        prettyPrint("The lazy list contains the last two of the first four positive numbers mapped to Strings: ", lastTwoOfFirstFourStringMapped);
+    List lastTwoOfFirstFourStringMapped =
+        LazyFluentIterable.from(integerList).filter(positives()).first(4).last(2)
+            .map(number -> "String[" + 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 -> System.out.println(String.format("The last of the first two negatives is: %d", lastOfFirstTwo)));
+    LazyFluentIterable
+        .from(integerList)
+        .filter(negatives())
+        .first(2)
+        .last()
+        .ifPresent(
+            lastOfFirstTwo -> System.out.println(String.format(
+                "The last of the first two negatives is: %d", 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 prefix, String suffix, Iterable iterable) {
+    prettyPrint(", ", prefix, suffix, iterable);
+  }
+
+  private static  void prettyPrint(String delimiter, String prefix, String suffix,
+      Iterable iterable) {
+    StringJoiner joiner = new StringJoiner(delimiter, prefix, ".");
+    Iterator iterator = iterable.iterator();
+    while (iterator.hasNext()) {
+      joiner.add(iterator.next().toString());
     }
 
-    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 prefix, String suffix, Iterable iterable) {
-        prettyPrint(", ", prefix, suffix, iterable);
-    }
-
-    private static  void prettyPrint(String delimiter, String prefix, String suffix, Iterable iterable) {
-        StringJoiner joiner = new StringJoiner(delimiter, prefix, ".");
-        Iterator iterator = iterable.iterator();
-        while (iterator.hasNext()) {
-            joiner.add(iterator.next().toString());
-        }
-
-        System.out.println(joiner);
-    }
+    System.out.println(joiner);
+  }
 }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
index 919cf5664..5c4df0391 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/FluentIterable.java
@@ -8,73 +8,82 @@ 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.
+ * 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);
+  /**
+   * 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();
+  /**
+   * 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 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 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);
+  /**
+   * 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 NEW_TYPE.
-     * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
-     * @param  the target type of the transformation
-     * @return a new FluentIterable of the new type
-     */
-     FluentIterable map(Function function);
+  /**
+   * Transforms this FluentIterable into a new one containing objects of the type NEW_TYPE.
+   * 
+   * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
+   * @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();
+  /**
+   * 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) {
-        ArrayList copy = new ArrayList<>();
-        Iterator iterator = iterable.iterator();
-        while (iterator.hasNext()) {
-            copy.add(iterator.next());
-        }
-        return copy;
+  /**
+   * 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) {
+    ArrayList copy = new ArrayList<>();
+    Iterator iterator = iterable.iterator();
+    while (iterator.hasNext()) {
+      copy.add(iterator.next());
     }
+    return copy;
+  }
 }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
index 3c1230bce..e80356d8e 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/DecoratingIterator.java
@@ -3,53 +3,58 @@ 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.
+ * This class is used to realize LazyFluentIterables. It decorates a given iterator. Does not
+ * support consecutive hasNext() calls.
+ * 
  * @param 
  */
 public abstract class DecoratingIterator implements Iterator {
 
-    protected final Iterator fromIterator;
+  protected final Iterator fromIterator;
 
-    private TYPE next = null;
+  private TYPE next = null;
 
-    /**
-     * Creates an iterator that decorates the given iterator.
-     * @param fromIterator
-     */
-    public DecoratingIterator(Iterator fromIterator) {
-        this.fromIterator = fromIterator;
+  /**
+   * Creates an iterator that decorates the given iterator.
+   * 
+   * @param fromIterator
+   */
+  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 TYPE next() {
+    if (next == null) {
+      return fromIterator.next();
+    } else {
+      final TYPE result = next;
+      next = null;
+      return result;
     }
+  }
 
-    /**
-     * 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 TYPE next() {
-        if (next == null) {
-            return fromIterator.next();
-        } else {
-            final TYPE 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 TYPE computeNext();
+  /**
+   * 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 TYPE computeNext();
 }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index 998bbd659..5adfa83ce 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -11,209 +11,221 @@ import java.util.function.Function;
 import java.util.function.Predicate;
 
 /**
- * This is a lazy implementation of the FluentIterable interface. It evaluates
- * all chained operations when a terminating operation is applied.
+ * 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;
+  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 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;
-    }
+  /**
+   * 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 TYPE computeNext() {
-                        while(fromIterator.hasNext()) {
-                            TYPE candidate = fromIterator.next();
-                            if(!predicate.test(candidate)) {
-                                continue;
-                            }
-                            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 = 0;
-
-                    @Override
-                    public TYPE computeNext() {
-                        if(currentIndex < count) {
-                            if(fromIterator.hasNext()) {
-                                TYPE 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()) {
-                public int stopIndex;
-                public int totalElementsCount;
-                private List list;
-                private int currentIndex = 0;
-
-                @Override
-                public TYPE computeNext() {
-                    initialize();
-
-                    TYPE 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 NEW_TYPE.
-     * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
-     * @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 NEW_TYPE computeNext() {
-                        while(oldTypeIterator.hasNext()) {
-                            TYPE candidate = oldTypeIterator.next();
-                            return function.apply(candidate);
-                        }
-                        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() {
-        List copy = FluentIterable.copyToList(iterable);
-        return copy;
-    }
-
-    @Override
-    public Iterator iterator() {
+  /**
+   * 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 TYPE computeNext() {
-                return fromIterator.next();
+          @Override
+          public TYPE computeNext() {
+            while (fromIterator.hasNext()) {
+              TYPE candidate = fromIterator.next();
+              if (!predicate.test(candidate)) {
+                continue;
+              }
+              return candidate;
             }
-        };
-    }
 
-    /**
-     * @return a FluentIterable from a given iterable. Calls the LazyFluentIterable constructor.
-     */
-    public static final  FluentIterable from(Iterable iterable) {
-        return new LazyFluentIterable<>(iterable);
-    }
+            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 = 0;
+
+          @Override
+          public TYPE computeNext() {
+            if (currentIndex < count) {
+              if (fromIterator.hasNext()) {
+                TYPE 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 = 0;
+
+          @Override
+          public TYPE computeNext() {
+            initialize();
+
+            TYPE 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 NEW_TYPE.
+   * 
+   * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
+   * @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 NEW_TYPE computeNext() {
+            while (oldTypeIterator.hasNext()) {
+              TYPE candidate = oldTypeIterator.next();
+              return function.apply(candidate);
+            }
+            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() {
+    List copy = FluentIterable.copyToList(iterable);
+    return copy;
+  }
+
+  @Override
+  public Iterator iterator() {
+    return new DecoratingIterator(iterable.iterator()) {
+      @Override
+      public TYPE computeNext() {
+        return fromIterator.next();
+      }
+    };
+  }
+
+  /**
+   * @return a FluentIterable from a given iterable. Calls the LazyFluentIterable constructor.
+   */
+  public static final  FluentIterable from(Iterable iterable) {
+    return new LazyFluentIterable<>(iterable);
+  }
 
 }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
index 0736387e5..db7a31954 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -8,175 +8,191 @@ import java.util.function.Function;
 import java.util.function.Predicate;
 
 /**
- * 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.
+ * 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;
+  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) {
-        List copy = FluentIterable.copyToList(iterable);
-        this.iterable = copy;
+  /**
+   * 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()) {
+      TYPE 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++;
     }
 
-    /**
-     * 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()) {
-            TYPE nextElement = iterator.next();
-            if(!predicate.test(nextElement)) {
-                iterator.remove();
-            }
-        }
-        return this;
+    return this;
+  }
+
+  /**
+   * Transforms this FluentIterable into a new one containing objects of the type NEW_TYPE.
+   * 
+   * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
+   * @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);
+  }
 
-    /**
-     * 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();
+  /**
+   * 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;
+  }
 
-    /**
-     * 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 NEW_TYPE.
-     * @param function a function that transforms an instance of TYPE into an instance of NEW_TYPE
-     * @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);
-    }
-
-    @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;
+  /**
+   * 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;
+  }
 }
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
index 32bbca430..d0abb7bf1 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
@@ -4,9 +4,9 @@ import org.junit.Test;
 
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }

From d1c653f74c7bbfc61b78120a505f43212925d557 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Thu, 13 Aug 2015 01:31:49 -0400
Subject: [PATCH 206/687] add draft

---
 singleton/presentation/index.html | 57 +++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 singleton/presentation/index.html

diff --git a/singleton/presentation/index.html b/singleton/presentation/index.html
new file mode 100644
index 000000000..238bdb50f
--- /dev/null
+++ b/singleton/presentation/index.html
@@ -0,0 +1,57 @@
+
+
+
+    
+    Circular Slides - impress.js
+    
+
+
+
    
+    
    My Slides
+    
    
+    
    Slide 1
    
+    
    Slide 2
    
+    
    Slide 3
    
+    
    Slide 4
    
+
+    
    
+
    
+
+
+

From 4ee25105b90366dd5a498256ad177590274796e9 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Wed, 9 Sep 2015 17:39:44 -0400
Subject: [PATCH 207/687] add checkstyle to check against google standard

---
 checkstyle.xml | 202 +++++++++++++++++++++++
 pom.xml        | 431 ++++++++++++++++++++++++++-----------------------
 2 files changed, 430 insertions(+), 203 deletions(-)
 create mode 100644 checkstyle.xml

diff --git a/checkstyle.xml b/checkstyle.xml
new file mode 100644
index 000000000..e79788f46
--- /dev/null
+++ b/checkstyle.xml
@@ -0,0 +1,202 @@
+
+
+
+
+
+
+    
+
+    
+
+    
+    
+    
+        
+    
+
+    
+        
+        
+            
+            
+            
+        
+        
+            
+            
+            
+        
+        
+            
+            
+        
+        
+        
+        
+        
+            
+            
+        
+        
+        
+            
+        
+        
+        
+            
+            
+        
+        
+            
+            
+            
+            
+            
+            
+        
+        
+        
+        
+        
+        
+        
+        
+        
+            
+        
+        
+            
+            
+        
+        
+            
+            
+        
+        
+            
+            
+        
+        
+            
+        
+        
+            
+            
+        
+        
+            
+            
+        
+        
+            
+            
+            
+            
+        
+        
+            
+            
+        
+        
+            
+            
+        
+        
+        
+            
+            
+            
+            
+        
+        
+            
+            
+            
+            
+            
+            
+        
+        
+            
+            
+        
+        
+        
+        
+            
+            
+            
+            
+        
+        
+        
+            
+            
+        
+        
+            
+        
+        
+            
+            
+        
+        
+        
+        
+            
+        
+        
+        
+            
+            
+        
+        
+            
+            
+            
+            
+            
+            
+            
+        
+        
+            
+            
+        
+        
+    
+
diff --git a/pom.xml b/pom.xml
index 7b0d80bd8..68fd2254e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,211 +1,236 @@
 
-
-	4.0.0
+
+    4.0.0
 
-	com.iluwatar
-	java-design-patterns
-	1.6.0
-	pom
+    com.iluwatar
+    java-design-patterns
+    1.6.0
+    pom
 
-	
-		UTF-8
-		5.0.0.Final
-		1.8.2.RELEASE
-		1.4.188
-		4.12
-		3.0
-		3.1.0
-		0.7.2.201409121644
-		1.4
-		2.15.3
-	
-	
-		abstract-factory
-		builder
-		factory-method
-		prototype
-		singleton
-		adapter
-		bridge
-		composite
-		dao
-		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
-		poison-pill
-		lazy-loading
-		service-layer
-		specification
-		tolerant-reader
-		model-view-controller
-		flux
-		double-dispatch
-		multiton
-		resource-acquisition-is-initialization
-		thread-pool
-		private-class-data
-		object-pool
-		dependency-injection
-		naked-objects
-		front-controller
-		repository
-		async-method-invocation
-    	business-delegate
-    	half-sync-half-async
-		step-builder
-		layers
-		message-channel
-  
+    
+        UTF-8
+        5.0.0.Final
+        1.8.2.RELEASE
+        1.4.188
+        4.12
+        3.0
+        3.1.0
+        0.7.2.201409121644
+        1.4
+        2.15.3
+    
+    
+        abstract-factory
+        builder
+        factory-method
+        prototype
+        singleton
+        adapter
+        bridge
+        composite
+        dao
+        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
+        poison-pill
+        lazy-loading
+        service-layer
+        specification
+        tolerant-reader
+        model-view-controller
+        flux
+        double-dispatch
+        multiton
+        resource-acquisition-is-initialization
+        thread-pool
+        private-class-data
+        object-pool
+        dependency-injection
+        naked-objects
+        front-controller
+        repository
+        async-method-invocation
+        business-delegate
+        half-sync-half-async
+        step-builder
+        layers
+        message-channel
+    
 
-	
-		
-			
-				org.hibernate
-				hibernate-core
-				${hibernate.version}
-			
-			
-				org.hibernate
-				hibernate-entitymanager
-				${hibernate.version}
-			
-			
-				org.springframework.data
-				spring-data-jpa
-				${spring-data.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.hibernate
+                hibernate-core
+                ${hibernate.version}
+            
+            
+                org.hibernate
+                hibernate-entitymanager
+                ${hibernate.version}
+            
+            
+                org.springframework.data
+                spring-data-jpa
+                ${spring-data.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.eclipse.m2e
-					lifecycle-mapping
-					1.0.0
-					
-						
-							
-								
-									
-										org.jacoco
-										
-											jacoco-maven-plugin
-										
-										
-											[0.6.2,)
-										
-										
-											prepare-agent
-										
-									
-									
-										
-									
-								
-							
-						
-					
-				
-			
-		
+    
+        
+            
+                
+                
+                    org.eclipse.m2e
+                    lifecycle-mapping
+                    1.0.0
+                    
+                        
+                            
+                                
+                                    
+                                        org.jacoco
+                                        
+                                            jacoco-maven-plugin
+                                        
+                                        
+                                            [0.6.2,)
+                                        
+                                        
+                                            prepare-agent
+                                        
+                                    
+                                    
+                                        
+                                    
+                                
+                            
+                        
+                    
+                
+            
+        
 
-		
-			
-			
-				org.apache.maven.plugins
-				maven-compiler-plugin
-				${compiler.version}
-				
-					1.8
-					1.8
-				
-			
-			
-				org.eluder.coveralls
-				coveralls-maven-plugin
-				${coveralls.version}
-				
-					jb6wYzxkVvjolD6qOWpzWdcWBzYk2fAmF
-				
-			
-			
-				org.jacoco
-				jacoco-maven-plugin
-				${jacoco.version}
-				
-				
-				
-					
-						domainapp/dom/modules/simple/QSimpleObject.class
-					
-				
-				
-					
-						prepare-agent
-						
-							prepare-agent
-						
-					
-				
-			
-		
-	
+        
+            
+            
+                org.apache.maven.plugins
+                maven-compiler-plugin
+                ${compiler.version}
+                
+                    1.8
+                    1.8
+                
+            
+            
+                org.eluder.coveralls
+                coveralls-maven-plugin
+                ${coveralls.version}
+                
+                    jb6wYzxkVvjolD6qOWpzWdcWBzYk2fAmF
+                
+            
+            
+                org.jacoco
+                jacoco-maven-plugin
+                ${jacoco.version}
+                
+                
+                
+                    
+                        domainapp/dom/modules/simple/QSimpleObject.class
+                    
+                
+                
+                    
+                        prepare-agent
+                        
+                            prepare-agent
+                        
+                    
+                
+            
 
-
\ No newline at end of file
+            
+            
+                org.apache.maven.plugins
+                maven-checkstyle-plugin
+                2.15
+                
+                    
+                        validate
+                        
+                            check
+                        
+                        validate
+                        
+                            checkstyle.xml
+                            UTF-8
+                            true
+                            false
+                        
+                    
+                
+            
+        
+    
+
+

From e97c5a1f9550dc498b647010672290977dc9f7d7 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Wed, 9 Sep 2015 17:41:28 -0400
Subject: [PATCH 208/687] delete presentation

---
 singleton/presentation/index.html | 57 -------------------------------
 1 file changed, 57 deletions(-)
 delete mode 100644 singleton/presentation/index.html

diff --git a/singleton/presentation/index.html b/singleton/presentation/index.html
deleted file mode 100644
index 238bdb50f..000000000
--- a/singleton/presentation/index.html
+++ /dev/null
@@ -1,57 +0,0 @@
-
-
-
-    
-    Circular Slides - impress.js
-    
-
-
-
    
-    
    My Slides
-    
    
-    
    Slide 1
    
-    
    Slide 2
    
-    
    Slide 3
    
-    
    Slide 4
    
-
-    
    
-
    
-
-
-

From 5aa3eb4652c8606b92c521452c07a43d47c4806a Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Wed, 9 Sep 2015 17:43:21 -0400
Subject: [PATCH 209/687] reformat rules

---
 checkstyle.xml | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/checkstyle.xml b/checkstyle.xml
index e79788f46..0ff943d95 100644
--- a/checkstyle.xml
+++ b/checkstyle.xml
@@ -23,7 +23,7 @@
     
  -->
 
-
+
     
 
     
@@ -38,7 +38,8 @@
         
         
             
-            
+            
             
         
         
@@ -55,7 +56,8 @@
         
         
             
-            
+            
         
         
         
@@ -64,7 +66,8 @@
         
         
             
-            
+            
         
         
             
@@ -159,12 +162,14 @@
             
             
             
-            
+            
         
         
         
             
-            
+            
         
         
             
@@ -176,7 +181,8 @@
         
         
         
-            
+            
         
         
         

From f12de5cae4cc11b830914d4c333ad20df41edd3b Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Wed, 9 Sep 2015 17:45:20 -0400
Subject: [PATCH 210/687] preserve tabs instead of space

---
 pom.xml | 450 ++++++++++++++++++++++++++++----------------------------
 1 file changed, 225 insertions(+), 225 deletions(-)

diff --git a/pom.xml b/pom.xml
index 68fd2254e..10f37ccfe 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,236 +1,236 @@
 
 
-    4.0.0
+		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+	4.0.0
 
-    com.iluwatar
-    java-design-patterns
-    1.6.0
-    pom
+	com.iluwatar
+	java-design-patterns
+	1.6.0
+	pom
 
-    
-        UTF-8
-        5.0.0.Final
-        1.8.2.RELEASE
-        1.4.188
-        4.12
-        3.0
-        3.1.0
-        0.7.2.201409121644
-        1.4
-        2.15.3
-    
-    
-        abstract-factory
-        builder
-        factory-method
-        prototype
-        singleton
-        adapter
-        bridge
-        composite
-        dao
-        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
-        poison-pill
-        lazy-loading
-        service-layer
-        specification
-        tolerant-reader
-        model-view-controller
-        flux
-        double-dispatch
-        multiton
-        resource-acquisition-is-initialization
-        thread-pool
-        private-class-data
-        object-pool
-        dependency-injection
-        naked-objects
-        front-controller
-        repository
-        async-method-invocation
-        business-delegate
-        half-sync-half-async
-        step-builder
-        layers
-        message-channel
-    
+	
+		UTF-8
+		5.0.0.Final
+		1.8.2.RELEASE
+		1.4.188
+		4.12
+		3.0
+		3.1.0
+		0.7.2.201409121644
+		1.4
+		2.15.3
+	
+	
+		abstract-factory
+		builder
+		factory-method
+		prototype
+		singleton
+		adapter
+		bridge
+		composite
+		dao
+		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
+		poison-pill
+		lazy-loading
+		service-layer
+		specification
+		tolerant-reader
+		model-view-controller
+		flux
+		double-dispatch
+		multiton
+		resource-acquisition-is-initialization
+		thread-pool
+		private-class-data
+		object-pool
+		dependency-injection
+		naked-objects
+		front-controller
+		repository
+		async-method-invocation
+		business-delegate
+		half-sync-half-async
+		step-builder
+		layers
+		message-channel
+	
 
-    
-        
-            
-                org.hibernate
-                hibernate-core
-                ${hibernate.version}
-            
-            
-                org.hibernate
-                hibernate-entitymanager
-                ${hibernate.version}
-            
-            
-                org.springframework.data
-                spring-data-jpa
-                ${spring-data.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.hibernate
+				hibernate-core
+				${hibernate.version}
+			
+			
+				org.hibernate
+				hibernate-entitymanager
+				${hibernate.version}
+			
+			
+				org.springframework.data
+				spring-data-jpa
+				${spring-data.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.eclipse.m2e
-                    lifecycle-mapping
-                    1.0.0
-                    
-                        
-                            
-                                
-                                    
-                                        org.jacoco
-                                        
-                                            jacoco-maven-plugin
-                                        
-                                        
-                                            [0.6.2,)
-                                        
-                                        
-                                            prepare-agent
-                                        
-                                    
-                                    
-                                        
-                                    
-                                
-                            
-                        
-                    
-                
-            
-        
+	
+		
+			
+				
+				
+					org.eclipse.m2e
+					lifecycle-mapping
+					1.0.0
+					
+						
+							
+								
+									
+										org.jacoco
+										
+											jacoco-maven-plugin
+										
+										
+											[0.6.2,)
+										
+										
+											prepare-agent
+										
+									
+									
+										
+									
+								
+							
+						
+					
+				
+			
+		
 
-        
-            
-            
-                org.apache.maven.plugins
-                maven-compiler-plugin
-                ${compiler.version}
-                
-                    1.8
-                    1.8
-                
-            
-            
-                org.eluder.coveralls
-                coveralls-maven-plugin
-                ${coveralls.version}
-                
-                    jb6wYzxkVvjolD6qOWpzWdcWBzYk2fAmF
-                
-            
-            
-                org.jacoco
-                jacoco-maven-plugin
-                ${jacoco.version}
-                
-                
-                
-                    
-                        domainapp/dom/modules/simple/QSimpleObject.class
-                    
-                
-                
-                    
-                        prepare-agent
-                        
-                            prepare-agent
-                        
-                    
-                
-            
+		
+			
+			
+				org.apache.maven.plugins
+				maven-compiler-plugin
+				${compiler.version}
+				
+					1.8
+					1.8
+				
+			
+			
+				org.eluder.coveralls
+				coveralls-maven-plugin
+				${coveralls.version}
+				
+					jb6wYzxkVvjolD6qOWpzWdcWBzYk2fAmF
+				
+			
+			
+				org.jacoco
+				jacoco-maven-plugin
+				${jacoco.version}
+				
+				
+				
+					
+						domainapp/dom/modules/simple/QSimpleObject.class
+					
+				
+				
+					
+						prepare-agent
+						
+							prepare-agent
+						
+					
+				
+			
 
-            
-            
-                org.apache.maven.plugins
-                maven-checkstyle-plugin
-                2.15
-                
-                    
-                        validate
-                        
-                            check
-                        
-                        validate
-                        
-                            checkstyle.xml
-                            UTF-8
-                            true
-                            false
-                        
-                    
-                
-            
-        
-    
+			
+			
+				org.apache.maven.plugins
+				maven-checkstyle-plugin
+				2.15
+				
+					
+						validate
+						
+							check
+						
+						validate
+						
+							checkstyle.xml
+							UTF-8
+							true
+							false
+						
+					
+				
+			
+		
+	
 
 

From 31537a238324987c7ca3dcf53df8fb33945e8d9c Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Wed, 9 Sep 2015 19:05:34 -0400
Subject: [PATCH 211/687] suppress checkstyle warnings due to travis failure
 because of huge logs

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 10f37ccfe..b65a30712 100644
--- a/pom.xml
+++ b/pom.xml
@@ -224,7 +224,7 @@
 						
 							checkstyle.xml
 							UTF-8
-							true
+							false
 							false
 						
 					

From efa7e01223e21a3d126906e8020e2f0be8dec6c1 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Thu, 10 Sep 2015 13:12:36 +0530
Subject: [PATCH 212/687] #184 polished a few rough edges, class diagram
 change, and removed warnings

---
 fluentinterface/etc/fluentinterface.png       | Bin 59199 -> 83424 bytes
 fluentinterface/etc/fluentinterface.ucls      | 198 +++++++++---------
 .../com/iluwatar/fluentinterface/App.java     |  31 +--
 .../lazy/LazyFluentIterable.java              |   5 +-
 .../simple/SimpleFluentIterable.java          |   2 +-
 5 files changed, 108 insertions(+), 128 deletions(-)

diff --git a/fluentinterface/etc/fluentinterface.png b/fluentinterface/etc/fluentinterface.png
index 4a79ce0b7f69395cb81822042ae9c85f90da5e17..611fec7c6e7daa4aab70f1d61c621822333eb7b5 100644
GIT binary patch
literal 83424
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%0AXA48uE6Wo
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
    7U;(81
zmhb8hZ5F<(zsxsvJ2UHV_+V->)mQS7=2CBnK0{^k2f9N8WM;7F#(e#ctVf#nuKuU)
zm8AAtkyPg>5J3L7xF9%1t2sNZ`T`LVC;FmfZ9o>QT++qj4jIR0`
zdl92a+GC}hP@KKNER|ZIS*m4Pfh(!>K58{(J}#d0rbBpc%>?EWwEA4nHlNbOkaU=|
zT7CVKND280bnpYhw9}d39whJCM3qyaCdqiAF$*7H2$>Q+wx)gG^3;v213p!|o_#3c
zzVY*OTTX}H<9=eJ`Elw!iL8c{#uL;d$YYoAD$43!JL(u`p*^zxn)i_RhO)w^U?FcW
zEN1}_x&o+N5N^nL4vM*n3+KxN-ROxk(8hs*@dKnTMPF=G`vAfgq&OKKSj%n|k`3)w
zFvmG+IPO}gNHsQAEe5_uCv|AM7-%nLPpwJRMd$#!=Z(hEDxYJgiDfY|9onKMTD
z1F1AnHY%X%lDsJrm3RU@YUj7~6Z@5O?WiZp2Efn)S?eNg{6NvnUQjLhq}JKlQ<8a5
z3IX$*6NGrGA5Z&U*VDbSEVE5=QF0ns)aA2+V{i0F7P)&jd@;oXX%Zzb-N|cQ9PW{U
zf}3*yHQhmP%7n|*{)nj)xCrJB*4e6|8wiuxtX$kck(BS*DWlzHnv#H@e7^zxun`lr
zk5eQ8J&?{V15b>?`siT1Mp;sS7{mo2QYj>WC$ef!bb2WNiw)}HPLG`>duZCij7L&EoIo_XrPre3vpuH9o*-0aX|EdIG^YM+|@w<
zeE``8?A{20aiLEN4-F#AWh%beXOdltn3qAi>`c2x2^%-%CC$T2)wqqKRk@B$N@
zVg()>SKE-Z+ZXMkG4*3L0LYb5Xo6!1fup>c{fRbT^0|%Ka=TEQwBhQ>UJ2XH;H{F4
ze7>aB`$F7eT$&^Sy;3f80a9Zg$dK%jO%TMW^|kKaKoN)mGXr`d
za08wVP~SjtSq18Kv%38u43%cUz+bd8I)OMgtaKmy+Fuw^yMUL8e$(k=_vTWn3WOkm
z?nH*SNWdWDQ;+B~q0&!n2f^k~BPxLo4bZQ-IN>y@S2$cIenwNH9yw9iNu{J6VYNAl
zEEE^f2e)jWnmeFDa5eXr`X@y|w#*c1v!>b?JcPtCxFedarVpH;aISdQHX4_`)nSca
zofgxbT_e$qqmMsfKrORPl0|t?NAgwaac*%d-0S)Cr^tvWH}6fy6B(k%Yz+oEd;@g{
zhaSlEEbf9kuz0ZREWXz&GroTdXR7Xq?6OT#P;JTK!wtke?O8HlBo7t&zo}O^GGtcj=J$<*S>>L(wer9jAtNzwKq;M}ejtkT*HX~ln
zrrv8Sx8v^FEEi*zo5DAjG4A*E1_`VK3(bLta`KlTtPBW)MHeEUXx_`rrblY(ZW7XY
zo279eZg!%1o-B))ftGwFGgPlXsK!yNEjS0{>EV1tML(Q2(MDf@7STaSq%}dX@Jl&{
zUBG!XNQP05T7DyWTsp3N|7az*TOoZg#;3fX&35jFZg*8IU@CIW2ydUlwJ2P}K)xK;uXjZ@m)s6(Jr>)^Lpi8-&1Nl%&?lToyu6S^xEJSAEbhF-9phikn
zm73`CY*En6!XiTMbthby;fRzo^Pl~ePj};o4v6uUz&ZwpkxbXZc>2qmy(gZP9+d?9
zs2%?s;Wj>Kh%vayN}P&C$GijRxsJ)v%QMSEkT(Q2WTd-aTz^jWQROaLu~}*Mjvbk-
zio_irUg!%iRRNV)@HaAr5q&;7?cqSl6(Eo
    sKQS4
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
Rc^U%{c)I$ztaD0e0s!dz!;t_0

literal 59199
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

diff --git a/fluentinterface/etc/fluentinterface.ucls b/fluentinterface/etc/fluentinterface.ucls
index 3277148cd..aab2c9ad7 100644
--- a/fluentinterface/etc/fluentinterface.ucls
+++ b/fluentinterface/etc/fluentinterface.ucls
@@ -1,100 +1,100 @@
-
-  
-      
-        
-          
-            
-          
-      
-    
-      
-        
-          
-            
-          
-      
-    
-      
-        
-          
-            
-          
-      
-    
-      
-        
-          
-            
-          
-      
-    
-      
-        
-          
-            
-          
-      
-    
-      
-        
-          
-            
-          
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-  
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+  
 
\ No newline at end of file
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
index b9e5909f1..f7352fe39 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
@@ -25,27 +25,12 @@ public class App {
 
   public static void main(String[] args) {
 
-    List integerList = new ArrayList() {
-      {
-        add(1);
-        add(-61);
-        add(14);
-        add(-22);
-        add(18);
-        add(-87);
-        add(6);
-        add(64);
-        add(-82);
-        add(26);
-        add(-98);
-        add(97);
-        add(45);
-        add(23);
-        add(2);
-        add(-68);
-        add(45);
-      }
-    };
+    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 =
@@ -105,10 +90,6 @@ public class App {
     prettyPrint(", ", prefix, ".", iterable);
   }
 
-  private static  void prettyPrint(String prefix, String suffix, Iterable iterable) {
-    prettyPrint(", ", prefix, suffix, iterable);
-  }
-
   private static  void prettyPrint(String delimiter, String prefix, String suffix,
       Iterable iterable) {
     StringJoiner joiner = new StringJoiner(delimiter, prefix, ".");
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
index 5adfa83ce..560b10189 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/lazy/LazyFluentIterable.java
@@ -1,15 +1,14 @@
 package com.iluwatar.fluentinterface.fluentiterable.lazy;
 
-import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
-
 import java.util.ArrayList;
 import java.util.Iterator;
 import java.util.List;
 import java.util.Optional;
-import java.util.function.Consumer;
 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.
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
index db7a31954..19283152e 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/fluentiterable/simple/SimpleFluentIterable.java
@@ -124,7 +124,7 @@ public class SimpleFluentIterable implements FluentIterable {
    */
   @Override
   public final  FluentIterable map(Function function) {
-    List temporaryList = new ArrayList();
+    List temporaryList = new ArrayList<>();
     Iterator iterator = iterator();
     while (iterator.hasNext()) {
       temporaryList.add(function.apply(iterator.next()));

From 338ecd1658c2d49c6395aedacbb4f7eb0aa2fa57 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Thu, 10 Sep 2015 15:26:47 +0530
Subject: [PATCH 213/687] Work on #208, categorized factory method in beginner
 difficulty tag

---
 factory-method/index.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/factory-method/index.md b/factory-method/index.md
index fa30a4349..8011e42c8 100644
--- a/factory-method/index.md
+++ b/factory-method/index.md
@@ -4,7 +4,9 @@ title: Factory Method
 folder: factory-method
 permalink: /patterns/factory-method/
 categories: Creational
-tags: Java
+tags: 
+ - Java
+ - Difficulty-Beginner
 ---
 
 **Intent:** Define an interface for creating an object, but let subclasses

From b12bbb8e0052e99136165be79c550482d999f67b Mon Sep 17 00:00:00 2001
From: NooBxGockeL 
Date: Thu, 10 Sep 2015 17:37:04 +0200
Subject: [PATCH 214/687] Work on #218, automagic website updates

---
 .travis.yml       |  6 ++++++
 update-ghpages.sh | 22 ++++++++++++++++++++++
 2 files changed, 28 insertions(+)
 create mode 100644 update-ghpages.sh

diff --git a/.travis.yml b/.travis.yml
index af275508b..a59370c30 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -3,12 +3,18 @@ language: java
 jdk:
   - oraclejdk8
 
+env:
+  global:
+  - GH_REF: github.com/iluwatar/java-design-patterns.git
+  - secure: "LxTDuNS/rBWIvKkaEqr79ImZAe48mCdoYCF41coxNXgNoippo4GIBArknqtv+XvdkiuRZ1yGyj6pn8GU33c/yn+krddTUkVCwTbVatbalW5jhQjDbHYym/JcxaK9ZS/3JTeGcWrBgiPqHEEDhCf26vPZsXoMSeVCEORVKTp1BSg="
+
 before_install:
   - "export DISPLAY=:99.0"
   - "sh -e /etc/init.d/xvfb start"
   
 after_success:
   - mvn clean test jacoco:report coveralls:report
+  - bash update-ghpages.sh
 
 # Migration to container-based infrastructure  
 sudo: false
diff --git a/update-ghpages.sh b/update-ghpages.sh
new file mode 100644
index 000000000..7867150d6
--- /dev/null
+++ b/update-ghpages.sh
@@ -0,0 +1,22 @@
+#!/bin/bash
+
+# Setup Git
+git config user.name "Travis-CI"
+git config user.email "travis@no.reply"
+
+# 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
+
+# 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}@${GH_REF}" master:gh-pages > /dev/null 2>&1
+fi

From bd89530fa24dcdaa619e51f446daad000bb2fbdd Mon Sep 17 00:00:00 2001
From: Markus 
Date: Thu, 10 Sep 2015 17:55:05 +0200
Subject: [PATCH 215/687]  Work on #218, fixed git config

git config must either be global or inside a repo.
I moved the lines for initialization of git to only apply to the ghpagesclone.
---
 update-ghpages.sh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/update-ghpages.sh b/update-ghpages.sh
index 7867150d6..63ac36427 100644
--- a/update-ghpages.sh
+++ b/update-ghpages.sh
@@ -1,9 +1,5 @@
 #!/bin/bash
 
-# Setup Git
-git config user.name "Travis-CI"
-git config user.email "travis@no.reply"
-
 # Clone gh-pages
 git clone -b gh-pages "https://${GH_REF}" ghpagesclone
 cd ghpagesclone
@@ -12,6 +8,10 @@ cd ghpagesclone
 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

From bbd78649278cf5fc719cff04d2530e7fe964ba13 Mon Sep 17 00:00:00 2001
From: NooBxGockeL 
Date: Thu, 10 Sep 2015 18:43:23 +0200
Subject: [PATCH 216/687] Work on #218, fix push command

---
 update-ghpages.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/update-ghpages.sh b/update-ghpages.sh
index 63ac36427..82486d5a4 100644
--- a/update-ghpages.sh
+++ b/update-ghpages.sh
@@ -18,5 +18,5 @@ then
   # it should be committed
   git add .
   git commit -m ":sparkles: :up: Automagic Update via Travis-CI"
-  git push --quiet "https://${GH_TOKEN}@${GH_REF}" master:gh-pages > /dev/null 2>&1
+  git push --quiet "https://${GH_TOKEN}:x-oauth-basic@${GH_REF}" gh-pages > /dev/null 2>&1
 fi

From 9ecb1b25462402e39cdf52596669789330f9105a Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Fri, 11 Sep 2015 13:08:50 +0530
Subject: [PATCH 217/687] Work on #184, changed category, added difficulty tag,
 more real applications and credits, added implementation approaches

---
 fluentinterface/index.md | 30 ++++++++++++++++++++++--------
 1 file changed, 22 insertions(+), 8 deletions(-)

diff --git a/fluentinterface/index.md b/fluentinterface/index.md
index 942867933..27a4d1a26 100644
--- a/fluentinterface/index.md
+++ b/fluentinterface/index.md
@@ -3,14 +3,25 @@ layout: pattern
 title: Fluent Interface
 folder: fluentinterface
 permalink: /patterns/fluentinterface/
-categories: Architectural
-tags: Java
+categories: Other
+tags: 
+ - Java
+ - Difficulty-Intermediate
 ---
 
 **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
@@ -20,9 +31,12 @@ tags: Java
 
 * [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/)
-
-**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/)
\ No newline at end of file
+* [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)

From 65add323ed1cc435cca3e3c2802da7cebe26a00c Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Fri, 11 Sep 2015 13:51:44 +0530
Subject: [PATCH 218/687] Work on #208, explained the ways our patterns can be
 explored

---
 README.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 38936193c..77282f569 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,13 @@ are familiar with the patterns.
 # Getting started
 
 Before you dive into the material, you should be familiar with various 
-[Programming/Software Design Principles](http://webpro.github.io/programming-principles/).
+[Programming/Software Design Principles](http://webpro.github.io/programming-principles/). 
+
+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
 

From 3ebc64c5d689cd200d979d36d2895975a778b8b2 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Thu, 13 Aug 2015 01:31:49 -0400
Subject: [PATCH 219/687] add draft

---
 singleton/presentation/index.html | 57 +++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 singleton/presentation/index.html

diff --git a/singleton/presentation/index.html b/singleton/presentation/index.html
new file mode 100644
index 000000000..238bdb50f
--- /dev/null
+++ b/singleton/presentation/index.html
@@ -0,0 +1,57 @@
+
+
+
+    
+    Circular Slides - impress.js
+    
+
+
+
    
+    
    My Slides
+    
    
+    
    Slide 1
    
+    
    Slide 2
    
+    
    Slide 3
    
+    
    Slide 4
    
+
+    
    
+
    
+
+
+

From 6176f134c4b1d4e58d85089f80c21e6715dc2025 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Fri, 11 Sep 2015 22:56:11 +0300
Subject: [PATCH 220/687] Update Hibernate, Spring and Apache Isis
 dependencies.

---
 naked-objects/pom.xml | 2 +-
 pom.xml               | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml
index 8cac48a09..c9387b58d 100644
--- a/naked-objects/pom.xml
+++ b/naked-objects/pom.xml
@@ -27,7 +27,7 @@
 	
 
 	
-		1.9.0-SNAPSHOT
+		1.9.0
 
 		UTF-8
 		UTF-8
diff --git a/pom.xml b/pom.xml
index 2c040005b..a67b32e78 100644
--- a/pom.xml
+++ b/pom.xml
@@ -9,8 +9,8 @@
 
 	
 		UTF-8
-		5.0.0.Final
-		1.8.2.RELEASE
+		5.0.1.Final
+		1.9.0.RELEASE
 		1.4.188
 		4.12
 		3.0

From 266aca20c781c0ca146f52685bd6008edbc1bb01 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Fri, 11 Sep 2015 18:30:17 -0400
Subject: [PATCH 221/687] delete presentation from branch

---
 singleton/presentation/index.html | 57 -------------------------------
 1 file changed, 57 deletions(-)
 delete mode 100644 singleton/presentation/index.html

diff --git a/singleton/presentation/index.html b/singleton/presentation/index.html
deleted file mode 100644
index 238bdb50f..000000000
--- a/singleton/presentation/index.html
+++ /dev/null
@@ -1,57 +0,0 @@
-
-
-
-    
-    Circular Slides - impress.js
-    
-
-
-
    
-    
    My Slides
-    
    
-    
    Slide 1
    
-    
    Slide 2
    
-    
    Slide 3
    
-    
    Slide 4
    
-
-    
    
-
    
-
-
-

From 8d429525dcb752db7854f0695630c1a98eb17b76 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Sat, 12 Sep 2015 17:46:24 +0530
Subject: [PATCH 222/687] Work on #74, updated javadocs, reformatted code to
 google style guide, added missing final modifiers

---
 .../java/com/iluwatar/reactor/app/App.java    | 145 ++++---
 .../com/iluwatar/reactor/app/AppClient.java   | 253 +++++------
 .../iluwatar/reactor/app/LoggingHandler.java  |  81 ++--
 .../reactor/framework/AbstractNioChannel.java | 256 +++++------
 .../reactor/framework/ChannelHandler.java     |  22 +-
 .../reactor/framework/Dispatcher.java         |  56 +--
 .../reactor/framework/NioDatagramChannel.java | 266 ++++++------
 .../reactor/framework/NioReactor.java         | 401 +++++++++---------
 .../framework/NioServerSocketChannel.java     | 135 +++---
 .../framework/SameThreadDispatcher.java       |  47 +-
 .../framework/ThreadPoolDispatcher.java       |  71 ++--
 .../com/iluwatar/reactor/app/AppTest.java     |  50 ++-
 12 files changed, 908 insertions(+), 875 deletions(-)

diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index 947173494..fcc327b34 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -10,20 +10,18 @@ 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.
+ * 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 
+ * 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 
+ * PROBLEM 
    
+ * Server applications in a distributed system must handle multiple clients that send them service
  * requests. Following forces need to be resolved:
  * 
      
  * 
    • Availability
      • 
@@ -33,8 +31,28 @@ import com.iluwatar.reactor.framework.ThreadPoolDispatcher;
  * 
    
  * 
  * 
    
- * 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
+ * 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).
  * 
  * 
    
@@ -45,59 +63,60 @@ import com.iluwatar.reactor.framework.ThreadPoolDispatcher;
  */
 public class App {
 
-	private NioReactor reactor;
+  private NioReactor reactor;
 
-	/**
-	 * App entry.
-	 * @throws IOException 
-	 */
-	public static void main(String[] args) throws IOException {
-		new App().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(new ThreadPoolDispatcher(2));
-		
-		/*
-		 *  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.
-	 */
-	public void stop() {
-		reactor.stop();
-	}
+  /**
+   * App entry.
+   * 
+   * @throws IOException
+   */
+  public static void main(String[] args) throws IOException {
+    new App().start();
+  }
 
-	private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException {
-		NioServerSocketChannel channel = new NioServerSocketChannel(port, handler);
-		channel.bind();
-		return channel;
-	}
-	
-	private static AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException {
-		NioDatagramChannel channel = new NioDatagramChannel(port, handler);
-		channel.bind();
-		return channel;
-	}
+  /**
+   * 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(new ThreadPoolDispatcher(2));
+
+    /*
+     * 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.
+   */
+  public void stop() throws InterruptedException {
+    reactor.stop();
+  }
+
+  private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException {
+    NioServerSocketChannel channel = new NioServerSocketChannel(port, handler);
+    channel.bind();
+    return channel;
+  }
+
+  private static AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException {
+    NioDatagramChannel channel = new NioDatagramChannel(port, handler);
+    channel.bind();
+    return channel;
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
index 033711569..c50e4d3e7 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
@@ -17,148 +17,149 @@ import java.util.concurrent.TimeUnit;
 /**
  * Represents the clients of Reactor pattern. Multiple clients are run concurrently and send logging
  * requests to Reactor.
- *  
+ * 
  * @author npathai
  */
 public class AppClient {
-	private ExecutorService service = Executors.newFixedThreadPool(4);
+  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();
-	}
+  /**
+   * 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));
-	}
+  /**
+   * 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();
-		}
-	}
+  /**
+   * 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();
+      }
+    }
+  }
 
-	/**
-	 * A logging client that sends requests to Reactor on TCP socket.  
-	 */
-	static class TCPLoggingClient implements Runnable {
+  private static void artificialDelayOf(long millis) {
+    try {
+      Thread.sleep(millis);
+    } catch (InterruptedException e) {
+      e.printStackTrace();
+    }
+  }
 
-		private int serverPort;
-		private String clientName;
+  /**
+   * A logging client that sends requests to Reactor on TCP socket.
+   */
+  static class TCPLoggingClient implements Runnable {
 
-		/**
-		 * 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;
-		}
+    private final int serverPort;
+    private final String clientName;
 
-		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);
-			}
-		}
+    /**
+     * 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;
+    }
 
-		private void sendLogRequests(PrintWriter writer, InputStream inputStream) throws IOException {
-			for (int i = 0; i < 4; i++) {
-				writer.println(clientName + " - Log request: " + i);
-				writer.flush();
+    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);
+      }
+    }
 
-				byte[] data = new byte[1024];
-				int read = inputStream.read(data, 0, data.length);
-				if (read == 0) {
-					System.out.println("Read zero bytes");
-				} else {
-					System.out.println(new String(data, 0, read));
-				}
+    private void sendLogRequests(PrintWriter writer, InputStream inputStream) throws IOException {
+      for (int i = 0; i < 4; i++) {
+        writer.println(clientName + " - Log request: " + i);
+        writer.flush();
 
-				artificialDelayOf(100);
-			}
-		}
+        byte[] data = new byte[1024];
+        int read = inputStream.read(data, 0, data.length);
+        if (read == 0) {
+          System.out.println("Read zero bytes");
+        } else {
+          System.out.println(new String(data, 0, read));
+        }
 
-	}
+        artificialDelayOf(100);
+      }
+    }
 
-	/**
-	 * A logging client that sends requests to Reactor on UDP socket.  
-	 */
-	static class UDPLoggingClient implements Runnable {
-		private String clientName;
-		private 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);
-		}
+  /**
+   * A logging client that sends requests to Reactor on UDP socket.
+   */
+  static class UDPLoggingClient implements Runnable {
+    private final String clientName;
+    private final InetSocketAddress remoteAddress;
 
-		@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);
+    /**
+     * 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);
+    }
 
-					byte[] data = new byte[1024];
-					DatagramPacket reply = new DatagramPacket(data, data.length);
-					socket.receive(reply);
-					if (reply.getLength() == 0) {
-						System.out.println("Read zero bytes");
-					} else {
-						System.out.println(new String(reply.getData(), 0, reply.getLength()));
-					}
-					
-					artificialDelayOf(100);
-				}
-			} catch (IOException e1) {
-				e1.printStackTrace();
-			}
-		}
-	}
+    @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) {
+            System.out.println("Read zero bytes");
+          } else {
+            System.out.println(new String(reply.getData(), 0, reply.getLength()));
+          }
+
+          artificialDelayOf(100);
+        }
+      } catch (IOException e1) {
+        e1.printStackTrace();
+      }
+    }
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
index eed26b078..1f2694b0b 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
@@ -8,53 +8,54 @@ import com.iluwatar.reactor.framework.ChannelHandler;
 import com.iluwatar.reactor.framework.NioDatagramChannel.DatagramPacket;
 
 /**
- * Logging server application logic. It logs the incoming requests on standard console and returns
- * a canned acknowledgement back to the remote peer.
+ * Logging server application logic. It logs the incoming requests on standard console and returns a
+ * canned acknowledgement back to the remote peer.
  * 
  * @author npathai
  */
 public class LoggingHandler implements ChannelHandler {
 
-	private static final byte[] ACK = "Data logged successfully".getBytes();
+  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");
-		}
-	}
+  /**
+   * 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 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 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());
 
-	private void sendReply(AbstractNioChannel channel, SelectionKey key) {
-		ByteBuffer buffer = ByteBuffer.wrap(ACK);
-		channel.write(buffer, key);
-	}
+    channel.write(replyPacket, key);
+  }
 
-	private void doLogging(ByteBuffer data) {
-		// assuming UTF-8 :(
-		System.out.println(new String(data.array(), 0, data.limit()));
-	}
+  private void sendReply(AbstractNioChannel channel, SelectionKey key) {
+    ByteBuffer buffer = ByteBuffer.wrap(ACK);
+    channel.write(buffer, key);
+  }
+
+  private void doLogging(ByteBuffer data) {
+    // assuming UTF-8 :(
+    System.out.println(new String(data.array(), 0, data.limit()));
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
index 24862644d..09f308731 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
@@ -10,143 +10,145 @@ 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 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. 
- *   
+ * 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.
+ * 
  * @author npathai
  *
  */
 public abstract class AbstractNioChannel {
-	
-	private SelectableChannel channel;
-	private ChannelHandler handler;
-	private 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 getChannel() {
-		return channel;
-	}
+  private final SelectableChannel channel;
+  private final ChannelHandler handler;
+  private final Map> channelToPendingWrites = new ConcurrentHashMap<>();
+  private NioReactor reactor;
 
-	/**
-	 * 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;
+  /**
+   * 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;
+  }
 
-	/**
-	 * @return the handler associated with this channel.
-	 */
-	public ChannelHandler getHandler() {
-		return handler;
-	}
+  /**
+   * Injects the reactor in this channel.
+   */
+  void setReactor(NioReactor reactor) {
+    this.reactor = reactor;
+  }
 
-	/* 
-	 * 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);
-		}
-	}
+  /**
+   * @return the wrapped NIO channel.
+   */
+  public SelectableChannel getChannel() {
+    return channel;
+  }
 
-	/**
-	 * 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;
+  /**
+   * The operation in which the channel is interested, this operation is provided to
+   * {@link Selector}.
+   * 
+   * @return interested operation.
+   * @see SelectionKey
+   */
+  public abstract int getInterestedOps();
 
-	/**
-	 * 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);
-	}
+  /**
+   * 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);
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
index 0aae9db75..a4a392a34 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
@@ -7,19 +7,19 @@ import java.nio.channels.SelectionKey;
  * 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.
- *  
+ * 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.
+ * 
  * @author npathai
  */
 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);
+  /**
+   * 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);
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
index c563ef9d3..0ed53f8fc 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
@@ -3,39 +3,41 @@ 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.
+ * 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.
- *  
+ * 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
  * 
  * @author npathai
  */
 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.
-	 */
-	void stop();
+  /**
+   * 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;
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
index f338ce4a3..089911d10 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -15,143 +15,147 @@ import java.nio.channels.SelectionKey;
  */
 public class NioDatagramChannel extends AbstractNioChannel {
 
-	private int port;
+  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;
-	}
+  /**
+   * 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;
-	}
+  @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 getChannel() {
-		return (DatagramChannel) super.getChannel();
-	}
-	
-	/**
-	 * Binds UDP socket on the provided port.
-	 *  
-	 * @throws IOException if any I/O error occurs.
-	 */
-	@Override
-	public void bind() throws IOException {
-		getChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
-		getChannel().configureBlocking(false);
-		System.out.println("Bound UDP socket at port: " + port);
-	}
+  /**
+   * 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);
 
-	/**
-	 * 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;
-		getChannel().send(pendingPacket.getData(), pendingPacket.getReceiver());
-	}
+    /*
+     * 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);
 
-	/**
-	 * 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;
+    return packet;
+  }
 
-		/**
-		 * 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 underlying datagram channel.
+   */
+  @Override
+  public DatagramChannel getChannel() {
+    return (DatagramChannel) super.getChannel();
+  }
 
-		/**
-		 * @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;
-		}
+  /**
+   * Binds UDP socket on the provided port.
+   * 
+   * @throws IOException if any I/O error occurs.
+   */
+  @Override
+  public void bind() throws IOException {
+    getChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
+    getChannel().configureBlocking(false);
+    System.out.println("Bound UDP socket at port: " + port);
+  }
 
-		/**
-		 * @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;
-		}
+  /**
+   * 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;
+    getChannel().send(pendingPacket.getData(), pendingPacket.getReceiver());
+  }
 
-		/**
-		 * @return the underlying message that will be written on channel.
-		 */
-		public ByteBuffer getData() {
-			return data;
-		}
-	}
-}
\ No newline at end of file
+  /**
+   * 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;
+    }
+  }
+}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
index 273898ae3..89af20630 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -12,228 +12,225 @@ 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}.
+ * 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.
+ * 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.
+ * 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.
  * 
  * @author npathai
  *
  */
 public class NioReactor {
 
-	private Selector selector;
-	private 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 Queue pendingCommands = new ConcurrentLinkedQueue<>();
-	private 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();
-	}
+  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();
 
-	/**
-	 * 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 {
-					System.out.println("Reactor started, waiting for events...");
-					eventLoop();
-				} catch (IOException e) {
-					e.printStackTrace();
-				}
-		});
-	}
-	
-	/**
-	 * Stops the reactor and related resources such as dispatcher.
-	 */
-	public void stop() {
-		reactorMain.shutdownNow();
-		selector.wakeup();
-		try {
-			reactorMain.awaitTermination(4, TimeUnit.SECONDS);
-		} catch (InterruptedException e) {
-			e.printStackTrace();
-		}
-		dispatcher.stop();
-	}
+  /**
+   * 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();
+  }
 
-	/**
-	 * 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.getChannel().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();
+  /**
+   * 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 {
+        System.out.println("Reactor started, waiting for events...");
+        eventLoop();
+      } catch (IOException e) {
+        e.printStackTrace();
+      }
+    });
+  }
 
-			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();
-		}
-	}
+  /**
+   * Stops the reactor and related resources such as dispatcher.
+   * 
+   * @throws InterruptedException if interrupted while stopping the reactor.
+   */
+  public void stop() throws InterruptedException {
+    reactorMain.shutdownNow();
+    selector.wakeup();
+    reactorMain.awaitTermination(4, TimeUnit.SECONDS);
+    dispatcher.stop();
+  }
 
-	/*
-	 * 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);
-		}
-	}
+  /**
+   * 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.getChannel().register(selector, channel.getInterestedOps());
+    key.attach(channel);
+    channel.setReactor(this);
+    return this;
+  }
 
-	private void onChannelWritable(SelectionKey key) throws IOException {
-		AbstractNioChannel channel = (AbstractNioChannel) key.attachment();
-		channel.flush(key);
-	}
+  private void eventLoop() throws IOException {
+    while (true) {
 
-	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);
+      // honor interrupt request
+      if (Thread.interrupted()) {
+        break;
+      }
 
-			dispatchReadEvent(key, readObject);
-		} catch (IOException e) {
-			try {
-				key.channel().close();
-			} catch (IOException e1) {
-				e1.printStackTrace();
-			}
-		}
-	}
+      // honor any pending commands first
+      processPendingCommands();
 
-	/*
-	 * 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);
-	}
+      /*
+       * 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();
 
-	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());
-	}
+      /*
+       * Represents the events that have occurred on registered handles.
+       */
+      Set keys = selector.selectedKeys();
 
-	/**
-	 * 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;
-		}
-	}
-}
\ No newline at end of file
+      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 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;
+    }
+  }
+}
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index ae54af643..17f47a394 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -9,81 +9,82 @@ 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}.
+ * A wrapper over {@link NioServerSocketChannel} which can read and write data on a
+ * {@link SocketChannel}.
  * 
  * @author npathai
  */
 public class NioServerSocketChannel extends AbstractNioChannel {
 
-	private int port;
+  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;
-	}
+  /**
+   * 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 getChannel() {
-		return (ServerSocketChannel) super.getChannel();
-	}
-	
-	/**
-	 * 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;
-	}
+  @Override
+  public int getInterestedOps() {
+    // being a server socket channel it is interested in accepting connection from remote peers.
+    return SelectionKey.OP_ACCEPT;
+  }
 
-	/**
-	 * Binds TCP socket on the provided port.
-	 *  
-	 * @throws IOException if any I/O error occurs.
-	 */
-	@Override
-	public void bind() throws IOException {
-		((ServerSocketChannel)getChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
-		((ServerSocketChannel)getChannel()).configureBlocking(false);
-		System.out.println("Bound TCP socket at port: " + port);
-	}
+  /**
+   * @return the underlying {@link ServerSocketChannel}.
+   */
+  @Override
+  public ServerSocketChannel getChannel() {
+    return (ServerSocketChannel) super.getChannel();
+  }
 
-	/**
-	 * 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);
-	}
+  /**
+   * 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) getChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
+    ((ServerSocketChannel) getChannel()).configureBlocking(false);
+    System.out.println("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);
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
index b5392ac8f..baacda9f3 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
@@ -4,8 +4,8 @@ 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.
+ * 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}.
@@ -16,28 +16,25 @@ import java.nio.channels.SelectionKey;
  */
 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) {
-		if (channel.getHandler() != null) {
-			/*
-			 * Calls the associated handler to notify the read event where application specific code
-			 * resides.
-			 */
-			channel.getHandler().handleChannelRead(channel, readObject, key);
-		}
-	}
+  /**
+   * 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
-	}
+  /**
+   * No resources to free.
+   */
+  @Override
+  public void stop() {
+    // no-op
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
index 8624b878e..9fd539adb 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
@@ -6,50 +6,45 @@ 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.
+ * 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.
  * 
  * @author npathai
  *
  */
-public class ThreadPoolDispatcher extends SameThreadDispatcher {
+public class ThreadPoolDispatcher implements Dispatcher {
 
-	private ExecutorService executorService;
+  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);
-	}
+  /**
+   * 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(() -> 
-			ThreadPoolDispatcher.super.onChannelReadEvent(channel, readObject, key));
-	}
-
-	/**
-	 * Stops the pool of workers.
-	 */
-	@Override
-	public void stop() {
-		executorService.shutdownNow();
-		try {
-			executorService.awaitTermination(4, TimeUnit.SECONDS);
-		} catch (InterruptedException e) {
-			e.printStackTrace();
-		}
-	}
+  /**
+   * 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);
+  }
 }
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
index 9447aac01..bc51e26de 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
@@ -4,24 +4,38 @@ import java.io.IOException;
 
 import org.junit.Test;
 
+/**
+ * 
+ * This class tests the Distributed Logging service by starting a Reactor and then sending it
+ * concurrent logging requests using multiple clients.
+ * 
+ * @author npathai
+ */
 public class AppTest {
 
-	@Test
-	public void testApp() throws IOException {
-		App app = new App();
-		app.start();
-		
-		AppClient client = new AppClient();
-		client.start();
-		
-		try {
-			Thread.sleep(2000);
-		} catch (InterruptedException e) {
-			e.printStackTrace();
-		}
-		
-		client.stop();
-		
-		app.stop();
-	}
+  /**
+   * Test the application.
+   * 
+   * @throws IOException if any I/O error occurs.
+   * @throws InterruptedException if interrupted while stopping the application.
+   */
+  @Test
+  public void testApp() throws IOException, InterruptedException {
+    App app = new App();
+    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();
+  }
 }

From 2dc98f6b93dcdedbb911fb668a6d45e26afbf5c6 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Mon, 14 Sep 2015 07:05:01 +0300
Subject: [PATCH 223/687] Upgrade Coveralls plugin to 4.0.0

---
 pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 5bfacf287..70a164c06 100644
--- a/pom.xml
+++ b/pom.xml
@@ -15,7 +15,7 @@
 		1.4.188
 		4.12
 		3.0
-		3.1.0
+		4.0.0
 		0.7.2.201409121644
 		1.4
 		2.15.3

From 2ff78184e54883b54d05e83e50f47334b22f8eaa Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Mon, 14 Sep 2015 12:56:17 +0530
Subject: [PATCH 224/687] Work on #74, added class diagram and index.md

---
 reactor/etc/reactor.png  | Bin 0 -> 124359 bytes
 reactor/etc/reactor.ucls | 207 +++++++++++++++++++++++++++++++++++++++
 reactor/index.md         |  30 ++++++
 3 files changed, 237 insertions(+)
 create mode 100644 reactor/etc/reactor.png
 create mode 100644 reactor/etc/reactor.ucls
 create mode 100644 reactor/index.md

diff --git a/reactor/etc/reactor.png b/reactor/etc/reactor.png
new file mode 100644
index 0000000000000000000000000000000000000000..0b00ec98be5ccdbeeb74d71241de065e3d733554
GIT binary patch
literal 124359
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

literal 0
HcmV?d00001

diff --git a/reactor/etc/reactor.ucls b/reactor/etc/reactor.ucls
new file mode 100644
index 000000000..d072e4029
--- /dev/null
+++ b/reactor/etc/reactor.ucls
@@ -0,0 +1,207 @@
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+        
+        
+      
+    
+      
+        
+          
+            
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/reactor/index.md b/reactor/index.md
new file mode 100644
index 000000000..7333c74dd
--- /dev/null
+++ b/reactor/index.md
@@ -0,0 +1,30 @@
+---
+layout: pattern
+title: Reactor
+folder: reactor
+permalink: /patterns/reactor/
+categories: Architectural
+tags: 
+ - Java
+ - Difficulty-Expert
+---
+
+**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)
+* [Doug Lea - Scalable IO in Java](http://gee.cs.oswego.edu/dl/cpjslides/nio.pdf)
+* [Netty](http://netty.io/)

From 51dca28fe71681540142d01db601e18a662de651 Mon Sep 17 00:00:00 2001
From: Alan 
Date: Mon, 14 Sep 2015 21:22:33 +0100
Subject: [PATCH 225/687] Updated unit .equals() and .hashCode() methods
 Formatted code using this formatter:
 https://github.com/google/styleguide/blob/gh-pages/eclipse-java-google-style.xml
 Removed argument final declaration on interface Updated addCustomer logic for
 cases where the added customer already exists

---
 .../main/java/com/iluwatar/dao/Customer.java  | 107 ++++++-------
 .../java/com/iluwatar/dao/CustomerDao.java    |  18 ++-
 .../com/iluwatar/dao/CustomerDaoImpl.java     |  87 +++++-----
 .../com/iluwatar/dao/CustomerDaoImplTest.java | 150 ++++++++++--------
 .../java/com/iluwatar/dao/CustomerTest.java   | 141 ++++++++--------
 5 files changed, 254 insertions(+), 249 deletions(-)

diff --git a/dao/src/main/java/com/iluwatar/dao/Customer.java b/dao/src/main/java/com/iluwatar/dao/Customer.java
index 652eda7b2..e6d7f7763 100644
--- a/dao/src/main/java/com/iluwatar/dao/Customer.java
+++ b/dao/src/main/java/com/iluwatar/dao/Customer.java
@@ -6,70 +6,63 @@ package com.iluwatar.dao;
  *
  */
 public class Customer {
-	
-    private int id;
-    private String firstName;
-    private String lastName;
 
-    public Customer(final int id, final String firstName, final String lastName) {
-        this.id = id;
-        this.firstName = firstName;
-        this.lastName = lastName;
-    }
+  private int id;
+  private String firstName;
+  private String lastName;
 
-    public int getId() {
-        return id;
-    }
+  public Customer(final int id, final String firstName, final String lastName) {
+    this.id = id;
+    this.firstName = firstName;
+    this.lastName = lastName;
+  }
 
-    public void setId(final int id) {
-        this.id = id;
-    }
+  public int getId() {
+    return id;
+  }
 
-    public String getFirstName() {
-        return firstName;
-    }
+  public void setId(final int id) {
+    this.id = id;
+  }
 
-    public void setFirstName(final String firstName) {
-        this.firstName = firstName;
-    }
+  public String getFirstName() {
+    return firstName;
+  }
 
-    public String getLastName() {
-        return lastName;
-    }
+  public void setFirstName(final String firstName) {
+    this.firstName = firstName;
+  }
 
-    public void setLastName(final String lastName) {
-        this.lastName = lastName;
-    }
+  public String getLastName() {
+    return lastName;
+  }
 
-    @Override
-    public String toString() {
-        return "Customer{" +
-                "id=" + getId() +
-                ", firstName='" + getFirstName() + '\'' +
-                ", lastName='" + getLastName() + '\'' +
-                '}';
-    }
+  public void setLastName(final String lastName) {
+    this.lastName = lastName;
+  }
 
-    /**
-     * Checks if two objects are the same.
-     * 
-     * @return true if the two objects are Customer objects and have the same id value, false otherwise.
-     */
-    @Override
-    public boolean equals(final Object o) {
-    	boolean isEqual = false;
-    	final Customer customer = (Customer) o;
-        if (getId() == customer.getId()) {
-        	isEqual = true;
-        }
-        return isEqual;
+  @Override
+  public String toString() {
+    return "Customer{" + "id=" + getId() + ", firstName='" + getFirstName() + '\'' + ", lastName='"
+        + getLastName() + '\'' + '}';
+  }
+
+  @Override
+  public boolean equals(final Object o) {
+    boolean isEqual = false;
+    if (this == o) {
+      isEqual = true;
+    } else if (o != null && (getClass() == o.getClass())) {
+      final Customer customer = (Customer) o;
+      if (getId() == customer.getId())
+        isEqual = true;
     }
-    
-    @Override
-    public int hashCode() {
-        int result = getId();
-        id += getFirstName().hashCode();
-        id += getLastName().hashCode();
-        return result;
-    }
-}
\ No newline at end of file
+    return isEqual;
+  }
+
+  @Override
+  public int hashCode() {
+    int result = getId();
+    return result;
+  }
+}
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
index 54f388dde..79d23ba20 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomerDao.java
@@ -8,10 +8,14 @@ import java.util.List;
  *
  */
 public interface CustomerDao {
-	
-    List getAllCustomers();
-    Customer getCustomerById(final int id);
-    void addCustomer(final Customer customer);
-    void updateCustomer(final Customer customer);
-    void deleteCustomer(final Customer customer);
-}
\ No newline at end of file
+
+  List getAllCustomers();
+
+  Customer getCustomerById(int id);
+
+  void addCustomer(Customer customer);
+
+  void updateCustomer(Customer customer);
+
+  void deleteCustomer(Customer customer);
+}
diff --git a/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java b/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java
index e5c431452..e590fb1a6 100644
--- a/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java
+++ b/dao/src/main/java/com/iluwatar/dao/CustomerDaoImpl.java
@@ -4,56 +4,59 @@ import java.util.List;
 
 /**
  * 
- * The 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,
- * database schema, etc.
+ * The 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, database schema, etc.
  * 
  */
 public class CustomerDaoImpl implements CustomerDao {
 
-    // Represents the DB structure for our example so we don't have to managed it ourselves
-    // Note: Normally this would be in the form of an actual database and not part of the Dao Impl.
-    private List customers;
+  // Represents the DB structure for our example so we don't have to managed it ourselves
+  // Note: Normally this would be in the form of an actual database and not part of the Dao Impl.
+  private List customers;
 
-    public CustomerDaoImpl(final List customers) {
-        this.customers = customers;
+  public CustomerDaoImpl(final List customers) {
+    this.customers = customers;
+  }
+
+  @Override
+  public List getAllCustomers() {
+    return customers;
+  }
+
+  @Override
+  public Customer getCustomerById(final int id) {
+    Customer customer = null;
+    for (final Customer cus : getAllCustomers()) {
+      if (cus.getId() == id) {
+        customer = cus;
+        break;
+      }
     }
+    return customer;
+  }
 
-    @Override
-    public List getAllCustomers() {
-        return customers;
+  @Override
+  public void addCustomer(final Customer customer) {
+    if (getCustomerById(customer.getId()) == null) {
+      customers.add(customer);
     }
+  }
 
-    @Override
-    public Customer getCustomerById(final int id) {
-    	Customer customer = null;
-        for (final Customer cus : getAllCustomers()) {
-            if (cus.getId() == id) {
-                customer = cus;
-                break;
-            }
-        }
-        return customer;
+
+  @Override
+  public void updateCustomer(final Customer customer) {
+    if (getAllCustomers().contains(customer)) {
+      final int index = getAllCustomers().indexOf(customer);
+      getAllCustomers().set(index, customer);
     }
+  }
 
-    @Override
-    public void addCustomer(final Customer customer) {
-        customers.add(customer);
-    }
-
-
-    @Override
-    public void updateCustomer(final Customer customer) {
-        if (getAllCustomers().contains(customer)) {
-        	final int index = getAllCustomers().indexOf(customer);
-            getAllCustomers().set(index, customer);
-        }
-    }
-
-    @Override
-    public void deleteCustomer(final Customer customer) {
-        getAllCustomers().remove(customer);
-    }
-}
\ No newline at end of file
+  @Override
+  public void deleteCustomer(final Customer customer) {
+    getAllCustomers().remove(customer);
+  }
+}
diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
index ae87be156..e5e5eb220 100644
--- a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
@@ -12,70 +12,88 @@ import org.junit.Test;
 
 public class CustomerDaoImplTest {
 
-	private CustomerDaoImpl impl;
-	private List customers;
-	private static final Customer CUSTOMER = new Customer(1, "Freddy", "Kruger");
-	
-	@Before
-	public void setUp() {
-		customers = new ArrayList();
-		customers.add(CUSTOMER);
-		impl = new CustomerDaoImpl(customers);
-	}
-	
-	@Test
-	public void deleteExistingCustomer() {
-		assertEquals(1, impl.getAllCustomers().size());
-		impl.deleteCustomer(CUSTOMER);
-		assertTrue(impl.getAllCustomers().isEmpty());
-	}
-	
-	@Test
-	public void deleteNonExistingCustomer() {
-		final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund");
-		impl.deleteCustomer(nonExistingCustomer);
-		assertEquals(1, impl.getAllCustomers().size());
-	}
-	
-	@Test
-	public void updateExistingCustomer() {
-		final String newFirstname = "Bernard";
-		final String newLastname = "Montgomery";
-		final Customer customer = new Customer(CUSTOMER.getId(), newFirstname, newLastname);
-		impl.updateCustomer(customer);
-		final Customer cust = impl.getCustomerById(CUSTOMER.getId());
-		assertEquals(newFirstname, cust.getFirstName());
-		assertEquals(newLastname, cust.getLastName());
-	}
-	
-	@Test
-	public void updateNonExistingCustomer() {
-		final int nonExistingId = 999;
-		final String newFirstname = "Douglas";
-		final String newLastname = "MacArthur";
-		final Customer customer = new Customer(nonExistingId, newFirstname, newLastname);
-		impl.updateCustomer(customer);
-		assertNull(impl.getCustomerById(nonExistingId));
-		final Customer existingCustomer = impl.getCustomerById(CUSTOMER.getId());
-		assertEquals(CUSTOMER.getFirstName(), existingCustomer.getFirstName());
-		assertEquals(CUSTOMER.getLastName(), existingCustomer.getLastName());
-	}
-	
-	@Test
-	public void addCustomer() {
-		final Customer newCustomer = new Customer(3, "George", "Patton");
-		impl.addCustomer(newCustomer);
-		assertEquals(2, impl.getAllCustomers().size());
-	}
-	
-	@Test
-	public void getExistinCustomerById() {
-		assertEquals(CUSTOMER, impl.getCustomerById(CUSTOMER.getId()));
-	}
-	
-	@Test
-	public void getNonExistinCustomerById() {
-		final int nonExistingId = 999;
-		assertNull(impl.getCustomerById(nonExistingId));
-	}
+  private CustomerDaoImpl impl;
+  private List customers;
+  private static final Customer CUSTOMER = new Customer(1, "Freddy", "Kruger");
+
+  @Before
+  public void setUp() {
+    customers = new ArrayList();
+    customers.add(CUSTOMER);
+    impl = new CustomerDaoImpl(customers);
+  }
+
+  @Test
+  public void deleteExistingCustomer() {
+    assertEquals(1, impl.getAllCustomers().size());
+    impl.deleteCustomer(CUSTOMER);
+    assertTrue(impl.getAllCustomers().isEmpty());
+  }
+
+  @Test
+  public void deleteNonExistingCustomer() {
+    final Customer nonExistingCustomer = new Customer(2, "Robert", "Englund");
+    impl.deleteCustomer(nonExistingCustomer);
+    assertEquals(1, impl.getAllCustomers().size());
+  }
+
+  @Test
+  public void updateExistingCustomer() {
+    final String newFirstname = "Bernard";
+    final String newLastname = "Montgomery";
+    final Customer customer = new Customer(CUSTOMER.getId(), newFirstname, newLastname);
+    impl.updateCustomer(customer);
+    final Customer cust = impl.getCustomerById(CUSTOMER.getId());
+    assertEquals(newFirstname, cust.getFirstName());
+    assertEquals(newLastname, cust.getLastName());
+  }
+
+  @Test
+  public void updateNonExistingCustomer() {
+    final int nonExistingId = getNonExistingCustomerId();
+    final String newFirstname = "Douglas";
+    final String newLastname = "MacArthur";
+    final Customer customer = new Customer(nonExistingId, newFirstname, newLastname);
+    impl.updateCustomer(customer);
+    assertNull(impl.getCustomerById(nonExistingId));
+    final Customer existingCustomer = impl.getCustomerById(CUSTOMER.getId());
+    assertEquals(CUSTOMER.getFirstName(), existingCustomer.getFirstName());
+    assertEquals(CUSTOMER.getLastName(), existingCustomer.getLastName());
+  }
+
+  @Test
+  public void addCustomer() {
+    final Customer newCustomer = new Customer(3, "George", "Patton");
+    impl.addCustomer(newCustomer);
+    assertEquals(2, impl.getAllCustomers().size());
+  }
+
+  @Test
+  public void addAlreadyAddedCustomer() {
+    final Customer newCustomer = new Customer(3, "George", "Patton");
+    impl.addCustomer(newCustomer);
+    assertEquals(2, impl.getAllCustomers().size());
+    impl.addCustomer(newCustomer);
+    assertEquals(2, impl.getAllCustomers().size());
+  }
+
+  @Test
+  public void getExistinCustomerById() {
+    assertEquals(CUSTOMER, impl.getCustomerById(CUSTOMER.getId()));
+  }
+
+  @Test
+  public void getNonExistinCustomerById() {
+    final int nonExistingId = 999;
+    assertNull(impl.getCustomerById(nonExistingId));
+  }
+
+  /**
+   * 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;
+  }
 }
diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
index cd90a6643..8511a577b 100644
--- a/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerTest.java
@@ -1,87 +1,74 @@
 package com.iluwatar.dao;
 
 import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertFalse;
-import static org.junit.Assert.assertTrue;
+import static org.junit.Assert.assertNotEquals;
 
 import org.junit.Before;
 import org.junit.Test;
 
 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 getIndex() {
-		assertEquals(ID, customer.getId());
-	}
-	
-	@Test
-	public void getFirstname() {
-		assertEquals(FIRSTNAME, customer.getFirstName());
-	}
-	
-	@Test
-	public void getLastname() {
-		assertEquals(LASTNAME, customer.getLastName());
-	}
-	
-	@Test
-	public void setIndex() {
-		final int newId = 2;
-		customer.setId(newId);
-		assertEquals(newId, customer.getId());
-	}
-	
-	@Test
-	public void setFirstname() {
-		final String newFirstname = "Bill";
-		customer.setFirstName(newFirstname);
-		assertEquals(newFirstname, customer.getFirstName());
-	}
-	
-	@Test
-	public void setLastname() {
-		final String newLastname = "Clinton";
-		customer.setLastName(newLastname);
-		assertEquals(newLastname, customer.getLastName());
-	}
-	
-	@Test
-	public void equalsWithDifferentId() {
-		final int newId = 2;
-		final Customer otherCustomer = new Customer(newId, FIRSTNAME, LASTNAME);
-		assertFalse(customer.equals(otherCustomer));
-	}
-	
-	@Test
-	public void equalsWithSameObjects() {
-		final Customer otherCustomer = new Customer(ID, FIRSTNAME, LASTNAME);
-		assertTrue(customer.equals(otherCustomer));
-	}
-	
-	@Test
-	public void testHashCode() {
-		assertTrue(customer.hashCode() > 0);
-	}
-	
-	@Test
-	public void testToString() {
-		final StringBuffer buffer = new StringBuffer();
-		buffer.append("Customer{id=");
-        buffer.append(""+customer.getId());
-        buffer.append(", firstName='");
-        buffer.append(customer.getFirstName());
-        buffer.append("\', lastName='");
-        buffer.append(customer.getLastName() + "\'}");
-		assertEquals(buffer.toString(), customer.toString());
-	}
+  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=");
+    buffer.append("" + customer.getId());
+    buffer.append(", firstName='");
+    buffer.append(customer.getFirstName());
+    buffer.append("\', lastName='");
+    buffer.append(customer.getLastName() + "\'}");
+    assertEquals(buffer.toString(), customer.toString());
+  }
 }

From e6a4200607614e25aa2457589cc0f65e390c24f3 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Tue, 15 Sep 2015 13:48:58 +0530
Subject: [PATCH 226/687] Work on #74, increased coverage

---
 .../java/com/iluwatar/reactor/app/App.java    | 23 ++++++++----
 .../com/iluwatar/reactor/app/AppTest.java     | 35 +++++++++++++++++--
 2 files changed, 49 insertions(+), 9 deletions(-)

diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index fcc327b34..975435712 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -1,9 +1,12 @@
 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;
@@ -64,6 +67,7 @@ import com.iluwatar.reactor.framework.ThreadPoolDispatcher;
 public class App {
 
   private NioReactor reactor;
+  private List channels = new ArrayList<>();
 
   /**
    * App entry.
@@ -71,19 +75,20 @@ public class App {
    * @throws IOException
    */
   public static void main(String[] args) throws IOException {
-    new App().start();
+    new App().start(new ThreadPoolDispatcher(2));
   }
 
   /**
    * Starts the NIO reactor.
+ * @param threadPoolDispatcher 
    * 
    * @throws IOException if any channel fails to bind.
    */
-  public void start() throws IOException {
+  public void start(Dispatcher dispatcher) throws IOException {
     /*
      * The application can customize its event dispatching mechanism.
      */
-    reactor = new NioReactor(new ThreadPoolDispatcher(2));
+    reactor = new NioReactor(dispatcher);
 
     /*
      * This represents application specific business logic that dispatcher will call on appropriate
@@ -103,20 +108,26 @@ public class App {
    * 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 {
+  public void stop() throws InterruptedException, IOException {
     reactor.stop();
+    for (AbstractNioChannel channel : channels) {
+    	channel.getChannel().close();
+    }
   }
 
-  private static AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException {
+  private AbstractNioChannel tcpChannel(int port, ChannelHandler handler) throws IOException {
     NioServerSocketChannel channel = new NioServerSocketChannel(port, handler);
     channel.bind();
+    channels.add(channel);
     return channel;
   }
 
-  private static AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException {
+  private AbstractNioChannel udpChannel(int port, ChannelHandler handler) throws IOException {
     NioDatagramChannel channel = new NioDatagramChannel(port, handler);
     channel.bind();
+    channels.add(channel);
     return channel;
   }
 }
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
index bc51e26de..2ac9b448a 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
@@ -4,6 +4,9 @@ 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
@@ -14,15 +17,41 @@ import org.junit.Test;
 public class AppTest {
 
   /**
-   * Test the application.
+   * 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 testApp() throws IOException, InterruptedException {
+  public void testAppUsingThreadPoolDispatcher() throws IOException, InterruptedException {
     App app = new App();
-    app.start();
+    app.start(new ThreadPoolDispatcher(2));
+
+    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();
+    app.start(new SameThreadDispatcher());
 
     AppClient client = new AppClient();
     client.start();

From dbc2acae5ffa2d3770c98f9161a97010379f573e Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Wed, 16 Sep 2015 11:39:57 +0530
Subject: [PATCH 227/687] Work on #74, removed author name from all classes.
 [ci skip]. Author names were added due to default eclipse configuration.

---
 reactor/src/main/java/com/iluwatar/reactor/app/App.java        | 2 --
 reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java  | 2 --
 .../src/main/java/com/iluwatar/reactor/app/LoggingHandler.java | 2 --
 .../com/iluwatar/reactor/framework/AbstractNioChannel.java     | 3 ---
 .../java/com/iluwatar/reactor/framework/ChannelHandler.java    | 2 --
 .../main/java/com/iluwatar/reactor/framework/Dispatcher.java   | 2 --
 .../com/iluwatar/reactor/framework/NioDatagramChannel.java     | 2 --
 .../main/java/com/iluwatar/reactor/framework/NioReactor.java   | 3 ---
 .../com/iluwatar/reactor/framework/NioServerSocketChannel.java | 2 --
 .../com/iluwatar/reactor/framework/SameThreadDispatcher.java   | 2 --
 .../com/iluwatar/reactor/framework/ThreadPoolDispatcher.java   | 3 ---
 reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java    | 2 --
 12 files changed, 27 deletions(-)

diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index 975435712..5c6d91ee8 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -61,8 +61,6 @@ import com.iluwatar.reactor.framework.ThreadPoolDispatcher;
  * 
    
  * The example uses Java NIO framework to implement the Reactor.
  * 
- * @author npathai
- *
  */
 public class App {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
index c50e4d3e7..659f5da21 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
@@ -17,8 +17,6 @@ import java.util.concurrent.TimeUnit;
 /**
  * Represents the clients of Reactor pattern. Multiple clients are run concurrently and send logging
  * requests to Reactor.
- * 
- * @author npathai
  */
 public class AppClient {
   private final ExecutorService service = Executors.newFixedThreadPool(4);
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
index 1f2694b0b..0845303df 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/LoggingHandler.java
@@ -10,8 +10,6 @@ import com.iluwatar.reactor.framework.NioDatagramChannel.DatagramPacket;
 /**
  * Logging server application logic. It logs the incoming requests on standard console and returns a
  * canned acknowledgement back to the remote peer.
- * 
- * @author npathai
  */
 public class LoggingHandler implements ChannelHandler {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
index 09f308731..4abacd86f 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
@@ -19,9 +19,6 @@ import java.util.concurrent.ConcurrentLinkedQueue;
  * 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.
- * 
- * @author npathai
- *
  */
 public abstract class AbstractNioChannel {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
index a4a392a34..381738ecd 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ChannelHandler.java
@@ -9,8 +9,6 @@ import java.nio.channels.SelectionKey;
  * 
    
  * 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.
- * 
- * @author npathai
  */
 public interface ChannelHandler {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
index 0ed53f8fc..78aeb84df 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/Dispatcher.java
@@ -16,8 +16,6 @@ import java.nio.channels.SelectionKey;
  * 
  * @see SameThreadDispatcher
  * @see ThreadPoolDispatcher
- * 
- * @author npathai
  */
 public interface Dispatcher {
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
index 089911d10..b55480ffc 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -10,8 +10,6 @@ import java.nio.channels.SelectionKey;
 
 /**
  * A wrapper over {@link DatagramChannel} which can read and write data on a DatagramChannel.
- * 
- * @author npathai
  */
 public class NioDatagramChannel extends AbstractNioChannel {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
index 89af20630..b818612e5 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -28,9 +28,6 @@ import java.util.concurrent.TimeUnit;
  * 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.
- * 
- * @author npathai
- *
  */
 public class NioReactor {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index 17f47a394..c635a6076 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -11,8 +11,6 @@ import java.nio.channels.SocketChannel;
 /**
  * A wrapper over {@link NioServerSocketChannel} which can read and write data on a
  * {@link SocketChannel}.
- * 
- * @author npathai
  */
 public class NioServerSocketChannel extends AbstractNioChannel {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
index baacda9f3..ae995428e 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/SameThreadDispatcher.java
@@ -11,8 +11,6 @@ import java.nio.channels.SelectionKey;
  * For better performance use {@link ThreadPoolDispatcher}.
  * 
  * @see ThreadPoolDispatcher
- * 
- * @author npathai
  */
 public class SameThreadDispatcher implements Dispatcher {
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
index 9fd539adb..4a240659e 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/ThreadPoolDispatcher.java
@@ -9,9 +9,6 @@ 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.
- * 
- * @author npathai
- *
  */
 public class ThreadPoolDispatcher implements Dispatcher {
 
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
index 2ac9b448a..752192ef3 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
@@ -11,8 +11,6 @@ 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.
- * 
- * @author npathai
  */
 public class AppTest {
 

From 570a30099e9867d2bb10ed4610ab27ee446831e5 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Wed, 16 Sep 2015 13:24:21 +0530
Subject: [PATCH 228/687] Some changes to further polish #74

---
 reactor/etc/reactor.png                       | Bin 124359 -> 125804 bytes
 reactor/etc/reactor.ucls                      | 146 +++++++++++-------
 .../java/com/iluwatar/reactor/app/App.java    |  19 ++-
 .../reactor/framework/AbstractNioChannel.java |   2 +-
 .../reactor/framework/NioDatagramChannel.java |  10 +-
 .../reactor/framework/NioReactor.java         |   7 +-
 .../framework/NioServerSocketChannel.java     |   8 +-
 .../com/iluwatar/reactor/app/AppTest.java     |   8 +-
 8 files changed, 119 insertions(+), 81 deletions(-)

diff --git a/reactor/etc/reactor.png b/reactor/etc/reactor.png
index 0b00ec98be5ccdbeeb74d71241de065e3d733554..abe705682f6c912858dcac8433e2495a1fec4fd3 100644
GIT binary patch
literal 125804
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

literal 124359
zcma&ObzGL&8aAqQgLHQ(4bu72-3`*^OM?=EGy>8M0s;yGA}uA|DWG&W(p{2gfitsb
z@9+DabLNk6aDew&b+4=LCrnjY1|5YM<-vmo=yI}>>JJ{kl{|O=Q;h@z{-&Sn()Yo`
z)hIbhh^9yS_A^9X+^$O=sgH7sPk-37&%sOOpfE~d;c7Mq1en1yJ(22o>zCz+#VpCp
z_?9fOnEFE&ggq>bg(K_}A@@5%yt*5^Gv8V{p3C_L!9ANUviZyULE(yuieZPnX-`M1
zrUE)DEF?G>e=$n%hxm61mX|ty_y7Ipub>YKAbPPeHY4I!73J3l3wfb`=0FN$U-WYL5cBv3EvyWXz=v!;7|DG=xjJ|
z>O4n0ma)O}WnX0B7eM&y-B@hr>N%vPGpZfXV+m+}>!6ExY4f?{e9XuQD=2VK>_=;-
znXI0tuXwsMwPE<}t4@rcxwEs`c<~OLl)_C03GT0mimEE<(^GmYt5+KvKLXlH8s*EY
zb{AJiGnt-|N+fjYgU=_1=Uk9Xl!eCJ4MTj$M7%%KN8bNIMH$CTo%>`sffT1XA161G
zT$RJDA*pyhxBbOIJVV#VkFN<>NkdW`8z;?7v)PoJS7TE6d|QJcOHg)h#zv>r-UmrX
zJJYoWRdA>nla;C|ySt}DF}1aYD;-!JwA`{o%rOrcK1<#$fxj4500NGg_`=DCx%Y3E
zZvliikMmo84XVJwd!FprZZ4Uf++3bG%uGbL+jTmE896wpXh*Ig<#8}%_qh^t9#BMo
z%U17Xs&jezy`kaR&*6_$O7I~wt7p4psT^&ylauNYG&M2sN#9|JoIc2d4+jHK`pk1#2il`J~r5GXX>Y;
zML(@?R@HiP$ymX3#xwA`?arV`IdQ=X6jd)x0VKc*(uc<9`MlWf{#?KXVCnOu#Af<)AkaA%R&r|vV(!i{C05W-RtsFL?&ST{*#tdgVEaBAa(C=u
z{3(N^(da|lKU3WgiROMtB3~YG>qbTHA;Se|X9tj5z@2=(kHesXDIZ=R7i32AIs_RM>Z>K^45D>F&cL=aYvztt_EU6%f5pG#7gnaRS^
z+rtpKrK0ue!$0ElobJyWsf|D)2}YN!pW2fCB6R-|-F`S))CDcX5Jbd^&Pb93*X03l
z7V1yN(hdi9=g6`Z>A`^(_Hxtm3c+Fu{PTDOIB|pQ?Ho^S)h<$nyL<=OE>2Lr9a!hE
z;_!a@MBy1@`CPxm7T9k%+q^y*hv0Krgxc4+2_RkVw>hNims`a3Q%?kw5_3Zr)~slT
z+l+`(((0hMH-jT{k?&+V9sW5u`E=e_=M!b-$S7thu5*XD*<$EP2`iHmgiji;MhllN
z&!Ty3$MWrRGx;k{E>5oBnul)E{h3?%t3$=I-|FL@1rQlFa{ObhIh7E6i+)}dl5Q5F
zRY|g61pXRC^t9yPoKVVaB$K7Ja~8%2WM95
z0=6>*CMun{zekV5Ms@FC8Bsvcz$_FtmDjuGb=#YhJQX&wGiF0RjAR4d^$L3dOmf4;
zO{o3zg3Kg*ZnrP4v)^8(r!%*YKDfRXRwcs0neFcTag0F$6lSiq!q|sCl2HU+zp{gsiR2rrg4Yy}&8r
zv47Wa>F{i#&DiHR1E;8OWVUJE*<4}B6)LLQFZH7VxX-Dn@B2TP$~yD#d5BL}2^@Z6
zwPo(9dGr+3qB-nI>_`^EQC_BcR)L)z+S%^2&Z<`2E+-2pmbmlmw_3g+a@(onWd@Zf
z8JSDY+LQ0R29ynV#g~uU<9vT}?YpSyTs-^2`ORfUo(e;SZwVEyOvHNMPeFlGAs=rR
z?5*{uKIf%k)EVM-qn`^TKkLBfT3C0LX9$!S_V|t9{%ULO=m-N>gKF5Ht6@}%nEg3U
zcPZ*R7VoS5cR$kJR%N;RH2&_JP{JX~+uKh|5W+jw<;8e@H*eY{7(wLbmt^6i3*XcD
zPqvz-8@xgS5p~WlFeFxzSX#DQd*TsqPYsAeHTIf}2fOpRSc9$#pIzEd$W2U>3k#fX
zm`8L|_$qoHedleczn~CIdI0HmYq>ZYgk`LDcZAiIl5LC@xp;t2c!xvE_`SG4l%0rFqQ~_sl6TH;Gw?*v
z*9TFtQ1aW*M~ysfB)bWAipN}>Ni{C+2+U4f=f6(iYj&@V`($SH)
zuWw)5{KCojK0Zf{Dh?oS&-j)D*V=_QNWE_>deNFtB^tyQQtr)FN{p#`E~2)%jsKe`HCnh07I($Q37CnUZl&
zKvS7gt}Hj-59`rj=LvR3V)dhoqqnYe+o;aZ&XVKix5QvM!o7XVQ>vi<)dps324ica;CevtC3M_}WD$U`Z!foo{2n%loG%EsOHhkfeJe|2#*
znsql#PVzg?o}tTiMrP>^!N9T(`&X>Yhe6(vf6#7a^!ZhC!vv3K+P*Tb-5m8VrXIQ;A)uQb^m=LjX&
zRy%0?-y0cdw@+0SPtnPHWrziZcIc&!)0ocawH)DHRYASiVshA(4
z&j(KMJnHNZT7$uEnt)+|h;SO@or*9V{$2e6EST|$8XXF9K2n!po4X3$%HKM>iRdv9
zHp}20K=FPHVD-^?4+FY0qiSHa1KGuX+gY9ap40kJZy3(AN3~w=LCxWcuUZ?YkNN1`4a9$l(SV|1maSP%ex1H{7vhit44vppD`)97MIwzZ>
zWU-|UrMHR+t!919??$p<{y>;1KPIPz{-iKYmvAYtRv#OdyD(?Iakuvsinf|}3H0@)
zv*cLcWOuxMMy;4juL`X7a#F+oJ)F~
z3pftbvGVoht`tJTUR($3qRZzfmr@Rb6JQ{dcd$9?KNAd-`N6U28h<)=soB4#_}R3n
z;fIp>oBhR6?1EqH_<fGmx`c^3Vdb_%El{2R7w3=#c
z)B{mu?@x*iY;m*yQIkdhw$XV`e0)cmV`Gn}u%axInNKOJ(aiFKiFUO^2Dl~5kTIPA
zfL%|Yu6DJ2-{3;m*3p5IR3R51y*5Y@p7K2{u(rD9Y$v=u7>6G1;(QrX^lJYa68Orv
zE{QHy0QvHGSlZMSCziyOy2$yzz+tkSY~yY?DMAU+UgO;K>kM9zN787=f?Ol-~)Id9eb{ik}9
zR5(57pop)JxJt>648`kG_dQOq{T5pA#!L40W~UbdG3PEXwsPv+qX~&#I*jDE0Kgv>
zc0>i4osqwN-KMqIpflLkX4>}VH*~MzFpcky@Rn`=b)JQMJU@A?PZjW}(OfW}wg1YO
z^mXuOR5SQfdccIn!CHrn_*27CJtfyif7a!V3tVd(1I^)HlWUbDrnz8EmE(MRZRbRV^<(TWdR!ri(_sBnMD35a^{7y|+1K;4
zZ6)cbab%z|vb0GV|AVfl{0di^Q)$|D)qWsoXgvE$2IJU?=HB8UjEGrW^Wr%hOiK%n
z#rq6?S3a14S#1j8Cm!JHp6r|U@u7)X0A*quSCiUfcgBrH*Iec91GLeeH|Ho(wkgxP
z{3#hWZc~Uy^zxXjox|5$~pvhXKjTqFg-QSkcJiS;qMmrL>!yE7c=}
z+7lvsx@0Wfc?e)$Pt%@@@6B&J@F(fbmFq^(BH)XT^#=&7lT|FZv6pAQpH6+4Fy+v(
z!`k0c{Wqxqo8Sq*(|c}PTH>u0i!v8WF>sgDD~UkC(gB)$S7|8lR@34u#AWh0rbp2-
zL$7wKpQc*#IvD!NTBO8b9{>&^%r&!gCgOJ71{d8NK;TvjhY%o
z8N0)WW8NvK2fpjlkQ&FP4u|QqI*(L7qlk}UHybfxqK^H86M*<}2kQeqkvOfA@rio6
z%#6G1R#-*O`CJwupl<^7W}zT#+{k=-MDnA?8FpR3+FGH?mI+3dW^WrP0)VK}9JXQ3
zySrBW-YN;i-arj{R##PMP>qrH#ISyX#B#LoEUKZQXJfbryFg|bQ^Z4MM_5}K++yqw
zzprp57pUjcYhsookZ2GNpd}<_Z{q*^vG56w@*zFk(tm`{&qD9_%I
z(X@s_>cy}`e7x-jNK3Sf-i;M#kYsXMV>J2R=I5aBCN801?_~vFlonO@#vcI)@D-w6
zN&VkzvBSQw(p=js3sp5gKfNQ@%5-RbB&6(Qf#ct8329sxwpYoqEIK}h>^+mKDy)Em4Sbc10kv}
zWvR^llg<;Gtt*KQg2~0Nv0jiI(=c9p{m?zj%Tsn|5k&~M`s0YA|Y@Qx&LnSo-}Wdlx517SiIcM~knkDk@gN<`I7NVtcqt
zms&j#usDDJ_YoA{`{Wvdy~*J}21y+2f7De&OcyU2Un{{wRjuH4MF22|GkrWE_C}ZJ
zuF^qJ(Y)m3$Q5T6T6oUA_bG38XX{Pdw&|5zNS@~NTBy4mnvt^VvJZ@nG4i;rZBKqQ
z5jzh@%7QK}U8Ph_mYRyR-syet%qeBg1YyUw^eF^}E;mTQ$N47hp^ZSP!62LZbvDlhr-MAzYRT$=D|+-;1HpZL
z$P9=wtVV`JsTq{{5&fsVOz%!6+CtzlFs!Tx9W*ZORjK||EdPfL+H`X0P_(YPUD8qC
zisWH@%q}I$t*a4x>q)95VX}Cze@((@Xz~`ldiuf%ezoC_fFp}_1IkB`b-z=S`yLYc
zKA{uk&+dHJJmsRA1iL|{2ohcS)L23WDu6ZQ!(Jd@mhTLTVj_)XJy1k{V$4d*1VcpB
z_b4^9NjeJwPxC<=eWkBEchFt2w(&O&A+iXk#Uu@_d-2>6Xpn@6r1*ID`}q)Uk)kqRcU1E$}i6;S1r8cxzNNIHhcy^>5_9MP|gr73OYwTc%>Zct_S
z#9}23hh)SDQxo@|&gz>qhiS>F2NJh6I}@2dbMxSLJlIZ#D<4pq^}#UxgdoFjzqW=@
zZHL@>7SP4z{`=?`gRbB6oYK-TBvFr;==~fy2Y|we*|WwGDe86dlLBb_qkk8?I3&WkC1w%zO2ff{eBHf*;
zA(%Fimzyy&Gg>oLn&_8p>tK#`^*7su#J|eskhcy0{D4I$GD9vMs8Aw?zB^fgJJmBh
z{74+>pzY1%Y_040R3$S71wm*b*x=5{3=?n%jP4sh9~(ZN$u8Mr2kH=qd3tt@$-#fN
zmMb7Z2TQ%(+i(y|iz*$XAM0iKEbmfMH?H@5jq|U`^BMmzux3A;!nhm+?l)o1#usRl
z+;cB4b(2?q1Xh&}3{LzeYYlzafVih6JfYu#Y)l^D~K0{-aW*`Ae%*!8T;Cu5St9{SFtqNmTA3zlp(|Sp1II
ze{C-9YVQw?&J2FA-3erHb8~ASaG{dE=PNS>=O}T+1f0nvkDV#Xe25K|ySo=-F3`R_
zJowN^Clsh>;XKESo!|lj86>5CTUmDvycd=y9Zc-&Cj0QEz5VB8lh;|4VZ*z}HS$CF
ztgfDsW&nfYvz2fL{AbsoVrJGmFT?O`<&*u-@hZ7`<*u8VlloC3c|f>-?-obKM=IiW
z0xf;@61QWS$XE%W>R*Etf_5php!ArUo1brLm4R7!{Y_9q0~r|tN|ObyW*$PZ
z+JXVyF$s0LI@eE_&Wk=6&NF8Gh>*yZ{2lRKntLFwqy!vP)fs-|W_A?oPDRXue{&70
z6P1LW>9wKZ7jhBi8sFRX&_}OddmGNo*!kReW(rZg07OMl5U1x>Cvd#jk_ubet~a3t
zkXgRzy6T5%EH7NjO{D3WnDAp|A0&=`l_Ocl15qhlaU`NF}lnn4%fS
zWO*K`jFn`D$mSdR$iw5QUJ~d?{3WDP$NqJ_p4%dG6B6+kiI-Dz%bpo(;lw$9J*t|V
zORZ?&y0N4;gHw-@{qpLMT$>@g^3Q0rO_65E($d`PJh>39aj*kKF6}-oFuU7>UFhz9
z36I)&vgc@|`PJW&&dI%>4&TG-4KaWMr>AaZUq`ws&3yZ=(&0m3O8OMheNMEnT?ly{
z9?1J%XtvG0qvy`|6w-RJb7aZjEwf9qRSuhJ`!W2{$5Z`BVgCbqyZyM38JyhfT`Zfw
zy>xZ9v9><^m5B&vU2B`Y{z>uiiKy@X!dtxx>GCgdyHU06FoXRyZg;ZiOw(-d*W;NLbpPi1qwBAzs;XU%*Wc@i;e2sHUZ{kB}i8MMx
z0fahMm*Wpt5(IYQy~6hx;cBTvn4bO{P;8(ja{u@55<^JO#|D?RP(_8g`wq(ZdIK9E
zDeT;%mhXKFBZz0sN8|r{@&AbZ5Ej$a%I|DV+o&jqaqg$1g=X*}c!|Hy=J!_ikUv5n
zTT;HIT$o8%(y*D(M2ePx|_Us
z9Vgi9crSqd)p
zq2Y-d)Yf^Qw3(b9nVOZW-()}$n6Gsu`F4?HG)%z$TNJRKT$c5Gj+}X1;cJ=ia
z73wu@GSMi~5$l4^AGU_FU;Eq&OE@KFu^6r`Ngr@!a#}itV6ap70gpuCg=9^c`L0PHiduxx6g!9}Kihe{yq<7-W
zk@I1JTW~HVg~)cSzr_>~MNCXYn;asp8D~P=mBbjVpa(%?t9=_Yt0*H`)zy6fVPc88
z4>srT6vq9yyTz-{_+p{r?qx*dW^e@RJJ{d-L}Jql8t~49h_n9W2lY
zSy?My!l<=p0w>ZBh;Y?CJ%E!uf3AjvM&WSVhFMp8j54wSB(m%bAz?DAAS_XEzhnr8
zlsxM@JaG1}*_8mdQSOe$xPSb@pA%6YKEBf2Y`fKZ*aM4>ydtWibWw{QdPZE;|9vux@
zFYmX9p@Wq!$U%sYC#Yz*9Y=tmi=)=oO-no$_VsB6%ECgk5g)hhSogEK)<;Mf@38=R
z%^(v5JIh%}hn2=Xv>Y2p!5ScLL6;Ngr-dgFgPQ(T?zgdb4_V)fB=FBeG6SWyGZJ;;
z3r*S8J!r>kW8HYaHe%K2JZ%!+R;`kMEdqSF^m{3VIQ7mOgPa`wxhq4^D_ot+UY(aN
zfU-m*eSC7@>X0ujp~wuyR#@u0PseH^H{Lkn?tax8tUmW
z>xq-Y-tZ=)j(zZ?P$oJ`N{U3l-68QEFQ$=>kf@KifHhcbf-MCv(EaN9
zpH9CUU&k^-kAUp`GjMl1hjDIS%L(&`(PhlE-*>-iTf&sIOf*o$Vr7#@(U7
z;|=pGuRl)kx)$6DY>gV{PceqInxuZ-SH^RpT{njmOc$CK}9JX}5-#E5F9?o3?u
z@wvyjMU{5C@ddbUK)ynwQ~~O_nH5JYNtdnj^5yhQV}^lelir88dptJOeP2NT5m4Tu
zUv397K|@Z*Z@rmeuww~`)|r?J$t$d*--f0zFBY@_y9b;k<5$18)rJ(t#)JVll$C_;
z1IDFab@j_>vDFzcV|@Gzq=o&-iq=>fvPb67&m=fpfw>1~XTValGy9O1N)&iS!t+HG
z+-Nnp3A=y0eJ6*O&PQvRLf*QRtk(d#d!H{}s=Oz)u555)=^GpCo||j$S7Z|w77!Gy
z^7VC9QITO_2nU;mlEOLh{N=(pI&|nq*)M?MA|vb2$nDxB3$pyLR|a8eZ7-_T~rh_ixT=46+bhU9|c5QXr@h
zd5BqtP_0^4R}xE_fL#h1j4bj_J9YL)pc13n-z7G}H1T=tFF2l(tfW>{(3uq*_7FbJ
zKLf=u#&=sE@)*k;2O6SOeBG^
z8~WW-oO*4o7+WW-Ffhv@|1KH>5-mt(;9q{!?dU5y*pii(#~j+1Drxr!OV!eXwKh%1
z@XCr8>*2=e=55EL!W6uZcg}q_K9FRPDp%0xuQ1!c?Hy0MzM5?^4405R9A@VZZ3YDa
z+$*RfCb|=nJl04E2(OBb$hzld0>xnN7V3pfCeWJXa*nL*r#Hp){4Xwc;^Xi^VWMX2
zE_5{3ARs6_n=f%+?z~x8K#q+auKB=EN6!i`Zrki<#7s|PUK>4yBbKl{S|8Dyo6!`;!oXMr)+6Z0q=1a7pBeAKxbYC)13;JW5fq`SxlRtXU@dyeNve6v{14#Gd@+Vf3=RK(>uuIOz9zxqHY1ID8sm9_#%X{l2~wkbm+u<9BbkXMF*
z{0GDsK#te8IMxJKC(7W0fU!h64x%EAvAf)_PN4M1qXF=_TRfO#`g$dEf~pQN??55y
z-T?}6|M$8K;krmX7S>?4uPa5k4FGr7auD@E>%83IuoZGh+Nx}Rz{M)1`CP55J#^U}
zEfj<@{uxR;RCPwopExJ+!)Va`qyw_JT7Qi3Hya;3W)@q-b
zGx2V8?YO#J$WKX*e<`wuXm#$;ppz+%*bs3VSMiT7;*Uy|3BzT5h#QIFgoQ}qj4amr
z4+0d+%Qsu_)lsZ|9UhIpSRYzCST@HlkZu)wSPKv5A*TK8+t=~tEE)@PIH1KzfD}#)
zf;mzS2hVO?Y}wUfTfpf~S_OP+fcm*OsyT+N;6OOqv?)xY-SDSLU_(wwQWWm|iN?fY
ziU24pk&}_pldpD7Ne}2=OmvO>mB9WMy>=j2wh3mq
z(OJ4M7P*aNXh~IJ(ZtM3`YDMbW!7nz?qoNMsrts}&zgZiTLxyYw+7U4=g2r&!kH#6?#yrz=4EPMLqO-AFb4}&kHF{pZ%jQ@`I
z;1dyV9{rG^KqIlL2KA3ej&UH>RhlJ~EluM2lC2Wy_d9jI{C@;zA=u&w4Vy9vt1>pr
z)SDQ1k@(*O-)IkCn}M{4&3N%XP+CN9&fD0UW@rae3n0$klce%E#qm)JAe#~HY(rWX8LI)$=(u|dpYX_wlRWE&?zhuLej6F#ls^6Bogr$>QqZ=i+9J`g?r$L3nelA)ji%@Q7bR)YqpA
zNH1l;3iHW+TQSvOP=hT-R9-kl>fLvFD&_L5_cTuA9tP!Jybu&!JKdQ9>!#*!^_}=+
z*WPKZUpuu2_vvCK8E{knT`j_kGCb@%aDSC}zdk2%qnRl)R~VD-I6fjNGnYyEJj+y!
z=WhMS)4iM9d&MDJ2*G=@ydbgcq1MZ0a8HanD1K(JecnJEg#E9?=MVx|rUDr5?#Pjr
zO54DTQ*IX5E!v+aV|~dgzm{NOg=M1Mh=CH_qzeCAEDaKSXg(2V+p$tC?ke!Y=0~k7
zQ&l`#9s-^!%j|$7*^4PqIdtJwSuLo}SY3z?3EUU1FJ;nru2bxzVT*QGEYwtE_NU%H
z&b+nlnKd73n5}c~9yI>gua*C~*nz}QeE@@jJO6|+8bsMDBkl|6U3yA)1L}0zf@dc}
z{O~{zZJ6T=DaVJBGUw!$KzsI3-_tKnE3z^`a?;S41%wNGLnJOn7`VkR+^T|-OrEp1
zR+VoqE-spwW)JEFq7p>4RfbAF2;m#8v=#IT0}@qYt)X*7jb!RScuY0M$gsHPC7Urm
zuj38!89gg*RFv{E@R=pdX6sYiP=cpkIG1s9Zf>uRQf&NCG%%p?^1|WbYB)Z&v6v_|
zz1|p}o&3a+lym_Y)Y1otuP>$r%;UsVqPAzjYgr-y6`C2;I6-5!+|mP5%BprBkqSW~
zX9t=}hMauhRm)PjLc#^*=Q3zYm}<~&&uQw^J|cX%{hgr0L3flqp1Y)Maz=Q}-}o*e
z0m&1Oop;aea7Ee;MPPs2Sfj0tfh(_nCT%9a^Y6edr8Q*Zi}sSBhCerzjldH(_Ux4@
zI98%+;t%T96=9Ne_hu@HFl&Y-79t=zpp(XPGF{GeR!T8pHD^;kO#5oOYYE)`{aJTG
zN|LdnG^W_MA3iCGcKYEx&kCOSk^o{{KzyxrG|ov&i1{AvZ_?80P!1H)0Q#=8RA8@0M}7Bzt|utBW_^2GHx#|yur}`DP79b-F){WG)8$v=Sxn6SHhW8BsOZ$DFG0;Eg6yJSjHQS8dCmnX=Ayv8ojU~{YX
zKKhQ|E#&;~xpiXC?jPaZ<@Moo;FioCu)+zGkGm6P#Goh^iV^mnSksJxcBdS(N}pyNS{pplPuCCCUD>hui2_eQUrl(c;>T
zH4V-*R(D@`2z!hy9b7y<_C~t8Vfs7}9Hy!rcXxK;-jiPgi`f_*gK&Qk|HIM;;32R(
z)xMb1eX*aUE^gP*W~Qk|Aw
zuS;!)
zYR26c2XHAR>V`r0i(-6CWm;RK-`uucIgwJwWlGnJ_5hhuSeR@QDi&duDuk7zS3i+P
zB6qeunWzy+_;djv$Unj8w|jFRfvFCllO>Z5DGjTd5O3(ycm~Y1)_~(BmyV+4!WIz4
z*c$bc(Wyp%LI39R<>tuEZXFq80*JPLq~w405cj
z@|4uS;>LMsVDPb7Or@%wRap4jGeI)6rM^FhT^GGPQMoHB@f+czJc48<2Qpu~udiNG
z`o4Dp$#qq3MqCLdp0O?`lw3-j(|La4=?_xz71q@p{9TR#H8$NsBqS1OpKopi5fA<9
z-f9Gzm@dA0>R*Cz@Z8ZcppY^~QR$^h#?+T$hh$mA1ZK+;qge^@dNsN*O;R4mo1T-c
z%MLQSy@A+qJi|u-kYIJ%jWWp-aetl%>GZ=VpS*7lziIjt!vRu8MB)x{?7Kqt{=NDM
zT}tk&BAZE3>ic%zR5`3(sDknEwU(Gk!NR
z`CfD52{3SRSpi*)Mn*vV>4&oJQy`yqKYRt7Ib9vHsQ;9LhTR9JU5WfL
z5PPjk&@}v?x$f3W%kp6HJA|sLL;kgsa}XxmDU~qCEVPRWi0UMb^Uy_*WvJUu*`yzY
zKpjipfE4v(HMJ415(e5_`Hf-Fae={9iBx$6A~@+GT8sk14OJilS{xDZuTz6t0>2RV
zSog91zm80T2D-!4R}j`L=W_--&~}U5e(EX6OeQupb%7?6zN3n7E_5G(p2VcX$-;aL
zCRxjghlU+*`3OF*gO*Vf(Pg;%XEtt~dQVJ$54P
zJp+2qeLl#kCfyM(1zdzLUS}A<$c~epza|&;SpZAZca;WA3yRvsY|7Zi9c;q&$Fl4|
z00(NW*7rMy#&1e$gyyClPi#Kzfh!U+a!Xz$ZgFujm3n(e
z$Ew1?v}04jC4&Ox6(U`RxWY{ucEWxuL!Fzw`)`+b)z#tg@xcWJ#b9ax2M4l^@5STb
zz7;^Y(s*wrsbAw+o^GpwC^b-gw<{^vr9t5U8PL1z@F`*d5hiNdUFT4vkJqOMvDS9m
zib-Yj&@;Ca@iX0nrO~i2JSpo1*nOYFEN45><{b3QG&iiNb_-^
z+t|?m>(_iB6~)wmPznhA_kK}VqW@!fQ&;|J>1B4vLq#xw#zNd~VyipD+!o
z9iAzmz{0}fFaP@0^>gJGweltlnHyDJAXr*H&_-tikD+!SIHgaYAO0xNNFyVo!ca(F
zXP|`x<$e=L0iqP^Z2~W$qOUYnL85Q3ahfXjCY;xO*Ctuo_9uGW0J4X907Hx>q;^xMCC4!1qZMU3H=J7{cpok
zsiGhdz)4IDNDr9&#LSkwtJsdu4`4OasoS;G>tYM&>6OLrqidi8rSebHNH0nCaGna+
z4gmo{*9av}h-#Q3E04{PUx%1nIh>rF+;$xJNB&w32a3_VjC(Qd7!Mj^s78Sn;_1P+
zvf81L<9ML-ZlzPj?czl_P;QZ)tOa64L}n0SEj%LInFe&EYOf4jPe6|wct6|8&qm1A
z={fj57ZIb~c@If82jfvJp6C(4iqB0CqK{g&3SmI(0~7sZ(Oc#t=Wt$MD8H{yNN#Rp
z4Gg#rzo+wi4`t027mtB{9V`}X9l0IpPZueFk2TKGfOa
zW@g;sAnGQ#vng-eISi`bD5mjf8u|k-rL-vJ2X%f6kp997bKGb?-t`V)hv7-62i|4h
zC8@if@HosYseeMazPf_Li6}Ct##dzjl$-nG)d(~^5D^oDLc}mN0buUp80@}f+^P9_
z^WjgyF`jnwUtkfJq@!LiKkl)eyTYl`8wZVHTjPU)p}<>c?&|6o9VL#9(FILlK(Jx}
zxo%Brvzx0UF)_ao$!`ZLV3&lAoGE^kMyKqdrlyyXxjk#;52BDykbNCic9IShIdoFp
zZ+I-d_CWsu=4C8HA3idmc>YW693a&+6uE?Q4EnjWDNAj2_`Jr|4CyLKQa8>2Ru@LH
zKsp`xkY(S9s^@(!l}gD+M@JJk+VpP&Nar*ufZU@XFTbDoSovskl*v+_Ia*^~QB)
zYYQe;wzd|Qqs!+9m7!%7T#z?N>4Mc6_B3#GJiy%1o&k412>yIGx&=`RQrwjeR=siy
z?7k$H<$7Q_0)4fcC@+fq+RzFOCO@YJhM%7a1g*V1PgE4bp|cmmpzk2GP_ylCB}l8{
zAx^eXz7#l7SIO^eX1W)Z5*Mc`ZL6xPPESE4v)b6$2-T}`%Ff8h2o8pa!G2GS+YWnk
zb0aM+O;1msnwly*Tx#03F`P%^bGkiw4*gP86c`w&hk&kEWD0-f>`YP7
zANgv5$!uEhb;0AadD-uQh9wZU08I;p*Stn;dWBce7}a<+b@c$R(7D$-ejvXAqJ>=(
z6DeNEK`a~DqBh8*M0XNL)Vq8HV^kLp4K>|b7dj31YRCDxa!Une<$=&gG!u_yWV)8S
zqVE)$!GQrcH@D8kL?#^sbmAaKxI@ek*^PyTeNfAi*^I?a-wSyj?k~0p2nb+Oh-j9}
zzeV?u;t#em=u6ts=jBanZ9SQJs|1>fz=N?aO!|4r_J|fj>8tFgwM&c|l2{CuQs3^X
zyT3$&%LPP8b|pU%x?f2d!YjYj8jQL#U43?Xs;r{od$0tbU^-o8Uz9sEJ}$Gz0iFyK
z10yOTV&!lV2<*DLl9F)YXlQ7L4X?OI7W^K1`7Aw3&
zBo8Vs&b|Ehp$wW_-H-|
zLe!O_4qXaB+
zLRCpK)6&AO0#@BU{Pfq*$
z`zd!|U|=XW`PeuEJlf&l;i)<&CirM*mKWPXz%si#J43G0`CVhO6BF?adT|b=Vo;kU|H6
zO==0wzN4d=)u-h5
z@l>Oy=72w2y(F<`|<-ojs@lsb6~|VHr%;jUt&I~P?(2}Jo-H-
zx+g&?FqLe1bJzHGWU+=!R`a(Y^IHoDGT;Wfd;CI{ngS_*Yt0sE;+e+qQ732_XVwSe
zgs1Q3HC|<0_}YR7t^2Xqud2AV972bl_;SNE1cfBkSM<-L3E(`p`OOH4jNwh$7sc9Y
z9CjSsczNr>a%aG}F18i}FTu;JE+$wRHZpasMgA3ciKd)F*B2tsmiB<1Q0}3i@Q#EwDIBB#
z37#mixQM86zlN&eaWm>Uy}%ox6v<8geEUoK%PTOz1bDMSj?x?yNel?xf?B)hyC28a
z*boUSNA?44*``t&(?yxKTT>rCj7N`UPeG#(P>}M=L23OBbpi%EGX(U?d?iho22mj0
z{&apLChhYkZS(-p!02b-hS!NKUhcdw_JMd-Z
z&x}wDu6)Ah?x6Y%cDEAR&tsE2%qgzd96>LN(D|deS?t-#5BY`1!9G^Iwa;Z_#PKBN
zOg{V{ZdL^_nY=3ZKz0D6BGZNIzW*$L5n{If)XOVgr{pcL{W!Ttg
zBYCr*9}we>>T2x^D~1WdH&ApXABXplTYStbPhHS?CQ
z6ugy;PNBU!nc1BM9ej`BVmGw{(|B0WFf;q3e~dd05;?)w{~w&@6yQ{iPiQ=xn==*G
zI$T`BLTnaR<*!~Y1i&vF8H{E6k~1>Odf1l(5l9rMYk*#50q+oGpPy_+ex|*f3QE^!
zjK4JBsFumf%bWRXEtyL6$slXNdIlozjUa7Rnp0y2ORoh!%?Z^MWfTL|bxjHZCT>sa4a@mTeYf9#
z+M_13`M{paQ)zN?t$@G_36ZKwf<(^WH5e{6hPN_w5z7~#bvg(+@N`@6VoG01=JG?r_!vrSoEOnU^-`_EPg=tyT8f~*Jdw(g80%DdfjwT;
z->>6WQuI%zcR{^x0$PHeeJB}5$PA*1HN7OD@oVE0^-poZkpzW{?#bt;D*tfT3mKZ&
zZV&|%pQM}+3Ir!4&Du#Le4ClKQuj^M>r@&62js#y>7P1~RdQ)DLJ
zk3=svzmI$>fSko7ES-ZJ5e-dXX}dqQ?dWi6YutCd_j4C;`vcaHpuyb{5vyOm5U{=7
z9QFDInk}EKqjSIG1MkzwrBpcqx1F<*G;$)G5bb{R0?!jo04(%T!Tpd*^uvzbU(EBp
z80RQu_2pFr(XL0i_O)xQEbd)V<7`%9;pEmGD3D4wtJ9K8a6^eqK=@%d;TDJbUqp@f
zj;Kvow3nWo60q(57_|q12DPvk&!iRmBe<-q%2%(!n-^^78~GDd;^`^CZB5*2mx%Zj
zGhvRx*Mg>5NLFG5Xm*L2J3tqhG=TjQ*WCm%k<8w}!j6wAc?znu8h8w6z617?o
z$Ncg3*fJW%V11PA-Kpn70AYP%lk)biuYamjY`8H}pfUVO$@JnNC=32u5DKEbjufp+
zjtmKe1xt~I)45xTrTjY=xCUtZdV2xF(*f=yU`pTeZD4~?P`f$@(2(~1S~)-zkRv-=
zWTv+#C@2fq8B{C!Rm{&sYrTITONDp(UfP#OMlOP#0qCkl56D0`PGXb(A%Q>~$pS_^
z?Si$}g4j$9Rh1!`570wE{<`J{xQna5N{B%GG>1m=9pB*5FLw|$4_~ITZEK}>`7M?M
zz^t+r7&M4#bOV)Pw80Cp6eOPF>1%<*nUC^HqJcgtf(&A56XaSnz63z2#2d87Di~2w
zQ5_u}h?wN0BHkXJhy1Q<5!u;`fbCLNIYSE0+N?rZNQw{VW5z=D8
zfOnZ(UArp-Ih!hz#}VT_zw0?T@8D%0&2bQSkRGrH&8;9}7@FhqL
zx7hlt>VYk^j6u~88aUcL9cGC+K^KAZ6);K9*>FH!`~wwdT3g8|=ov^sed;+{oHM6d
z5=LV#qe|3|P*8`zDwSB!0^s1|0R{lcsi^~ksgAI5a4hM)_7@=f`otrYg3R|Q56S`$
zv-13ns?R^8bS-UqQ(G+y)_ba}E7%^^YileU^d`;Kr{Z8Ow1lOCNS3Wj1q{fY`2Qu3i+YY{S@}Eu>+ajJ4T6e
z0a78c$S{}`_*s-;FUZ!wIZSW5djSF9uI-*6BI7W@ZcG{tVx5_+vES;AzS?+OtUTq(
zV{pJ|(pGiP56i+V%;FufUFx2Ar1@qHbTSV_5^}UoOnB@sv<%q|z85CpcL70!jDmva
zii&7IS5{Wg0EE0cKNuJoh>2oG|C*VYm>3cg0*II~I;&v~);KlxLsIHFz(#-mJgg*<
zI={Shb%bR#ZWLl>Rx|=Zl@-4|82BKcMAWsyz7b*9wgTVNULG{4!aD2mB$Wujh
zl%LE-^@ORVDer~7TtK(J5NY1I<>OnUCHMK)h!1}sZwv#OMqJ&f&JFz~AE-K#7XwtN
z?4X5$h;qC(66HC-%X0smK7@o9R1OXf#VgD2VgF&SKy&*lW)hlc1ej+4JgSq&`cO8Y
zch4HV_0p}*c4zIX_Dh;>UY*Ul^K*L~ud7K&v{?_nU&OTlO`SSghw2sHzYhU#Bq1a$
z4QpXgc@JK|VsOCmlnczJp0E)1dv}en@?l?H_hjp6pD!fV$Dk99UD^vSMAg9
z2;yY*svQMGu*1K2Ve_A&3^px)TV^=V_R;-*HE;ef-LPj@y`T2sjY}-(FUN*kwj`zc
z;>i15z7a3DRZfV5=HqU<1MX!yruO5bU1EfpX$R;EzkY6H)J(%fQS5Q6uK^GP;jzQZ
z$BkNe!Bn|-T^+O~>0G`JWjL*A^*PZn=aL{fXfXN<3uZvzVQ_X+lP&xg0CTJO6UBI-
zmaep}Qa@{20_{_JEATzbD_)~?DDNdxG_HVvK<0Hma`;{j4i2;Uvg^h8>6DV&kBmV8
z(T9z8aj7B#4RFyv>VmA#-4JhOW@ZNAR^gs9x3e%KFPJVZE_&X21@-L>s^SN|cb;)a%Pazgc;u6iB!mG0Ly3?#ixnMnqDv=Qp}703Giav
zfjS^GD8Y*l@G-j2AOGm7uw{MumM9Xk-r4?@M|6W5un?)hPV@F7c)kPL>z?xlT$kPe
zchFx%P5#AmycI!t1H~ZcPS(f9e{`&E4=}s{yfXnNz4ptHtXJ
zX4R!g|q)h7UBL!7J=gr
zvIu`3NlKR60(VT!C%+wUx(1uHXH`tQAKUPtb7&iAX<0)a0^)A+*I<8z%;5~sb>v=%
zRtMG+auB+$=$eI>l;HiBa-jdx6La|&l`H9sD|M?t^`UBwZTa^S$n4bD}aNnWqvJ0zu^R*ZiEF%eGr57Ji(gdU*NE1eE|0PXOQ}Cn)$hw6~W2~p*0Fz#;
z#UF3u3V2(`i==rr@m58U1~}&-NNx=V0#@{xMX6*TR!e00!dKQ@NjD`f&1N2Ytve{(
z3}d?M-mxba-_4tORV0X^1AX5A1xEnksRt>?KO$TzDBe1i%xsUP$<)2!hG;b-gMrZL
z4&kj`&>Whq4HO-|yiQKS1ZhLBQ!yQ7>#X_=K#Bc6y9}DayDNy{K-eh|5Ck6kz4gX-
z1v8j>7>St>A~FA}`cij|DLDcf;+T>?`_iWGCc~sLfDbl
zGFQ*obSiLl8`zsF^G_?^r)=(W2RaeFp8gyDHkIG;H~KBYN2geVlwAi|hunp<9+rch
zRcBL~uo~xWrB8qq9qsypbIbokx*U#^`>$N*Df$(xoyZ9Z_w*$tshg-6n9opnht)n8
z{KE-9Qp{CfB){2t-7Qfie=o-~H7|rX4v(bHScr$pm2l*WArnVMgG|Car?O0F?
z0dmMn%vBAaQVVO{mkG~TmE`7|vbBpJ>*;(w2hZrjcj(=6?q0QiJX&iuSPVqvA$@P(
z3P|foNSL}rvmWD{BX|+P-K3QkBdvg$_VC$*-*Z4!M@dNrq>1qkBgj7&IXt)P#TU~Z
z(P#qgt|ktB{0NadDsyA>8iXr&HyZwTIRHX#j3Rs4B9#6az)_g<1PV}vBX2;^hxgsz
zzc-k&(FRiIy&NuK{si3h&i8*Pcvl0xsnL(-|CMh?@GbrBWRit(Eh_k9=ad#2m~SU
zluuHNU1qF)E%o86xuL;8`19=yMDzVsCkg34Pzp{6?h6ijo~aBUUtc4!QOHJQ
zzMiFV2dYR}NE`c(!L7pNe^E^>zp4?FXdVd884*|fg2o%Ge?$8ebB5lWXQN+lu>U4*
z5W$HQ0<#7%n?L5y6N-w|n%%!#!u(bDN`zd>;k%AmtR@Jo+JkJtQx4w`bm#z!5ap52
zPfjMVqwN@#sQUn-B6eKJ=e{JP4WTdck~g0}--cu`D`2#KLH$JvnF;{K%Xdr~D)+2>
zpuDKY8a7|X*auqffq`Vj?V={Z8SeIA+hiVJY{nBGmwHrX$g3T^yxu+!biir^%O+Gnb9(JvuUV+qBzPR=bO*KfS*ZNt&oys
zF3p-(r)
zQ(rt2N~7JPd!+foM!u{+V5=*hue-nRuHDRgWR<=^!e5kOh`0PnMrI}x6B7!UfV!+w
zEnUm|eE|cJ@NiUEnl1}am;hlof1fOebTLpm#wcj3Ek!*4$IPy4l3;waHZh@~TyJ|$q}&x}hu{WW)#Gbzf|L
zj)Z)ku;3jOkE?BXz3hI;50+vXgaS1~*)&JeU1IrhmbXOS$g17UkR>w~Rbv;FYGES1=Ew(S+-Fpu&t8^I;ttiLsgWuk(@ukU08VE^z980jfVg
zy<_BKPGT**0c{)|K@aX%3ELwU8;x9=|LFZXZ#qLhuKIAsn>P*PMdBT1_FL!*p%~oSY`~27$1e_0
ze-M2ZVP~8Xg4>ZLBX@84%U23e`iu?QwF74m-G_z;SsYD5*WxM?>fkK|Kk*>x%I2n5
zKEo~L@ac@uA-fvZTMlBzLw$0gl%*JDvtokgJiE=mr^8s;4d%fbUwOT{rt&umto-hY
znWpKDj{mm@0D*u2H+LG9^oS&iKZUOC&(<>+5s88*7KX^%-~DvFsU7XP0gFZ5%j026
znIpE~Wnup>X8jwKX>`d?2CsG8d(hmJ+L+E9`I`(MoV*H#89v@p4Itfsu)&WVM~azI
zPrTLD|AjLQ`2ui`-v+_-t@(jm-T_ApR1)s`=$CreUChg0{gmy6XKF5@
zy;mHpb()!qUI2yYkfj!F;73rlzZH9XG96}ILZYRLdK+nuj*j3wtrugYPooL?7Zk9;
z*ZcJEucwi6-#ns`1!2Lo`yEh(DgCG57Qb@UI4QEs;77Bei<*PHCflE1#3!hLyfAwW
z=`-Yu^sjW&SpLH?|5>A4(VQU&bOCK$SEDX-6eQI^tx$^*%OBO_tg#2zI^-e;vE015
zD8MS?2}gkB-$&pdrcBu<;Q`wq^3*qPx?stghUO(1IkVPq
zoX#l}d1<=;>~l@Az)8|`c~;o^U29E^5L9<~>4cVB;N8xx$x_Y{^>FtlMb~`>=2xBx
z{{Yn|_dagUi%(a6>+IVTX3B_)l9iP77HWKBS(?cdzDt+GB+QR6MdeqXoba!1UM;3H
zj|5fHiow8TMZA1e^mXn9lq46{UxF?dFGn@?8YE5k5r`3L0ZxDZA6+aD@!|1HU|#(-
zdi!2`Dfq-v{7cbKx0rH=jaqp4)4%`D)^An
zOCi*P996P%qYW6aBYV}OZGAP0i(DI%R$n#N7uHwR@4uPh+z>do+x?#M_B{FKh_f*7
z$ma2p`Q@de+o2aC$-p%69fv$bXtQy`ZJgbe^Q__d
zGF=})gld9W+C8H{1~c1Ozg~@_MzVAbmrtyv+8O20Z9z}JVA(MkRp76Y{gOUDt6U|O
zO2FFlg5~jQTpoKt7|osrkF#@82wMB){qrR9>5v
z^D{1sf04wG9wS6tEOL=Kv%kNw)O0yv46%Tuzt~Rk82e(it*K;IDQ7*_m9UoKde^n{
z6End|UG-tNJZs*0xK%xsB&oZ2-_t||DNdZ99aQ}KwW`1tzYoBUI~l+D1}!h)4AM&n+Nu&}N~ilm2Bpwz&22?_b(C;1|^y87e!SK%k#
z@2z$DUcESS?=*Z>Mcflx|1i20RtYmu3L03(7?&*f;~(zm#>Q^CRwu{vGxWQMF^{Ky
z&eQT+$Lp}pbQL_`b%n+NG3^a8R2CtAuS~!Bo)-~fpvu4Bh#1tGIb(s6hrsv6ix)K|
z=2=&b)FOEa?YRd|dCz|hXExUm25|RuVq+&zlk!K2_-cX0+sFu!13_)z_`EGNIr8Zf
z_5PFoMECPo*TnI8yv&Wr6i5^Z5%Ksmzvvw$7~kEyc~g132sinbiLcuytScYERV3Y~
z!1TV4$K&kq@Yy*$h|cSy12Z!}K6u5Ga}7K;E&8=(|3($jQemdr4&;OQ;X*1D46AV+
z=tT3y_GLJzd{N8CnO8(eDTFXdzZl*eebnZU2ed<-tKbLSr@@9p%bgtn4J=BPjE-ip
zQ^JPaiPrWp|2*(^rq}R$C>7R={qKPvyfKK0h`#Kwb(iDe?L90r#;nlSzdujsmBybN
zOc~9|YJdw;XI=G058L)Spd!70r!`4R*<83Cq5mq{mOC98$@_`h`O#t7R$yzOxGss8
zG{x$&ub+yMH1XBdH9V<;WYL7^Xg-fViZ$($9&#(MRwGL!J-!B6(ggFVGM=2wA^U@M
z4nsfzj5j~OUFA^VHw(jRe_dcD{sbFm$Dr}H1S=JDLJ}2LWSfA@mr=U*#nWR91NBzBFd)iqdrwLQqp{nm+u68$8PS|b>HV+V0J#<{{eTb#1NT=B3^lzeAjr3>ec!!A1Wh{LCTA*bsFZ^y^whMS!!#b~Je?8$_alBiNds*8yD5!spSpi(=An{?Jk#nSH{^%>mmAU
zKt$#58JgDe*%-$tH+!~vvKZi_M82w?7OBQ8nz;WxXhCaTNjc>ESOMcfLq3t+T#utO
zU$YC_Oixc>e@X0G6f-l(T5K(+i|po8$jI(&WfocXYxbq*t5mvdECnKHH91SODV0(H
zzFPPBjfw4YVb+8wNJdq4aDG13KYaWuEPDelgN@+5z}wVhF|=fFY5hHIGRR-!eDe0W
zvz_Q$+TEkqJ;AD7{GB+cPQr^_U%=)|pDJW9966+|0#ap78d@lbrTWHoz2X7F_9^yRN#g1FvD*74gxs}_*VDRft@y!WDV>2S{6vMByaslOCOi?zm{D9I`lSAbSVtkUDQ|CA`2;R4VPQPaFc=NptI#aQY*CCd
zXl$H|CPRm?{uI0_Q$r*O4&jy`@9)BNb1djmFtu9av;0LSxTKN(hFw2!*r=`D{MMB#
z%$3agT{-R$_AXhUR!({16wmT*-A8s?=bozJ*|hnyO8BUGqWCGw9Qy0@7k;#V)MdJX
zDQ#YMb5?WpoxE)0OV^KVa;(Qr9NhM=rF@TeJCBdUpQvgykWYSh*0elZ>bNTK#;}9h
zvNVV!S56vQsPmoGUrG${tmIxv6jaFNmB5n1lOmS7I_yE<;;EF3eca!~*?pfVT-I-m
z1FW!?4HbsHFAsL6E+!2z(cJzD_E)2^k^FKh^v~I!K2@pjPA@}^SHrK7o}sDeJ-+ej
zU0X@>HPVJ1Jrz(${O}GAky1YYNfiC3!32p>ZH*3`b{JVe=l<|BtBA;m*CmdC%ilWR
z7u@3if!Wbfz4@7jlgOn-7gikx9`q+Qo0ymw=q2`q*P6()q&xw|CJHW_S*)qsm#*B}
z%7Y%Az@;!B2m4?%d}oKU?_NjevFh8~chmC^Ux)0P5YlHk7`3)8$S1v~*#Iyp
zD9?bO(h@WklaX7KWxf+)OJ9xTb18G}B9I3Pii(6mGL>pZHt!tGTDjQ#g^3ZPZ_e?q
zF8}=L=_*=dB#n$2&dGaf}ot;)cC7!}<_X*i!O#N~SRzxtuvCLHY&U>5i2AcJPm##hm
zS8yZ2MF|Ytpw-y=E1AQe^#*?N6D4L(*GI!b2R_`qv2ywHG>G9AZw3VL7O;vh!s|dF
z$vVSKCS3X>q$XdAvP}3QyYNz_&5XC7+SMD$O-DD1oYp|#+DL~#HUIcTo!}Aw`F5vt
zMC3Cpo9W7h?kHk*HciJ|OJXmCK~u7=`62dzlIb$Pv56UD>J1gj3Wuw?VBzvw=O>ww
z!rrX681a|%-JHFu)y)`o4Th^oiXb&K+Kc$4+vKe-RX!m7Gf+jc9{E-_Jw2PwB~1_q
zr{_2l-urszqrf6NYvW;;{zPFAb-aHsurveo^R;VYF}-X1KfXU~yv^E=mMr4R9`faz
zu=(+R1k^kHmcO)|D>s=_D^Dky)hBPdOHt5orQ8vzdfc5E!)A6$v0Z;~FW_&MaU(w~b)-h3LX8fJ+1tm|l_yh6`Ejnw#F
zil}pMtStLwVf22d-_AVxhpb$7q)gNsdrQpGJ^O}`V@Wf?d&6+d*SB_eEqu+GA+a^H
ziCOjD$=R{PPY5M8DqqYF&a&r^>mg&N61XdBpSGGVU7!{lEUZx#^xg({dzZ?OJBgM)
zW)EG8AUm6Lb$_(ux?yd(>JR_lM{8|_gkk_DrU~n68_9+Xy_h7-$E;c4Q;$x=hV9=n
zhtNehD8R==|0l0J?YGX3(`Y13ps%>G&~gZYmeNu;q{S6X3k(Mm?u%vea@*f^+>vU!
z!_pPyBK>2IsusRYZf-(hP6(~j$Jd0`WVB460^V9Xj07x5VI2zBBWd8i^f
z=bws;Pc=|a5edNp^z}R;;nPc$>GKhmyI=fD7kHqsH@RdyW}XW*-`*yd_xlyhIIW$)
zcL6l%mQWIT%cWOVMpKCemky16vi(=HNuFQ9@(VIWfA9bJwq(5e)!hBt@HKNHW@cOw
zk^59s%a97r;N93bMQ)h6^~3e&N~udyB$?UBFvH%S{xz`%e_E8C$=^TqGQ|+H&}7t)
ztGKTM9d$9%{HEXAsKKqL$`a#JU#4kxsOe{)C}>A5;&NbnEh(Kjrl{bxcV@YwGZI;v
z6z|M0@RNvklPkt0@n&@Em_hnpirAezV|+~;2EGpH=YP&~QSfBazM=cm<4@{_lyOS#
zQ3k8r)YvAJzXDT@()L)`*h0d?*92He>TXZ}Yjn{M?}ZSl38E<(Nd?9%vl4@;&L>j<
zA@LadKF}IhYGEr(!0Y&D(dd1Hk(c*AI~nBX`}zA1hw5qmdzH`)N$LdRqxlS()?51v
z@Atst2l|U8Or3Gn{9z;x6kteNKD&stBM^oC+S$pN(R68$q$60N`vtLVxfegDHSY#$
zE>c0+V2LUlroGF{d1i|-dFUkA`Wwg&Eu=-wpjzsoi%nOIx}lOJKw4+X?>Rg?43&4f
zRXXm6(}m?_X>pc|lJ5Xv&_PkP1c*HZQs`f`$60SKBErL*A^SoCr2+IJAi02uiOR>_
zMCn%A4K@|a}2I4bI$aF`>9GHtD47T8!PG!%CN?&@3XG#NMs?h2V&<$E
zk~5KS-Y^gaEp&YB?2IDs#Y*(!Xp4%9^6|vyBWxFMvZbjZz(X5d7Kv5ZvL)|hl_{@GyuzlaaF=fzu0;amj77j9C1=w=uh=Mnl1Lq!%3Kn;*f)o`Y#Y$LWPG-AJ^(BXrDm!!%O6ASyS@kD
z7hMzooR$Buvq)bzEbI&P%KExjAJoUD+XKSf0he9OsFx1*KmO0VmJw*b(Hy%#1RQX{
z^ho;gV&{fsXV^gB%TWn#j4qmT(*y+$dZdt37wUy-}RTzUpAE8osw7W7&X?>L^_RJTULo=zXI&
zi}>2cC*cSU8(m5Hk;vlA;Y@~O6Y^3~@JRx+$00qh_MQi5!AP9Pl}&E%-Zs~vXBiwG
z?T&o@Y|F{1_2r8{$ZP^rfBYSmyF;3QSTZMBJ;q0e9%rq
zQc`O7%jV=HMOIf0=3D&x2MA|vyphnwke&Ny_q^M1{zeiJRsae}-HW*fIXLj)Q6I!AZ
zFf!0x=cc>SpdTdiC1hf{1UH|%gJP^*iJeV*Ais(7`@A6u<$AySu&}TLXpKJD>D=Le
z1{unLY_e7p@JH>b;PFUcm6K|vU9M^@!JfF70GqM$REia=$X2}*EUSGz>-mvm7H!m&Q7k4-Zc386IYE2s9UZ2?NN|7nuXEC?g}lCTShmz3@nt
zx~_IgN1uv5BDMKN4@osV+|V1g*fo<@C`%AMOJRTQ7Qw3|shg`4bt7~zSuwUpV+raj
zguM%0K4{G-M~#=vY9FKzf7CREYbm{40wzfmY($<=(a8y*E9
z6WruE1YRbJ-Cv+6VkO}?EwGD7<$d`O*eG3{UqbeDa*JDr=SpQ&{QJMC+hYd)EaQDV
zo)7aXii)=)(9mqYYcB8m5!W$Pg$xg?Cvxf>JnAo2e()9D`)N9Z;hlv?$;W1A-?9`v
z92oJ9qQftJGPRiMZEMR*qmyK%vY5*1mACJcAdV`Ad__ox70jfZZ*n_wwq<950vzDt
z)t^f~Se+347Jea<4t;U6nKq!Z%}8gGWSkfw^>iR{)&1Akx^E)^hBc+Qi?B&0ztq<4
z!>oczAFO5h*QLvjO;0(%frG!};@`3gwxZM?${O+U$0q$UW5LdT1ai{s+1AvwJ^aHe7*Sy4
zPryz=%P5^V{WSviHA8pd@>eedTj`Z?{l5MDc>(YFO4oESyNrs-D=i=Dnoyk6)6=Ss
z1KGFfm#z~9z1PsOK{Cg9rg7?Cl$6j|DG<)59i(cY1R^sZAMZh#v0vn6Y;0`Oj#`(E*sQEoUu@!h-EKuoKHj2>j~Pl`?N-3CpONvTyjZ+Tw0Mv}ak|n1ZS`X-
zdqApt52Qmu8Xs+w6SF+KfY&8#M(PgOWo5PZx|nZ#j4MbFAKdz9%{k0KK(K&@n_u>P
zS1PYiIztxsj=5ejzRcL2+v+}g-GCSZa=&|AAw*BoXS*9ibMy#?3Da6m+l&fuN-ysGd^&_w^fl?z8?8e0K^@V!RsMUph
z2|BLSsHXk|xCTZ7WR6OWO1z<5@!`lt)RNNDme9W=1{GrO#atr&i#hqEA|7WAK|$Rp
zX|=ffY?g9d@C%aTgUx2^DV~0ZRhK78GA%80Qkodmi@vd+rO>_iGZ+l#L>PykF8k)T
z8L1r^eL6BiOx}3W!a{2X)0{x{2}wFA0LaaFTA*tK-UIt#L|=P&TgX@6Or#IqcZ}Sgw{dpPK^;Uu47OqT-k!oG8rS&m1=(#ZQE2DePN*Co90%<)S
zEl>!skvDI_{kR?V#4;k)e)F?}z$F3)h+4_AuL1Z$sjoZ8v$ddnM%cv|Q+
z%>c#oR~<|jXqSvCU@S6|g@gnLr-cw8*ZrCW*5c#iySfy}_74u`8=hATn}=V!)6>^C
zN}zqMA77<-SK6q+cYRjMa;;CRu!Bv0!h{3SdNPoA2Ytr0Wdo2_+X2FX3^?l;H|I0bL%?CdN=ekz;ZFMS;vnj~oVx%h!d
zE@P&Pqa$d0$3Xke!Okvre&TeL%oZ@7C&_iyx7aT`?RNFhP`WgTp6SnZ^!9A&XWcpU
z-zSSc=MfnV)(?~zdKyu3uMl#ZQKc-brjjTAihp>1Qy?z&Pw=sp0ss*r;{5dyn@?mU
zA;~m2G{Iv`Lqjt+JDbRFwSRgrAK>dNBP-kDL*83zHhAqzPuuwy|8)#Z%wqlOdtz%n
z^qWnC@RQKEkamosYp1BpjYcRYC0>9(g;O{Ov%m=#109{uV%YbTG~)<$hhCyHeEX*r
zg3265qfvS)1%-zTa&zZCW?^*O4mUmAn=o9o52v{0J;lht5Xi|i4>Y)rssiJ9?H1C<}LF1G2VrKPLAaZZGm>tvPy(tZj0dWD0
zZ-o|w28v?*;NV~;qHZfe)@aunTwGk0yLUm^?a%G@d#2j1&B3tJoDd&O&a^0ydFFbOcL3#GhGnm@seH%U=h?l6Zl>}5vzu)q%ESyp~`
zTu3RtESTdz54WbRr<=>4mQH~wA9Sr_Sk82#bhCym(phctq|~<0w#dlHwg%Sv5-v5L
z^u(|YiEn)Z+F@^RZ_$P^3Zkmp0mE0-(i#Vcw}{L73e@D4AhF-tv9Y$E6#BqgyQ7Cz
z$&{$}RnMGSqrndhL;_A{-%R#P_ae{as&mtOC=Xo5`K=Z!#koRToG7l<7v%@|Oyf
z$w`a-Ak>pRZ|gHg*-yBiN3Nz+kTDFI=#7t{9gHC}e=F>LMrxI+?wM&sA_4JgKn~4xr!GEa{
zPCdTus!#5Ri;o-}7;xw7Vo<;j)c?U2M{Y;u?L9qT0dc}O9xn=EWN>5Udi$rI;v7uj
zDl_2JjUY65c9h#%joj*Al-0$BC8(u;SCx)QE5?3T)e!$G{Dmq=pJxvdFt-56TukZ4%JC``S*ahY0=J9oF@^`rR0|V-3}U=q?mp5FA-M98?0LyZ+Vq$LB#a*;&!n
z#vC5MHl(d^Oq@8WB@UlVg_0gc3W*5w$IBKg;HBKDuYzI&v|DgYI{-Qdle4xGHn!8=
zuf%GL5#y0;3R_Wxe?6Qxo9zn++q6q1bFb)hgsuT(z_Z6cchm$b=`S
zDGeLzXk&vNKbO)Ygx?LIA`1&zUcdedO^JZT@FdXY)$?a>RTa8cfM(4*FSUh>lM_Z;
z;=$2{M6v=fQ;^zd=*&x4X;|_@Q`g+w{AV4AV~*E%@r!Ip1iH){<9=;&O5P-g5!sd1
z)kz^CF}1a*(Rxd3t3~A%yfi{Xj$IM%kavbo2E9|nQ@7)vbBhdW$JGbLFKpiS
z2w7F1SB_pylOL98H;RnOZvg^k+vF>JKR|4^D?EJ0#93->wm+X
zYZrfj*1A$)cJ$X&z#htU`tUcNU!h+?$BP?#xbP%9s03Y#Bb~@_&P9H~x3adD{Jphk
z1?4T-Th^L6gSA_LNhZIg#})V3%V)ZE>+nlIyFycrs%q;+TI-JBs}UhUcFomBy?Yd}
zJKk8|(iY&S0LChK1J_#Eq<#Ok#%RYSsadCAl7K=`B_NJXqZ^!@oGKNx7(VPvc$|0l
z3)JV&Hngewk#azq{qcP-#`##Y8)IW1@)z$UV*dGM>C#~{1
zB_f}1t*|hL8wML8bMLw}h+hQUB(kTDAf3wNaFI?##JwS8VP5Z)KCk7rgoQ<(4yK=?
zR>@p0a!pbi&*cK&P@F{Wb?6_ls9!ss_lY<1edDtI(+1JauyeeG*dJ07CI!=F4q#Ba
zfY9Q*^{oyR8;6d-9=jdG@c6d29LFQbW}GX~mPg0G_S%f*0-Z7ynZR|P;Q(DaA)q+U
zfold5H{P_>w`GeX{VR$~jSV6W_&!DK^`Xk@Do_p)B|m@}kz(74a>^psgp#X2>;B2J
z4N}{dt3!^%`ljCx^FKFN&x^7^xAuduuG>MNi0^v~So;>sWPf9Nk(dl}N1
zo&4V5%dU#1gj@hBucNPOgsmglc=r=C-$Z6W6Z8y@D45~G!Ga{&dduXxa9p&tmR>?c
zL^pyis(RjbHusZ0;(WvK=6CjD?Jc{avxw10MHe}FMqb9e#xE@!+zdtqR#_k
zxekA~_YIO2-`4u9`Ru&=(qKQYzunf(9Pvj6HZb}Na;?;DricoE%2ZsI^kEmYMtI+1
zWYlAw$jKSisf89XlZd|t`toFB4}PeZ(~0=I90&T?2amQE`Eg>5?gW4t|3mBHj9o|N
zlKEWJ=%XKK!}yk1mPlDI?LVtz?Q10a(vF}Kzj6`X3%UHi_Sy?RAZ$=#-58+~85d@H
z>p&P=_>F2MJtYGg2e)!xN34CpEaANoE3)@$TmwS24EFvSaPQT@x
zfKCO)Ca+wGBPAo5%kaClVlLq+4|tf)0v;p);_L6XcA5!A1%}g-Gjd!E#KaXB*1lbq
ze~kuq+0xYR^|#*EVk*fsbd2A38VhE%?GIY6lwoYhF+X1}Y)#B~`ZW9SCeO#t<7KS<
zK@WkAxq4o{vC%vtnGdSb*vw8&ZL_mNWs@=wt#0ybWn#wM$dkbXTxmeVz}R@Je)DX(
z@gNaiCqs*YLh+&Da`OEClD;1^QxR3bBHc@#6moCqg&hJki=t&I6gH&-7dW7FS)?tv
zb#^}{6vyQPvZ3;KASc=ZhppbUy|+ZJBplV3W-`;Z$pkJ!?5yJKx5Y1`&B$cXqa6%?{7B(W&M-NX)H1a^vpL)CHTcBT)VES7DV8h`z}7Ho
z=V=g~>3m`T0h$?U|6kIM)R0ALw(qp|o*t$Wa9UY0qBotscWa?|jDcohWp%lCuKv08
zLxxs>xBJF?i35F4Rt&y*izw?!LN(Q2`h83;aR?VcKYEqu9#dCr5G%SI9}&pUvKB>=`#`)
zKv*?@2oOBktNHV)tu`86WGQ)(>lO%mi-?}vPu0+W>tXvQ%3g1(JAGmpw{kP6Goy7k
zmcg@adY=phU#YC$fBSM@20T|sl-#&vcXb+XFN_tuA!PhM8BEkp33QbTGn3)w^?PlC
zcOB0WOF?u;-Oab0Nk1HuQ@w%iNd$G@|!o-T>eYfZFc^a+PGE6@b`h
zb&$q3&}flueLs4mDmXv@9ciiKWwA~h`~}Rw{1#ewp~G=~y#Bt++r89c2Cuiy&#JZa
z)I#0R?bwXpMvguTT>$ojC@6D3b~>Qpb$Gb^8AGH(fgo$UpZW210#-B?tm_1p1pnxn
z_99;%$UXhGqXuwsy~}aD{I>^=lRRngr8r=)1pJpuafpbxUl2T$sbqWF!mWM>>~<;^1ArjJ%_wpN&BprNAUL;f>5m^J+nt;#ZS3eDDtn
z>j7>C-G2Z9Ik75ZBYf!{0ogVh2<*_OBfg0Q>lBsd1YSrQjSlU&e+%InagE_pOd9~-
zvF%_=V083#pc#l7cx2`n^CUG*~}?6EOCRl6(yijhYspBEzN=eR)YNxFLD@$mWlgV)e6Hp08=m&7|Py?dx#eQ`aV^J6X5M(xEBhGaM79M
z@nve=Ih|wQncSiI`Q`xwr)djMx|pImDCm8QF}%`VA*Zy@|DlUwR=t*((sWYw38W#5
zehe2nAsb=<)L>CP4flmISYJ>Y;J53cS{hT0(Yv`qsJf<86((=)`{PLpi8|ewYHPFT
z3>$*d%z=XXdqOd8olH~NQ|&db2NPQIejd&74vEl
zS8C$1c3fICl*jIr4>SHhI+m@~!~MDXHrWhLp^Y^`oHPBuv|QVuj2JjC3x5@8AAmr>
z)W~o?vOp_l2D1846bp!6THA73`T2R)eNR@M2xiwl*}(8vgMs*4OI?vwv-C{ki)~h!
zoZ4}3v~oKWZ!X{P0i=qw_bWWK(PHWeO`h7$k5}?i?w?L
z(Kl_8@$i%>v|Q%jeDWDB}7(
zn&5fy>nok%(qBCkh_y#rGq5V|#&ZkZc_kcosq8&~JWkKg-O=2|8Re(zYo|or4Nd@U
z23mMX9FX|t)2AM?mRnF812QmtUV@3LYiNIg}|5?)$@Df
zkqr7*PLpL$vjHa8jeQ3>xk_)E4E$BcEc-Euy{+#+jd!I<#)6teU16_Z&|+u85zK16
z2H#{I64)L?yw!(=mhlR+`sF+a;BXBRPtq6WwO_%NiTNd8s%^Awm2>iPHzgd$FF}OS
zt)N1E|CWhBL;nBW7%WKKd&>$IsTgrwZ4|_Qv=1YhdQ@-p^@p1DN_?HKl|YB^kVB;l_-Ss#$<^{Ixe5p&+7|UR+sp*+#xBx*DCJsq^dL>
zEG%w1<_2UWrs2piMB1|V$^fLsx-&NOKSarRRNjD>T#woN25HX!B)tUQ1-LMyV}>c-
zd)QSCLRFp;m`K(IVdk>3{jXpDYM~c1F?OpxdFAGBH&;jD1?~n&`la=PQI9$i*i^>;
z!yt$9VOVvf8y5h`y2>Abir_s1yw+P|BO@ab52pFi2^=l$G!%||$M8PW5g;z6hk1Nc
zGMxQNY9m!fh*D<1U}))9SK3s>BdZT4qRpL-W`En6b7=E{;zz|zKE-1
zyD>2v8)Ih2RAr^YtJ7HMioHIXMEQIGK7Vpn$`>HDNg^U}Y(fMDRk`VM1E;~Hsm+5X
z3iLRi1^n=VUA#YtG2Zxgy^7O?x0mJ^$U^eSm2Z+j-jo{0%WmY13*!(~vI2=OWd^3?
z|0Q>=di4Wd6BFW#hK;OOZ?$r=S!FF4VyStdRBaiz3j-_(S}}wDv>G%BBl=lwHM+)c
zW<4CgeW9@>NJcVO*plE^Z?KWbT{@&-91Phz9L-aKsxKq^&xlNo01zTbm2n$MXJjcw
zKoOZ2EQgNx4l1R(68$^qe}9DY}cvNKKa+1yBXcZR8Q
zyYGpOUri4jIj9^l
zHXi}W4*@A=UJmA9>b%2&?ZZ_v<9^UNt3`p*6@`t{X!%T(7?Ou{Fhm9l5Eb5$AXxwQ
ztw^sb|2GvWkp@;{i&ZR?8|*sVEu)n)(0`NaW_skcm<`^8eQs@M_r%tgf=Yzysm$?C
zuLfC;iTo)DX>Q6a=%|;2^E(VjR{4CLYGv(p1$2TCyZ}H3K6Rj)&>89yP_ua*dm>KZjL669?UfQk$yV&N3Ho;Y|2VY*xzp9$&&c4=Yq*i
z;+Zrm(kIZ%%S(nK{a*ewCeR6K-h}F+*ROX-V2%m0GHGDjMNk&fOD*7046Xf(uNV8L
zZw2Mx)UC*#_ec%sD(tjt@dkR`>FEC_W8Y3`MALk$U`P2s3gww#odY+JjR|hOv(y%SfL|zJ_!y&Ae3*?#_FNhe?1)
z7XXx~H($c9E}yJxVzbkF%q9liQSN|7EA+5iryo`ru
zx;yS$tk8HNi8D8N-5>w)yQdw-Wzf@LTY7$8;2#(s*5E1uPfqI383L!r?FNz-w#bdtW_vi+lk(fQIIC^L=d$+b`+T
z$J!bRAjm1<;JopXJWGQp{n{C`dI6{qMMhSm{9fJmji)(Xtz3vx0RMX*wdHISf!GQJJ)4WPEjW>MCnsE2@-5c1
zcir5}OxNd|Ub@yOjAEFbp2z`2%V&2M78(lAJ*zW&amT-C1%e8YF9CY7wf~g(#Gi2M
ztk8&`MeJ*f^P`h~8wA2V59WDc<~3RpB!YW}i;pk*cH%lwguVH`<N>6WPcP&T1>IDp16_pWju^e%oUzPGNbAJ+84Shj$45{0R
zgO!#oAb<)@^X_c6!!6+Z*LN|CE^Q?qUb#f)U_AQ$RI&ez?rE
zuBBeCyHzhcd0e42nr5KBSOWCpI7yWno>WAjY1%;6ZA=Y={{40aHn;G*VNI6FR2d`e~}9=5kO%gA6}d!_UaJa)ld2zX+b0XE55+088kTc9?c&H?M9)1
zyG}H7Mcl0fhRiH=%sr@c8?D;tWWHw|-6QvC3FQ>|3#=zYBN!QLDguPcn`GgrK0Ggf
zp=939W$+oiFDG37id61k->yLDVKKDMy8kuaNzKDJn9g8khvctSnB{ruF9>!%*SlJnD_`s(Eg
zctajGE8=HD!jB|qqgOY@UmX0jZ)rARC=m(CEfFJzDb_7h?#s0%u;U5D))Ma^g-eC
zonc6!F{HUQ#o9jvYlY**r!RHm!o@6KZ9Y7M?tAD#pSLfVB*Bb`QlKeciiYKD-#+I$f7j(=
z&iTf8#<<5F)@nlM_*8M$av=|nehdW1#0asnHt4T_h5;~}7fm4Av{ScHj{dPevDw=U
z9yy)8y*MMYNkQGzm-Mul)Z;~f9awbOt{oUZ3}wIlE57EWV)GbFY1_65IpYwdfM)>FA2je@WiDr3m9UOiX*s@(Ezt2`%0Q(0u|?
z^`dSX2a^U-R8Vmqtxx2`&T?a;ueT4&)YMYWJS&sXMVxHW!qoJ|6p*$SM`l5A5kn+Z
zSB)WmGc(x70?Bc9P3+wJaDvUF<#PX+s#`luDuxlz4VCiqXM)%4r2L>x
z(F0}Hy~+7ZKkJ53BgBP
ze{RBRf#`8^K5(;G9(p1}a%p{#BjOMS6*@QBW(u5Xg;6(SChQa&g7V9=q{l=bm*ri`#>Re^GcPaw(>FHv+h3gLfhc1AHDp7O7wZpu?psMGzNvU*IAt#r
z{xqDv>0YCJ5ZRJ!8zD4#(%U7;GKJ1I)g)#;5h6F+Iyx{OCOyHD+2K1!x5{df6|un)
zc-qkR$hK+rgF#{s4a>WZJ50Z9)4Vw~$M524z#AYs;8Rf|w;SJPsxs#(hudVF#@TXN
zOy14~|Ar^QHEYUinphW6avD~LNV;eJnaf(Fp
z!f_5*8J#Go*DEh6Si-cj5NC#fZf-YOc~vd2`c7b=AUSzojCh5GLgR%{RJxv3-cMjn
zzx?#|WUHb1Q}|u?<&6Hfc_hScvOr;dFaG?DSApnfS#U7^WB<+?IAQ~Q`y@;v)S#c^
z@Pj@W9x5yn0ysy`flHM)q^7D$iROHF;G~R92J88c!XUK$iIp3vtm(MM)(2d(w0MSc
zeJX(&hMJh99l;_GxezCR#yV1P$zzs0{Y(}G=N$UE!idtJ-&ml^*=c_};FJ=0g9PNH
zvy6~7hEAl2<5kjM{yv9vT$a$z&Q7%;wB+6fT9rblA(s6~+AK*-ooFm|Ug~dj#_y|0
z1vO`qav_5gK{dP~@KZa9A8%nx%eDA=*uMecbaO{%?+eY+3gIk`Y%f~C=b!BLajWoE
z$pW!M-np_pgslQ0bcKn|@WY~v>;Q=H$8$(U0Ov}6W<_%I0b
zipSfYT<_!ZZ0}Re-FKZ%tqP$M4>P6mMMtq{Vq~l~aIiowG%BxS(9g|K*e^8yKO`Lm
z=l_s&qR*#k=n~E^HbtuuPEMF%Yya4#{672X(>rWO%+Y3W^f2o#f3W^C-{ikL=kDqG
z4%Dz>mEK2lPwjjwU=RK62m?CxW+f4`)PTA=Pxdu{1b&?y`20wtEz+&;cT1WEcGGu@
z))yEzp6syuCkE!Rb8WV0c1e4UgV&#g$G%ku?BCDMj#q#Nk9co6@cQ{NtXpC4Ap9j5
zKpN|T41_5{O=TS&gelU*fey<{5~yYgw%_t6LI{>Xl*$<)(@MZ_5xXm-H61c-8+)@NYhnB3*D253H
zf`LCXh5QK!`!gRH$ru!c@aY6QnU~+eVJX>rDZOMv>_qKSK~U-!g-wO=oPGwVg)6PU
zAnxL|SMvz_RMdItAV%0&SacR;`!TBO3Th%ho*Qrr$sexve(LG_9YUtE%U9UZ#6M77
zeD9l48P~1@X36E13jf%T4~^#AQk&AeJb0u+KbaIMlOLess2>@;FHQ&P9Zq_!xAe#l
z?&^Q|FpLA(Rox905w{#F#1P-U?vuIKM_lij_~^{4ZEn7!?WkerqM3^(kT%{>?5*us
z6c*-J%2H_g1na-^9Kai8YAXHaE-8oA>;k(!1F1)-+Elscr5?J9`{~bV-_lfQe*Fjg
z9SK_Okhmjvll5!gqvEQnCd!!C+HOvj0hR&P!TD%Ji{BaD?eHf>#1)hBMdesZQipD?
z1I=0PnQUjg{hfu~a*N)ZZ{9yCMB_S!-lv6o#tWY{fyA=kUCXK#9!t;zUq`5{a213=
zi2uN5V)>%WSX}KTLM2x-%bK*1L}^@^hmm2Ocd3`VtX+=VUHQ#iDzQ5$mI5BTI0`D;
z2cgO7%=&JHb?>&%<4|9xSYpo1E`7ZFLJ}I{JV}iDorQ-kF7r(=wr8y1;Riae!W{Js
z#4EDq7*&+Lm6Sd^^S#ipfO(MD?gKrpu4v{rU85iiX2+bXtJ7fe1%3xO+*EtsE<;F;KB0o1js?Uy3~qg<>T|2q}(WsMYkBKxU0N=l)}zOM?Oai
zO^nOu!+VYc&?g){duyJScy`ro^-@R33DUJo44FUzOAL(3#axDiMZI-VEBmsry*T;m
zRE)iS0@DQzhv+-Me`yQFU~6HS`PluTYZ_I!ji`_`Z84%Eq?Jlq;)ug)0C)iM?nkZH
zQ3qXpe6q63a}aPU%h~u~-vIkxE|W(<*TV4!^8|3rf~Tl-Cwjn#hZICA{x`_hyXXb;
z3oT0kpVF%;hZUe$>G4VA8IalZDw)Jmp??;816=0ePoHFO$4Q3MazT+pS76Y?C3h#I
zvLq`%gLTa@7#5(3tdR33QWB*AeDN7rCCc77d30#C4mwdGZ
z`lar)L8WS|5+I&3%=hN07V|)Vz*()`-vEc;iEWiM9qYHR8=G6pwMd!WU359SZ726X
zP2k2HmmNuXsK-_vvvH@I4?^?qu~q*aSUc6vl+^&gc6Z+lFO@Jk1zby%XJv>m!GJ
zefa3S;1?J;A$&eaAeG1S*3;*Nz7arVnU`tg7+Gh095_C7nF=XH;K~9RcZL8wcXb}l
z7Ke5}6PXX-z_WnOmhah4v=}W;GWdCyk^vi0<})OzIES3Y+~)t_n$OKJ`hI0HPZe+;
zc8GN|hLV(bi^1B#q1sXjx#IdQyFLv&P{s`SMBO5!FM54O;{>mrVFS|+ys8-fZzazM
zh6*X;S&jrL3D%Axz^d!dmP2E7;$u-^Arl7&fug6Em)CT>j4~3*#~caHH!sV2kGmwTg{Pck>w(AnuWU3HLY7>ZrlxDXdlSpP4;#@CWKS%WVDs4@@2(Ug(%mTE
zKHRVy`7mKi3fUYjP(C5=#4BI^9W=azH|{o6niTxF&~^EF)7252oZt<}i$&MqGFA^k@KuEbO;bYrK3aK_3mTvHJoc%V)P3;
zK8~2@R+oIND5=nFegs1rH05Q7NtTj?YOEJwui|IW)^7z0b!f#U66vU11^TY{`7zOD
zEd19GFTgcv*^Erc(tOyW9?%X8b_VKa!Cw7(D{cF}RQbNhh5jspP%dzW}^
z`E7dZ26fsn-Kz5|*o^Zc7-a_ZFw}J8sG^h^jPbadu&tc9vn4_$DQo}%IuP$qF+@@bR<
z5jnqCCz!2yNrZZTZR`{%C#CGH+kZA=^vnuDmi;Vbva#3XdKu
zId>#VYT~=bSnzW7SZg@@OsXkq_aFPY8=vo4fhOTMXGhC$<9!9YS@d$J%hkq-bGBfAR
z|2CNOk6MFSs>LZ1k~8;VW&+*!sQ+I%?Lx;jtb^wbCPbH+@hw>!1ELfLoK|MT^fczz
z^ylCWICfJj(QgPc%si_TMZ2{P1XbUYl`A|0sydAkVqQKqXYYEtbyw!*+BAIH&^|_x
z2I4}Xm*4&9ZfXdQSJg>Z^{Tso-8-=Se{5{HgA^aum;mxc-}c>1@43eZBwpZ56;od2
zq)V`mT3g|j5xoR_%)OthPT-8Xtsw^4xEE6n8^bBJD@h@6(-EAs9P`39Q^Q_~`5)>2
zTn~MD-*_99;%pBHUW6L*2WN~nsy=sS<*dg`MfFn+e{Q1i^eFCN1ngQq41sC#a?eD@
z;Q|ExrILAATNd7X{C78*Q=z-F)l1@A1z9l74~v6sqnEFUiHn1Hdf>x=mDTslCws)y
z!GY}7xkr1q()<9+`JrAJ$U0nhTWXoq-{}=vT$(8{=OvQZ-Q>G}rtKkN+?LK1)^sTn
zUc4LI+#%@622!^3m#m-dI4JA1X|EH^gH2tZ=MZRGfr||yQ^l?y7l13)x}9qKct*|7
zx52uy*r3J>qfx?VhI0Ps2=hk^`p)svZi%7+*7xAzOmZ=_u>ZJ;Wz|h>eOwsSP+qfF}!_pPRL2$hzl9>FsoB|51)X1B8U6t|9If-
zY$h?Nf&HD|5G*oUz1_A9gc@Bn8PC)5qaSe2*l$NojM~5A&4^UK1}dV}{zSYH)K_wk
zE>9e7@`56Jz)UE})^!GTfqY7{BDtg$C>QHFq*V;@i-Kg&OtGN4la29#*j^pYI6zo_pkx5PSu?
zR_|DFo(O&Cvp(e3PnC`{tKitg#tXgXS?29MV3G)wToPM${p3F7i*5rSqZ-*0{0^bK
zX9tJ?!xNCR6u9UKT?|AOhK=7qmXH^#PK!MW2L)`qe8e?ef2a===;K1;2LbfM5J1oE
zFbmq@zt8uO>~Mzq_ZaYVAulT0zw30kJ_=)fb=k+=JCcL5y&>I7X$-_X1F<8bZ+_nZ
z9ksvxEXR^ODFQByT
zFH+MCiE|<{l!%f;%pM^L6|+%NDb=_+~XxuJ{Vs_5=s
z2x~l8Z`>wvF6$(UGF`k<@81vocnnce)X!&UG~40NfpmsH(%LG>XiJkMYk(Dy_p*h7
z4YrJQJ?-r;*ZA?WCxFP(Hytrx?Q#2q{UoA7a9A18cONYfkQBu7OIxdT-T=PGB$xya
zH)@qc!X(Cn)n4-Fd`WmGij%akvGMjjB~BHEnE(b1Zlwt6Qw(gX6PY{_B=w)3$L`8m
zewd$09`UUbmAN0R{RrhVZb8_Sh8&55+v`$62bx&(bL}V(fF2*ktzx&n4m2;Pkh`R}
zoCjopolt@5W@2(Yj46;_)7YP#P#`K02A&H@{NFf1sb)KdvN=uadF=8;R1|TZ(n73d
zDm9g7)H~Nmx<*+?pML80XDSNhND8I4kE;J7t{zlWVO_;
zQc%AglWkC!Bu+E#b
zb|9eQ1ONf`selVS=E-cIu;#nLu=N2?^IQ1IyK!jM;y{0eW&v9Gb_`qaLPO6dC=TjL
z^;OwThPrI=Lrco~4xPHx%7Lajhi)N&VjeWVb~+w3Zy^}}IZFJ=Y0t_{#;g`
zrP4EXu26tKxq-3{W(i*WS}b=Shm>)!$#lgagcl)HGpZH52&yM*?2k~KCrH=tmyg}zp#Qi
z)_h9NYl8^H1_JORJ3AQ$zT&*rVM(M2lA}A_?)y-pGYD$&J7)U
z&+k={y+&W(*f|xN`SE%JRzDNd6Xrten=kAf{Wc}C$8b*-uSG}4$5XpLl=;ATML5k|
z<=v}L^dMrv%R5i;f*ManP6NLz*q^Dl{Fe`_HC@ZaZZO`zBKHE
zn~XwfhEIrx726f?^2CU`EJU}U_F6sPCg<&1{1^jSJAL$hN-%GDR*aF)BB3UmS5+N~
zeszl|uIpgnpU;qWxtPu6$9?d?c>#au+3tbt=H_N|b2B^_>K~sFlf>UNuW?PaeOo_p
zHXC6Y@c3<)nM%svk2*n1^Vt7x-f=zSu0ZyUFrLzH49v_CPv50xx2wKJ**NrM!ruz7qCOF*2ZEdPj*E&lNO@R55T%kO(*WLlOgQ?7*%@_>l!W)%9EYyml|W?e}+U
z?f{Kd`s9%Fbo1ke*a$*Lf%j7d7CcVlj#cxG^{I;Yu0?E?iI1eDUeweyV_oDniQ8l`$RUiG+K%3MkwkKsgS6%ATS66)XgPGWhytB+NZYDbbxo7BbKorReh
zd_y4E#_Iza^r@et1RxW$)VS54#72XWhi80xx}M90Hb2AQLSb+~xuneWA=t90l!r$t
z)}*C{+VxggYGedt7K!jYd9qRKYJIUihZ~BCrD+N#lOZ8~9Z`&pZc`O^%M?-)s~m5P
zB49~LE5Tq<;OCZSO0xKQA&p=1)vK*v$Cj@p!rFjc4+eO}-$m#>R};G4yb`#|dv)B~
z`&T5l!{Q!34pwX%l}-LCrR$FM3lG%;D(pf*RuZqJK4-py)Xl9NtL=#j%X{(_t}CkI
z;^Ox98xZ8kV1v|neqvi@X|kWYuUC-dSacr@yVIL$a9k
zDNR~)Ac3)lSw3~@;{!cZa%9QUn$bl5+WBH
z@08g}aje{4^W&i8JH#1k%ie<}^ioHLMCr4|bW5w?>$#<`z?j|vAd2~*fsKn2<>l2?h8Up?QUQ(V>n4D&Rq#~LN0aHwjJ&S(NZ$2MaM&3PzjLI9N{6UN|ktn#@RSvJKeqP}v
zc@aj^|C(4fyQH*OpE%6y{5-Ir?MnQomONlzr|+&cDYZr+EZf-HzHumpda3&rQ8O+z
z)%^8qMW!5Ox27_ifmwwsw;zG0IEzez@c8
zy;Xma##3gXLUX(mrYP9>^{o9Zozfdc1UyPq!FqRzK=_f@yt%E&GK5LSqnwNmc1#{m
zo|MzmfCCQ^Az=<3&0xl>2e?>VA_Vc#G!EEWR+e|t95=RXQG*rO;6$1d}AROBHH>DQQHdQV~`_OF;b`Dc9FU$#v%
zv+lC!5>P(XKH{KLCnpdjRewuh)_Gf}|MfJ_W!1Xa$L{rA(?qC3E5Jl2d6O4=<{_E;
z+R)y|R4qPNIoHoBIvXW3k-;G$De21#V`?2-)X~>|HXAv$o_pUjCBu1K)+Q?MN(X9t
zL2|W&0}CX0VTmthhz4qx!|`zU?%k}r^Gi#g3{E99%QjjtcXv){h`4tfHA-_g-gu>BQjfLm}IURG4d1$+Yj
zYhV}!PdX_p7@P3~${hbl_dQ%430DdnpK5Dc9L$mqK_D`yb$#%Fq%bef3RJ;QKM=m+
zb6bUdDj^Lmi8?zyY&3drP7;d7nT#rmaJq=^HiEmy)$P&7b{lk|_K3WDaOga?70W`b`0W^sPK`
zWF$XTYfByEmBE4geUWLQGB!u_CJzI5SnvA8H@bHaG&Ge}#Q!)#COPyZ`tabY$NE|h
zLL!{U07%xAm6c^>Er5?(u6(kIqoeQEH^GMwAGRkN8yhDkCR$in@bdC{k;Kc~#$jur*6W-c9600U
z=HaEBcSk}B(v3}?C<>$)BO)~Ok7ib^ukRhSB_}%vjEUw5*uUxkhpTt`k{mL4;dwb>
z+Rp+GblUtgqh~qL(2&0l${`=(Z<;hzy-b>PUs{nt`1w8o0~&hA5ZW~Rzl(#
z7&cv_&lF|T!NLF2cV-f#u*xs%Mz88N35!tn(Tl07R;y%uKzoQ0+eAe|9e0)W&vd{b
zOH4}oWuf^AO(fFFfl+KM10&;?fdL~32VSiRLFqCRmH+d_Vr3YZ=S7AXLn7ED`=cM=
zU49tl-w&fwgGJ)O_G)Md(t~cf%>@xdL&GP@scjM*GPD@b|NOp`W{9K%Uxm+?+*%-e-^O%=c5$3TUuUVTFYL;yZi6oMja~~!V|sUZ4wt*
zT3S}-tg0GY3SnmPHYq4j$eJBJJvCdOI}+ctYJK=|UejW?^*V7$@(+wYh4aXvvXqbR
zpURKI!UBK~en(lmn&JLHM5FQa7}uZC<6a7T$f^u?WqpR0w#^OU!9+=>MP#;8l
zKfAWZ=nBz0g<)an`_rLF4@$Do@~Js;knH3tL{p?`Pa_5z&
z=7MFv><%fppfjWr7rMe(`>^)C@6mP$wAF+)o3()QtgbTqZ6AW5BZqxxJ&$5|;ou@d5sztxN5(N7<&
zd_f8|HKCO?v%*=4Ar(%qEh&=dE(VJlvDxOpRxFab&?{_kprkFqw+qtUc_eb4hvZWh
z2%Ssb&A|-q|2$G|aGzECz$V+_%UcCoVoWE4wFZe$2Jfo13qQ+_)B1lE{)KVDbzJ@k~MFWq$q~9=(;d
zO#>=Ncb|f*+eXAoL*G7Pf$`@(_>+9RIzmr1(YKKzZwWVS&Ne6L>Ta`jm8oyoXUHH+o+Gwk_9(~(g
z2B1m*?|mt_SYe<3zN2Vu2DAjVMA;-b&XoCF$RzJ8D_?V1<2h4?maJMUTeiG?BexsO
z+%@*PI=S)izgkFyS}R*y1Ro=D@#**Puayk;md`Jysi~8?U+!OkzsRD`!@}i`u0@w*sXpv+Sa=;9>p-`Ljlhf3DT6b-t4rtm
z%1T?yi+{DCi$BzUeh4ZndTqcz(fV}9#J$Ra53M(Op~7ZF-Uqwz92Xa1R)Z*Nnwo?l
z{O_xPi{{OLVxqiGg-t#38qUs>&5v7nsIdj=2OLMnP3;DA6ZI|S!kAOq=7@(JnDT4@
z5V-EQNroeujcFd+;dFs)r#ong>wyB+&s`S_igRQ9`>JMUluv_HS(F9_;jq(Qgi~sk
zW}C2}*`y#_)XdhQI6b{lED~jDH~;jjY(b`IwN}X{NHO1(%s?uIz~%SM!|O-~FQq&G
z`kHyw)h~}k4-P1R7^2FA;HVJx2o8rfP24e?FOq`{moatO8N0XbhJz92c@%_Sv5%+!Z2ZrlB6H26S@s!qCe`&vQ
z&jRV&`ntS`zVCT5D&PDrG6pZ-t2?0A!o$G$Rnl-GpICC_7*>AS(Pv7)pnG|}6V6T*
zR2EyQ;^M^HqaJU~G-@UAmYysyRo5Jd1_+;z&lKw5XNs0-H@$l;@q}JQjwZ%N>WoE8
zQc_ex!tc4%BSS+iS0Ut!9tqmGpmLj`*;Apljn;CWs$GRRIoO^NF*1rbUH9R3EKa3F
zcwuI3edRovwH1HLW$WARhtritgf;he!or0Izu5kSes_c^aBy@C<1jY<
zCSz(b%6Zq4IO*=ZW&feniucLB(e)0qN(botde0H(UObN0TjGWcuRP$j^9H?-HVOo45+d!XQTZC@o4BSEiJ*T
z58x+t4)x>`JXLXB<(i@-UXRyn=VDG5U&u5^CF~lMo2lySN6(HZw^Q;VA#J2^Uq?5<
zcS-wOGBvEPqN08|Vl}~CbMgNr;z!Q+p7!z&rD{Z@aJCl~4FymzF7@>Z-Sbc|ShoHm
zQ0efH$%C`g&HB&blps++JlAj?ad^P$7A~%`iVEe?%x$*hLO%E&@K-+A{5`|m5)u=o
zT9LxU;5#=oG*oZlqlR@VDkg3V@_cyJ$)6?=GK0H)9kmZXB?l13rR1!RUW@Wi*-7&MZU^iNBB
zaF8PWR1+*gRAACGEZT=?6)+n9wrbkR0B0*(O~XIeK!xzejiiJGFd&K*>vExd`b_R2
z%gD}B&r`6R1GaOyv+1+Un_a>j(6#?B_~-VmuJOE+(#XhBSez{3IeoXffA5~>wh^iC
zg=leceK1x9>h}n;mGMl;y?ix6>LL1~vYLd1+lY88JpP-TmGw_aEzCb1pVWfAN9U(c
zVTM>d)NS|)tlVQW_5A+n{gB!+@%3=~@K)1EB89jnE;J2Y2Yr9)Btz)F%lsose773)
zX5q7FgtuTOIZ^XyCGIYbM!S;*2b!|H0#*l=hrHTeJ?eGrjt*4Tsgsj6ERlOYh%Bg)
zC;&iS_SC`GqbMQW=y=kx%H@$N5`lEYYR3>i|4#ugo~xlB-hZ>av!JC;P#Uv&oU{0y
zHh>uy)Tg{63O+(i`nt8Ft*yB6FQLGwVCp#i`^yz{U-KJ;*a0YZS93y;lJk0U&{1X&
zHf-Db*7eO_tTPNyhOjX8e*6Q#fv|Ufb);Tqswf2;@1F_^Us8v}3_r42q&iDlc*zRK
z2xj1*`*v1&DT$R=LQ%2bTZHn$99ix($HVpGCc7|&!^p;D(3iKK_g&Qq#EC{F0?k~!
z+5dvRF0yiRNG{OB4K=C@qOz$Z$q}CITU%RLkZn6I%5>o09n~U!1Y;FfpR2yUvd7W*
z@UYXpdq1ED!9}`nS~>p
z6TlB3-WLVrbD@)A>DMux(pX!+^cJplCxC2(NQ+op^Xk8^6GNza8o)Ul>+5{3%Yfml
z|3cDRb;*xMFl}fkhM%%+Dj-0nRrD(KMlcWn=u=8KJv7?QE;?MK4m?
z?%qT-DKy-~N{g@mGXEuL8XeP2HSLL|8rQV_y}EiWghMk@%<*}%HEP|ZtF
z$Q#>yl~gK8OG;v&T|GNaYj0131^+&KSTmXI=$U{LN9kHL~xxv0UQvGXzhM
zvFxU6b1Ex|NcNK1Q)n(4_-sc10Pl1$$j--5erlAf
zo{FEDx$#|D;k6h!p%*7DiO@n7NG|NOkq<17%ZD%#X$fSgLzr`d
zPw^(-TYH|m8d%Q^iJ<`t~>7Gpf;o&1-iu$fg;rN%g
zG4{wJ{csu8Sn}TkpAgS#J7+skec=fww%O(I&=po#&cS2r>(bhZ@SNh5s>u+;9Z}3r
zPe3s35G*Z5rXrYkIS&W_cO
z9=+c-J(6T^f%Q1VrfJ$m8-&JVPM}tS*QZ6)W{G~6{eK11n)jOT`
z%wQ}wp#+GTIBp^2z04E{;?oQ;L_6sIr>3aqkInsaRSF&i268<=G3)IWtYFEZCPrZD
zrWps}?|mfy-Q7Y6S@SnOVo!5IqWuRSRTbg6#7B?*gOC1Do9iEJiJH67hxTK!%XOPU
zYieg<4OSiESCsd^D1Fp6Gc%k0xYfW8{b#rN^=pJn?NLc7YeAES=LVFhMt2VhB=z)2
zK|rbuh){>@HpUx+e=0U1g5(u&Udt3(J>ZQ7Xj`6^u^fHKsIx&Ls;HU2TlK;jod}mc
z#bU0-d1ptI2{K@>kSzAQwhRu|y6v6)Lfyfb?{92LR|-mhPSJYr6|SPu#Z7eLDe0zGq?`%?^Id!z-@}Ennu*POP`Z7D)=n`QsL~g`cP567u
z6O=tYd95Utb%*&!2vFH@p=6s$!eMBKGbmhepP`oSq$WJ;H>`B!_MzbGMT);)3oZ<-
zRqpYN^uXf;erJ!)Z^~WXX4nOsWhP`d-&K-zm}ZzIN@7VPBj6BIaX9m+sWGVjwX}8B
z#VAUZMwJ9m`{)1Xj^+!&So#j--`D6P^7V@sv(c#&s{JkZeqW?7Z)Kk2EG_APZ8-|o
zt|i|bt(yPFh61F8jx&Z&OziOS={DULdbj;UP35`Mk!0hxf(jRfyoE(-O^wjgUwCFb
z7V;O1i#U=sI}1zSpUfR5HQwkHg>&chCu5@#GAkA1|G7$Y8v6SBuupJhUJdv2^%KdU
z^eeS^L`y;t)W}d%$5(0g+);6Rd>tp+gKj
zgorg%i1(rB>-WnSm5@97p3~7`6qV3Ss%~PgIG{kd$~2;
zi%oC4HLr7OeGg6|D8t&@C(&JiUc`DxFehYxE+D-uY3k+|`_pd1RYlH^!mEk|X`YTY
z@c%+JNo1yL*UdH#CC2(XnbO{Ys*uc9=ecL$*l_&4!TSN;O3y=x_7=_EJ9uYi^Yv;n
zqwc8<2OU4%Rh=BDk1~MR{PSz0!=S%I4g8Q@yC^~nM`O8GMK0XSTiXg+N1HrEEWUt+&6mliO+V60P;kndZz-l~
zM}4?;D{_4C=gd$4pP(My+tczx0T=GHr$4dF3PDG3^}Fk%wLmA>iEUrkUtRtBv5=`=
zI!e)Qwhati%fuGu0~*es1kMJ(($D!{t$_?K`e@;^`9HVg*K}1R@pf`m4~o){gZupE
z$tj8zl5J0UbB}B6jYE$)mI0_`6~3qo&uWJ81r3wj2HZIzOodgheH7(tM6?WQIqCvv
zQ@=Gl^f+8k3=8XC`3y`t*UhP02zCMS>k5OQ!Jw{Q*2ils(=3ju{es
z)xu!X>`6^?^^VhQlZ%AUZr3{ZHxDH0F4ai#HL4>~S}oImclm@;0Q_;hlTf&(oCb6W
z%HM5Z0{Lpv!dm60Nw+|)3yzm*<-L8DI2If{?MoFlud(=eULw^)*^TyAbNx(~4nT!*
zne&1a)AOQ;7no*xplcn1Rp7}15~LY7?tS)!%)StLSJ(H{7jK(GLasc6`_--a(wvZx
z^R=9SaZ5Bj8n^wtluZC+yM6ZQhBXrn8}1op+&h32|Mj5Ual-IsJvu=|m6DLKva&il
zIYCz(8(va1FHzvb<*`d?Jhd>a+Aj;_E>%mcI3Rt7i-d|f{p!4H&scKFYP&bN4`3wv
zQx-bYMmRJ;fAZw)h_C4uRf)lL&uApY7E26vJDMF>q9G21bOr=ygmBy+`2NKR5at$m
zn(z}Un`Pi3p{&og5FL#tqT
z(R5!-OLR(={%=)yGB+C1VEv`Tg5{bp-P6%XLIV-`5J&9M-423>m3FJp05a=xpaL0J
zbDk{NfRtMbvO$0bPe*;YM~b$+@R|&)63ZU_P_+wj5^H%6)6>nCA_MZn&-@pX4)8o-
z+&pe4b$t2KRmg?q`Q^c`e1Nq`x>jqg*|e#H
zzP=JE1?4f6J6u2R(Mm%6tJy&VI}Kj%N$AwxMF9<7w_
zh_nZ~3I*Q$@ocj(4aUjASSny+KEK?606!Omk?dj%8%hdt!Lmd5xI&b_llYo0jNyop
zu2ib|JeO@wSc_qT{<+6WS;pW;uj$HJZkh%HR?Y<8K}wyNPa=W+hWO?_`AL!s3xPvJ
zM3kj2=5(ZLRj)Y0&enBSU6$-M<1vI{kvZ9D*w6uzrdcV&0SO7L-
z!W{jzoYj21G=^-Dn|8*gcq)(R)xbIz=
zXA2(0Nzu^QQmc9a(itz;I&-$w7)8mNVjR?X2&>3P?kGu`LcHKJhRMs=om(d$r&Y!L
zjzJUQ2Req9jvi^(=Dnj*m8|DKwtNNOP_iaZit{7A$J0CS0{*ni!?pP1C`NZ&nI$MoDX`Uni`CZRFAt+Tn@$V>
zP~wL)PwcS1sU)66sg+)?VkuLJ*#&gQ`yFRN2M3LP8lSh7?IaQx>q?#1@e8>mcX*@j
z#AFWhZ=KyJbv@aq<+_8hzOYbh+JVP{<+}#}5S;oIZD$`u%HhNY3Qbu|YC#w3_iu;?
zfU-#Kn48{nW?_`$zCVD{h;Tzk-elf&Jwu=V^pFNv4E^?Qb7HiWv3-}rOsO;H#|N}>
zAt(>#2gCJNePuE=$T>1z5iW?p86RD-Y>@x!I#hLeO(O)y&M*fBEUFV}LMh1`lEROj
zIWD_y+WQ0czfO*sFh3vfbdUp)1ypU6DYV?&xcf9Q4J!FX4|&rpo}6St=^NKIT~Ped
zzqL5D&5c^=9C~a^quMFpYUMW5U;)-%MYQSQ|5>8P9rcbunVFs4p%aIHf&&`a7cVf+
z7UL%LLq+rtlhf_!-)Z(?UZ?1>ciW!rZVt3J+XE?WP-nrbY3eu{sDe8(^dtmlVN{I)
zpWI0CI8oUK6U1oa2z9Pnmp%*#_LXvy`D~YOId>yGBwhg@Zyp?pvHS}QtKn2cNG4(-
zL(PblLG3q-0ym%Bwl;Y)Ye3g2{f<7^{*cW^s(Npi?_X5San`rfqeAA(+=-Pelij~2
z73E$`n+|z~W%o`Fx0D>Fs&Oj|^60E4D@R};!a3fzUdc`Wj8HNC@iAJ++NMKzCk$rq
z9ZP^_|5~4(jtZ6v{AiGxZ7%b|{^E>1ikzrTy&}b|T*7YpzN$CTV8&NnrmEYVvm&&$
zs-0%#RPQLUP|VuL-yXHy3VG2N{-P&bqRIWkJu34rXZvbPSAZI*`R0v*or641d|X^k
zeZ4hQ1Z)aLQF)->0eK7+n<*-cq|wM<*o2I%xAA0^9r<(W#MH;CH+CfF-}UDi*ufx7
z2heo!t1!;<05hBOID-j@ZQiG^f`U9riC4-n8_(GK!1w@^kQogb8MqKdCXo&JM|CwN
z5YI3$yt&l!^y!W2bSm0Q$$U=j9mk5vH>c>uc=(=Bu}NRa$@o07{&sdFq7a=(j{AiK
zbl`gL&h2IFd7?v$2?(8GR)IIe+8QH~IfcQ)+@SCB?G%Ra@)|dtyu7HFt9nGspze%DQsjwih%~Dn-Q#JK`dZW3FrqvQ7!DFxlgTiSIwsAD8)FXj#|L55}k7-Y{ps
zIGikk4OWSMH{(r79IVj-jX0FK72X}Y=hu*rY+)TnLi)J8jP>&5kHkB>-_QUY5fgLs
zqZTvq=i}spC-gsA=#tOSHJ2Q2hEg-C3}wW{EuC)J(g~9mQUN+SdryCDl=;Jl4}e1T
zr%o`%__*A6$sd
zAKC@@yeTPJ>q|k6VMqLRqNCqXXSuF@!_^l9L#yjkmcA=a&26gcPp3bxN05v-o_YM7
zYdt;Rm5ZFxbUAG?|2#uK(R)_`d^5%z7TVERUK=JeTo2GUFPJivl&rYp4l9Q#BM2~~
z_Fz|Lf5!wk!lG_Dxa-MKH>k&7I->8vTIHbv<`d=;r9g-Xf_>Ba1tbqpgTch^;YN#A
zR`Y-G?$u*^nFweVYV|pn#>eT`X}X}%_?$iiukc2kl7(qmwpm1OF8)pHukXA4SpbsL
zD!~@NlHs;v!d2zT$#D~B)*Xze+TbkI*Gz0Mkz9t&kMMbQAQod(JQS6-B0s@~xNzy3
z45nfN2VC2j>xk8&F!Jd;FxGg32m4mM-S;N0VdY8!AM*kMG?#>Y7hgich&z?8D`rNE
zWu~^sj!3JPzk79^ky>NwSgL$7ECaZjpUEhI0kWJ$7Z!6S9(cK1y4TVCW>?RNYm+z@
z{E$8mEiYTWIi*SRdt|-x6%NnEu*9=HJIIp#f9U$ku&n+qZIDzXq$MOoK}3)ikWP~j
zqy;3U8>Jfr>Fy2@=>|nW>F)0C4ykuN`afsp%*^}Q>%#r){fo8kT7%Gc^76*2s*vgE
zH?=*02$a~bCb)olsjZwv+dGiMPA@AiUW1W&z=6XG0UX`16^x{9T^e-{+zp4buh(9F
z&j%!R9AnsX$e$QZM^_;b$qnnUdaKN8Ab`!3{3b~43u*-qz5D>_#(1xIDvH$i`Kyx*F67hMLx>+H!^;|)oBTxx~
z-ln}9zZ2XZ%Kh7Q4Xk*FNDVymGT8Q^V(a!O{7;zQ_m-TYVTBm)_hPtj0s0FJ!i^Q2
z!e!NP`BvB38l2?XrnNCz2_vf(6+L>WT^bhJ^b6w6#+#=Kv{J@t$A~?_u!-qC|Jw!L
ziVgYfqlXV3yjZU4ugY#ycm=`YWk6UTtbUFIhnc<*z7zv(kfFF^2I-QMTvNTWEKOzQ#2r@`f7y#qx_8tzq%&
zri*a+=BdKXS7he6qphQuV&=pAQYqT5)|uGU)af75U`RCoP8@p^M#4h`+hJ{wK>V!q
zIGU%n|2t#smTBofzPRj}!m_3Q
z5rme@%N1opyg#&9mOB+m$!d9od1TqQgxa8%aYgo$V)+vG&
zhPYg;<#*i>ieh-|Xbc@bFSGHFZ-*P4H`hUcc7D3WzJI{?raDp)(0LHJrl{WKJN^l{
zV+c=L9V0g=>dZ||X$Mmsnlw;-Q>)+U4caWUc30c^fBEzow>-tZ+3k7%0xf{qOt;9w
zOX9~~RV8d=1Ux4${pWG0mx_w4fodHokEkHU#g#l99RL428vo$+`}Pmkly?A2G9
z*D)q&MnJ)UP5wP1@w*glf@oxt>mF#=L13yZ*XM33pE}~pdLJ|_L
z0$&^$s+wC=cCf@H-}P^(^?$Z*pP8{kHTrC<$Z2ur#T2hWX{fW)3uaC&K$Dv9s@6I?
z1Jkft%*N5L%QAQN+vp{%=-P`an1;Gt@6{f~Z+cc#5#ORi#Esyz5cmGjp$WuK_&<_)
zZJiMeC^In%wt&lv@E8YWYq)ISfU4>56nJlbe161t~2ShXy=RT17PWbGH>MKr{dwT!Y(YIU*;)geT2B|77
zOGiIU2YCk+rf?CUumT7Mkw0TUg!mW@&z5^Sp@;o+#AW)apoGKR{Gmp{kEza1R8|_A
z#E&2Ql!c*zZ~K|fj)j31aJ-xbgHM@3YpcuJ7S$y*pQm0}R>mJ6&xC$WC8|fE{3?+&PA+Q(fe>|Gggq
zr@fF7)8uePA8_4G0pvBN6OW1ezE$IxTMXpH%*<$4=Hh^<<$Xbb8YMtr7iaAGMngED
z%6H#qV|%OQDASFJL<1kQcv?T~`Rhgm>LN8^u>JG1+|~h2-hD@h2NrfuZuviai<%!n
z?R-9lXEFWki5g;`JT7bOwg|r01#1;D-n&h
zfyg`F*?jV(4u9qB$HOa1U$TZa0oluCa_)3bdcmfA^AF%qnp&65e;>(>fcph*+jV`3
zVGcvQS+soBiBlU>(VuSl$yGOf-Nk4>%3qm`%{e2#5qwiSZkE7-nvIKvjhO`>d2HZ2
zbWd~BGCV7Jpg;5S5+GMDG1Djpz038T<6pDDaylGw=^#VTphQl*XrhzuLpnVR^{A2n
zI9JNyjjqT2fQ2m8FbnidNoncueoeV4(RB)g4R9>9`}+wj!U}wT*T4SCn*+MuXHT3A
z@S64UXDBN5g%3Yd`nWJMSDK^NCPn0Z941KNtCo%s%FY_XaVXbxtDTO>$F3bkEY^rS
zk%-kg^bLA&EuT_hW}_>LB#jaq>Yhl%M&?m)YPNiT;CPs8J^b(#h+Fq0G`33S7YMmy
zzbCqMJmW^`Pp6l9N-__x@{rV~kw;H&v_vc0pEH>mI
z6qS1VlorR4^5ZOGQMxN}zQapQB#F1S>3N$!{$YHJ#Br3L|FgZf1-5GT(d&0%O#)_L&dxqp;Gy4XtQUen{%7}B
zZi9D+oZFP+eL=_hsZY))LdPiB6sS0#e0{sSySEPx9u1eD27-SI=b1+2Fb89)=O
zJ^OQ58j5(le4_2+%x3Gp3peY6h
z97}JA&%xO>JO$XxQ5#DiK0(%P3Ig`RR;fC>lLIqYG@SQk)$Re}fl#3SqwkP=KfkTr;MXw=~C1y}wp-u^%b
z<#0C**lM0&s5k-05z64#H}4%Y*LK2pE#RX2=NJ7KF8=u{Ht(H)jc@%An5^zGo*Dfj
z8mmZgimYl_p=YxT-?&+7n`70>Frx1Px+crCZ-r6fH;)U2^JchARLE|wDE#@`h&5Ai
z_<#QGz-PE?1Zx7e8}nnho5`JMQ&fpXHk*=O5kc3?_$xNP+3t2rJ9?CfTdqL=W`D#5
zdW0LDt$q$`U(wffWzn4h7rA}5Jre@1g~K&{S>5#M>a(J9n%N(tuPN2;5fPy|JEOqd
z?2qV>LezQTWdX>BR>QhcTE+Qkm}H00yED}rJ%H|csVjVQmi`pel8$^FRFFZD^&TL2wH*UqXW>u
zS}tModHwbFaS!kW6|n+-czRrsdIjcMloYZ;2Ca5POU{TF$*musK9O2kIl(awf<#ap
zW=VgEK2nHzbvv$h_n_{{yQw!}Saz%XG-FMxloXE*+aj~0_-oEo3Nx9bKK+;K3055a
z%ZSy^O?Jo9srdG0s{HeIg^TjBT6)4wA)o
zP4kVBh$_Op(!j-`$`zqXM7GLlo7)Dxa*;!d&g=HBL=aXA;S`@jPvu|x6JB#G?^OG|TgS;3w
zhk#G}AgPnpyDzVxQG1)~Lk9}8BJIM^;2rA|3lNB9eOefq}K`opX>d5h3JsJpX6(p{G
zuWcRo_C;Bf8_>8{d`MrcHGU(Tw=S1;d3SX5P^rS4f_QH?w2mDrK7asF@Vh-EFN;*U
zDMwx~YfRn_Ib7^HrQpm-0>maobR&2d1U5hn^F5M(N!oE?Ro4|j<)O2;bgBjZX;DaWGXA7gybKtTB;J9!
zmA+oUj3=s(9HTYx0{`(W`r2%$+#180{t~B36+XMckF;VjzP|AS%p(@!`ua^)$}}1O
zmK>isxgl(cS7i*3Hc?IQ_Y?E^_BEkL%^C!YQdY9x@Bc9GCn{`A{HQZ~7*4|z48JiM
zW>Ik;_coY|G#>eYb9g7JG}Z53Ol_)Ys~~1>j9Zt5A>84F3dx`zZ3@cQ{_?|(gjokH
zo~ZQNH@HvGu_tqjELtNVp2%$VjJ(KjGWNoxr6!dqS@`TJH_-*|%^0RPf3DAi6ycAA
zm;uC(u+M)^&GjJ#^&_3pej-&S%$>Y`1`X48z0^SY{)s-mg=WI%*!#NOjWS7}Vk-3q
zGs5X^yNXw$E_Z?qIhDkp`H}tVa!P6&PP0}}9FVh+l{5%QV<0(qbP|t4nboN+O+6@o
zryPsXtV3eSm_zELp+R0A+O?W%O2!eo5lLS#zdaMq_zui8Ew?2e74WuYEJaoSRVDjY
zI-d*eEp`z0XgWILttGgeAE582pYZG%slJX3+=O=9B0C^}HEJM{|05uKG!LC?V4^KM
zU2i9EGinot&(P>7gP;rAtg;0h4Q9gy!EM(vTJ_VlX9{XOp*P&;cjbF=&O8KWmZO>(f6HkoRM08fMdRU
z!y6mhrmvT{*_j(tzzt!tb$qX}Z+EA+iOF*1WI;j<)%BM0J)um-TJkec;QNylkIWVE
zSUJA_8r#wpqoEpzXK5Mv!JgMbQX2}8@bK0caja{vk+0Lqd1@Nagb2KP`t%yaV#MW{
zj=3V0udg2i532Ldd|JpTGPITjizLuLAfcX!PSOK&8ufz%Zg86LMGVpEV@tFY9Dsnr
z9@tNPPX{CKHZI{^4S`jYb%qg{fT*F)cRLrT|ft^6<#b8hUBVGEYX2NI-IarIC8gyvpBjXXF9e6&
zKos3yv^ddE;IId4REvgJqxT{V04G;FfCg**Tgt$fhHe#|uzSkV`Oas8=E~mY=@+Us|N)x0cw(jn}2Ed39@PMKO+=L;3+1uvzJSW6OcFPksSrlQ
z{lo)y1h>g3X$+ED54K5v_6+xwaorp9DZDF|!ziMlyLa$0265$muUeLn5Vv(o5j_Fy
zqOBc>9B=MP9!GqoR$_W?Mz&=vn>i|mG8#d|xy4Qjv+l2$-iRhdD5HLbcWLy{EKs55
z#U$_)pMa&v<>XFQD=`)Zdez1#krBuuFV0)_>%j|U6n}<@uzR7-Ou*Vby*DHlv+#yk
zVNqL!XO7X~(g_=NbMk>i7@vzXeLWPD9v+f~#m&<&2)}Y1=^792F9lPcn<3FDz
zRk)OM!h2Q8FE8Bo>aB~Lbu>K18HrvROtf-b*u3FDST56~keg_wTn;EE?eJA#!Z_Yk
z$@)p(w$8vIxH*#IlJFDW9hx1WU_^QZGQVkm?M>_FCm@kT>O}T4*{BWsK5d(sadbeJ
zVE)+_ryzgrI0&qVMdSWz<--gO9`f*@s%KxEJ1E4k*Onnf``7QDW-fzZwW#ZA&lc){
zCJP7Wl(v(T5E`50*WoD5NA??|PCs<-s9tl?aQy%!)g#Gefh)KbUmt7jAFKciG`otDt3LpF?U~|Ed_yruW<>UgMv0
zt%MBz(CH2U?G_~`Xf)=tKYv3%XTG)B`u$!jKU=8Dzdo9cY4cO(UZ#^vNq791Z41!0
z!x?eq3S-j?w9Dj!Ss7@GI=shPTKyW(e9_r8h4R7ThgS?*Zb(t^@HlZtyD&aZ3dZXK
z6;19ViYFJfuTMr|V{MW7cjwBDKeBOcdX@r-#>AjBQ1hV}&V%Fuo3%_2f@=kmFaE+4
zdL6hC7(f0p#BJt;UxFXdhFp(U(M1am%HP_%>K7L3PXChP_g+`^a5cKQOt){4Kx`m-
za>l{;b)+`My!lx<5hQHwdQTbysqEDt!A;G93UDUvR=?^vq4jU>$A%ORz&nhpum=hW
z)$bw4u$J8uD8!)E-lLt{rM*$0zTq!bsZ*@)khbKRhvZNXqKDLCn7NXz@P!!Ewl`Y7
z8_i~kWnu7N-&gKgi)GV&^qZkUmFD!I<3U&rO%F|)o1jdo0
zTxPXqu_a?DIQB2QDaDeABylTY))tyVeNW@oVu!5S>!OV9BXQbU+Z8;xo^#b
zKBovpBoSrr>N~u~&4e0ee2)W|68K|VWfAWM~j;yKr
zS^1+*FGQISgNaGUL9ypgrd9I9HhC~Fq3u@w47I+_&*|nlox-&nA4l54#$9e|P7~lf
zqNWnE*;}k*EEX5FhjW2zG|c#M@b%@uHjE|HpO`)%4|m?KtCm8#jkMW2wAJiOxWquC
zMYb!vFj9$B|5Z)-q|O!+FDwGP*$R!uPa^IwgZzR{Gm6o62^6}h=HCkT8AwQ#l`2|C
zN2Lxm-Ek2@qAAD}Xw4Jj$ckZ?oHHG%vU%ow&(Bt}r-jzP^FP)`PNf{hAbMr)RW)@|
z@>07SSCj~AK4gbQF~ty)Nc!ymLYMn4{~PiwerSCqrm5&k7;6kD@C&SPbK?>XCo8|!
zo6MF3b!TZ$y-1Rm@G(&8%>p$rRS3bT154)m+XG{)qIwLdfYfA7BHEF$(1L%%P;}fj
z*WQ1wI3|FAlVmZx8-kEWR_;1{vQyEUmfC1_0+?X6!%?d=uXN&bj3h}3bju{`yf>6w
zHaSfzeQ_0GYk$$Lv2rZr!wPll_2ET-mR`aQ652WlBBoR?_>t7{#tKOHQSbFP$-Y+!
zyqg=tBQkDxz^f@OvcK3$A-XS;^QuHF@oDy@J0fKL(zgYd!1u)ecTdu<>MiFxls!suY7A%V?bKh;&W>pxUp}mud
zk&bn<8pka8hnugq-JRE3f7K4A0AZLMNJYwRx(%|yVU+^x_r`xAFy(d+44)ArwD#oB
zpbd5|16kAa7`AvSK{($=wm?5jfE=bgzEgm{wT$wvZ9vY89<>Vo8Fvd&7mC
z>rXB~0^>G5JSXfdjK7jy3`(H+TQsyxM;~v;@{)^3vah-lmwvD!JhI@lH3xL=-aYX5
zPPT60D4RT=cnE$`j_k6`F&Rq#JVJ!Dol(l8)v@=nwl}?`9TYw&8&c__8bu^EFz2+?
zOe0i`SBCyn2gmWaM=~M_b8{+byut#KJpvnlKK~Tta4+a7TS!cUuL+wA;=8bMmU??`zf#@D~3d>DLd~5tO1bW11M3gS9EAYof
zz)63-Z3bayR08%Lx(kSXxp(hgMXRywG7O&GnPbtIY!EoIu_&w`g%a~Q#J#$U;D
z9p)qsda9yI4q(K0kg5V-xK61}SoMAf^{*u0a2eMPs393=J5;kT^Ra9;4N`AIFb#rF
zBHnES*$%@kzb{C1IFAUIXfW>aav|yoMoR=GKvV*|JN>1=J8;C)AMGS6IbL3*fbhkG
z=1y`FMeMD?YeApMCGh=M-O(Yy2*ev8*7TVI*2ipuk(9Mw3+^d6
z2^^u(`aj9?N!~g)KuRu?Z@^q8Zr9_sd{w@Q<|Oc=#n3|CDb3zh;SJ3?*)E$w*Chi&kWfZmY09rSz!S22t&cNi281#QRQ0zybn|BQ-C5pU7+s_6WGKA6`F
zc>o&{BO-typ70i9T(t}VcIhwS_^+pe?4z$LoCL@}CO^L-hxVtqt0IU}l^r0WXFZzs
zziA@@OS;a1dAPT2j#|d=?AYGd_Yr&k-?Xq>{p?>_n121=v~a%H`2V7Xb={qiDcFYJN{6blkVOG4Rh%Jw+xw6D<{=@Z+WRNps`2enE#2yXIw&^HIGg2j^xq>iP@O&|lN<|ilDX1<>ey5Hxt2^=R`
zNwze2R8&9NKsST^qlR%06=QRhh)>6tGE}|RIT@@82)iKmU$1GVDd}H=wa+9w5ZdMc
z1%AZymA_CdHxY7GwY5D1!zBf_gm^&E$C&0`PjCCLYB#T0TG^HBvO>!U9e~wes6tu&
zTa_Z1=8PA?_-qG##E*C$0npCmvPpMqiisg{NhIS-w5o!K#hT%VyZ#BOivE(8T0{q~so4VYhd|k`G7vP-BYb0P(y`
zutLY5lkO?d#pyW+9A}>jO+63&#(CPcv{e7pr0PdxpyYdY2x8^&aj~-&Nh-c1r30~(56RU7WcuX2}6i26X?8lqW;S$ew`Jf=(5(i45xz!KK#=gGK8iM{{
zQt*uzoa(Bp8wdH!H}_7brCdxm5YhA6m#}lyVbjxS#ftsLIRha4FGB3mYR)(7Qr=Dz
ztY)!(jyX|13wIun!~h$($<`y
z31)+}&*;jG>8Cj%0OZzfV9*_B=sUocgZu@Qndh+_?@-y0zaga#s~`%D+sBu#A`lPiR#8k7hu<)Yl
ze+ZpI4dKo$$QHx&Pqp`^!d%VqZ0|H8BLlfv=fY7Cw#78nU$d}KBs$_;BK$cHeWkZh
z5ET^`*52k&SAECVt}!!i7`V&w(EGd`%hqPYX@5EEY%6l)Tc8F-8Retxld)YEM``DY
zst@q7k54=EUD+b$o3_6+^=ML3T`Rg4i#W{xeRv%xw(iHjKjbC8l5eH*C0*E*!s}m#
z`LWw!EtcQ{lwS!#+WWKOGt(;Bu=bLNMc;<|s3wKsS0AEM3*jGw^9
zJO0&TdMZK&u2gkk_>u(9FS}O%iQC${pZxsJ2`h}PzBDd4gdK(U;?Kp9)|_3unv5Ls
z=-lVR3?blE`axclsu~7ep4lj2%f&fr4e0z>o74X*v4L)S9ugbI?K=JN7}(g%A-rm9
z90y9;=Kv@z-p0GE*7X)To7E{-Sp4$tpL{Aty+8R>kPwA-c8%fH6X)x-_5*#I8QOmLBa)BTzdr|GyRm>__+x*L+}3ttV>9NfdD2mFR8@{l;g7PB&zdUrMzK0@Cm-ECwo&SW>x}Hi>6O0W
z;o+Bzc6LX;F5swEU{X+4j`93sS1oJp1$lVhoxep49rozPo(@Iyew#i_SEd}ag1bio
z_3RmNhg+=MD9Dx^z6vn!!N}}P4tsewOrh_u%^k6YWIOtj+cWDm{0>Io
zK)r#CChRmomz|wW`uIH}>t`bX`x$LWzmSdXP-veEA~%SJX<9*=_FFg<{2;j91wYOD
zc;$XZ9_^;K>-4m&YMIzoX9fSxKY#4doNh;TVYH~I2#1mv6$4|);;WQRZi5dlfVuLJ
zmL!!=3)i_a-rryID=rme)Y?r|*KZl`$tlWO?~8G*JSdRSsGSQSKXKO>o@JZxexu>~
zV|Ul`u!zCM1cI2ny(M11ew{GnFP|mC-re7yj^#%uhqzkYqc04Df2Iy))FFx%a~({n
z95V4mkSD`I1Ipq_xK%*P<`ezD3zTpwlyZ}?r?&VhV5hw5tmWTkO>WPbveqTxg}jJ-
z=<0YDB_869&6u_vL-Qm-2TXE$LL`Jw{&W;*tmgyNAI0;<|Cb5c_~>!Re-b}DYz@SLCZkAz#!|Y61u7e
zSs13KrlCuABKS`n|He!G{eNG2(46A)m!WSlJUef?2SI*nML=x7lB>sKU{KP1+pA2Q
zA#7)-TE+zeKRLOFf_LflV?e?i)dG=;2m7P{`n4&f$ZW&K#l>Il-Z?5_5GoY)!7&yM
z9mS%b7#@y3zwOG*0LhYn!lr(I5ytm_lYmYxwjad!$&cC3d2`kP0Yi7dCj)2j;Lw(V
zPP)E9_E@%T0~jo?9FlW1$KHwNALHZU@uU*vkV5=O3`;UHvgPICZ7hvr9eE^Vtd)&!
z`&9Vh9HH>7%cKym*Zu{WwKd1qNHO`vb7)?U>wf~sLBZAjhB=g+0B7dkq`CD~P$DM@
zJXp|A)lr7wK&;0PnAC_!mouOL1_L^%87s}RUQ)q`v>h+iZ=*7{XDWYrebqUaHQ1Z~
z`a%C^pkJ$qI;1>+$bMQP|MSTt=s*(r@0XTwF*5#+rV=&t>ov(n_rl>9eZxbIR}Hcb5%yv(H#
zM)F<$!*?4x-+daXASufHo--Ow`)uN2tHU%!$ViWOd9>q>GcO+9zvlzQ9qrB72x
z?~{q2^txN~a7}YXjTEY};wgNEfY0wpMjXz;j%6}dHVV`N1j4Xt|Mob#f-;dP@Zi^1
z4Q6!Hp-q$#Ssh4pVmkJEz&x}!CgUZKzw#_`dC-c*>zX=CD5j_FTVrD;jLU;FciNAN
z`Jx^WGyzk|u9UHgw6*$?^N+@SEh^oReI4oiKf-XksiXD#vz-Bz_rWQ3I9%7zu2+Yu
zq9_BMT>9l8P~IuHn!38au8_~QFgp{BC%u2az2m@c>!ncapMGMsF5^=0Fb_4?Z`CX=
zGecL)a3;{5oRJpOmq87+4!bS@Ra{0`R`!Ox+6_EHnJZE9<1*v2!avb&)S(HFJ-mMz
zK@_Q{d($v>vDcC1sNb=#{oDF@z|?6?ms4jv&scm6Pwn2M)nYtMqZXw~)l5kVvxts~
zdFc555+>JpKSu4`O+j4{^AQzh
zXC`n$7vsgsVeAzyURf;1?-c8!p|dnIyFJ82IS>
zbsUPwrGwy$jjZh;p^_R_);m{IXEq1FHf+@Aqt9rY^y$`>`tow>FOkRn0!#oC}VwaK*+KDHi50DwYXd>N0!#;mLUrrN2jB!wjxq
zy67T}UAP+yc|9MGGVA%(ch`7)>VnH+>vSD#+m@uc5`rS*Qa
zB;?WAe&0lQRlKGF7p8
zErxg{XbKZrZ*A?F#kT7JK^An$P&gy8AgUkedlNSI)(K4zxVKMKH6bI9;g
z*B;FeHFXnZB!=>unvPTjq(_y^qqTy)V-653X$H+KWo!=2iIl?TU}b&!RHbz{^tX>U
zOe0UM%epP+apT6T)YP+)&(oS+Hf!z~UT$Q$iutB$s)@i@KUIf@(%Ey-$
z)NV2lH1Bta5Ijw~KjDyqS&EuLxcSm6dQ@ET>UsWD7sM_wL=+
zqpyyDwGt>L2Xx_FaEj>~2h)4{>YAhAneY^*&0su-CwOrr|E_OK_`
zys!{?qM967#nqk$2pF^bfUT!HfZfZ?(2U~lcllmy9v2u$mSdq`8Cm%vu@VwrQ%aAw
z_m&(|=*r5z4V$a27~;Vk8h}j|v?MeE3g6x3V&|?6r>yn6POm|j<$NABA}{xDGgn?F
z?zTj;49~4wFL7{)Pfk?(C%LI}J|Wg8jDX;MwqfFZe8D}Rl$dzSs?U21RpAQmOpd}A
z7})E7ggG1R6p^zjasxBMjqUcupr=V%gS0PZmm#;rS**FrPotqjQ7Sg>2fC8E6o2-4
zI=W4y%Fy*4a*^bDuz}+~@&k+0D1wu8>D~~UiPV!MOQd^T^
zeMy+<%8W;@yM3!chX4RoD(7fI(nsLk^7Z?E*h`U+aGGtw^A7u+_cbi66eL}?oAgvf
z>C(toQLhL`AclS9c#-vD-^ObdgoBdo-*~#OXW}PyP7|nrkIf
zVe};Ct?jvcBpT};=pOIq*s*bsK$pr5<9>v!xuleoqOU(`Y$=a58OY)33uu+&dvA`m
zPlF@tt*BvwRGKM+4H*h1KU^o{9iw;R%%1vDl9Lzcw1_G@eyoH?en7O5{QH#gtnV4qPt1)KnidF%Fv>u;re!QdX5msbYCo7-7Q
zfqTEP1(@hcl;2D)?(ZwWVNtI`Q*yW!w10SOv}7eNip7j1r%tQkcj3cUIV|ji>*`I8
z$+O{~g~PM7o4D$qn~guZLWu<#r;`vL5#Sq*PqfhW5)H#4PnD$I5N
z+K$YLc^(;E@uROV#%X#eFX6ik_O;TR>9I24Y)N$4dc&0@V67n~@@E98-f8*uFzTE(9+fXV*sp
zTK#q!a91GcW3nm&+3wAx-tf`khAQ|XO*<)Y=h3Ip4o=R-`ugLGbM|<(f9}@KtfbAdLe`nqEOfgq9Q_Aova)2m54xVqe*Y@==2d0|
zHknRGubp+t4`srJ-rnQ1Alm{8n4a}EEu{9$vPd>f(I|qfy`w|d$Oj)&#SaRCQR_sg
z)5^)t^kW&)tcw^tU+pd0Uz_{B(`aNo!5Iyv5MBrx_;><@F%fZOrPr70UybN=cOEE2
z_d`VhLsEBsABdV$30~Y9AIjTUnx~3*9y`xwxA~|-%NHUEWv>=9bRgz1!azRd5rI=<
zmeXLdR`72`(KpHEJ-gX+u|YrAyXuJ%I|gWNPJ
zpRMNGS@(B+67^0yv&7GyX+KKFC1Kt_Ja{nTc6HHV>iYtSoZVN%q>=1#7vDqf32b6k
zejfcmNwsm~mlr-}Ks6{A)m$~5_zhO^_5RPd(XTHDB>ouEpwdx>>83OIJ7$I(7h|I*fQ+m?>0riXI52ja^w4M!wGL5oM(lgz8~Og3
z^u_p%a|*oDNU*j}
z`sH}#91Pf2gUI3Z&%$gr8-}i_7w2}!eh_%qr2M^}BZZ64)>zwQ0_wk;PVacT64i|-
z)o=}q<5!B?!e0~i3M&*``lbvHe#P=`_>t`8<3m7qhtZGdiHa*ZcOW$q{ge(?Im!g-
zBb74a#`@bD&CT}}Z3~sAA6mNAvNXY7dwsT4Xf?boyH_ZgH!A8>Iczsf4Jwf!c<
zUfkKd_VeTWi!Nn40jR3Aw60-=Rokp>{~|es*g!1-7%kZFM&oCK3dw$
z?Vb}yaWNVzEAHpVusKku|3aR?TzHagaP^SSl7Vipd_gSA=;
z0)p=EPHngXQg5@;Z`KivZmsmyz!;E1FWm2^%tQ(_HPktmJZ8Ap8&Yh04f1M6BPNSg(qav9jTD!sfB$!#|HLM0t?H*bx
zt{DP*k9!j4O@ZAb#Z&yYOgJCSca>u$gYt;=%AL>ECJiz(8+~6V3#<9Y^E=R>4{HqD$Y2QfceVFs!vml+Mo>`I_
z8Wy#q0BN2pa43_om}-5wMFA&sKPCCCa6MFBz9SwddrCo1%<_E#$>uE(t*?&`AkqG_
zg>%06%aLdQHYIhF;pxvMqss|_9gTX$ExFy7DqwB<=wQHw1pQ1fKflxWw9B_|eIOt_aUdW!{Zjp49ZMTp?2JqGvBWkePfYZV-vdS_KWjeQk<9b*+WAPZ(`ya$
z(^Gibk_4)szZ0i{E$IK~#P1PQw=^2Q9B)Pf$(Py>IU@B?MbvNKV9>GkRcgM1Bad0T
z-5yNiltM>iz;n{so(lL#I=B3W6A|UzzvKUsJ40h>uB4nLy9vAJr4rswtm>WK+Tz-N
zu0HaT5d6RVjg1=^*Ow{rXCcF?rGO^Azd-9eK0cR%g6a62lsfW_Qz`N*Z%xn-zQ5_A
zN##`HQ5k|We(#^v_WF(uBo8GVhfb&tk{#YlCQ_oEE!X+sSoRwww>y
z*RG?rS%-5_&ijUj3p&}x^!m+yxl-EdjhfOi>Ed#$TB*4Vf<}ml?>=Lnou3Ok^J6JD
zqtc(cZ)r&xsM>Irq9VJu?jefkPkZ5x=8@xuNqN+q*~RI4zCsLwe*S|5QYn0qZ_<94>7DA-reg-D~3{!dj8Rg1SMc4
zSy}mV4xfE>L#wn|mF{BQsGn1PwOu}!2;?CO92XQ2VZ?H_L0*U;vU5^%3m
zRNI+}i5K%(>3vH|`qJGrQYkH5_qw$F24k{cT*~;kTFmpzR*I{ht0Jn3$LzK9q^z!N-Jw
zi_e3}=bT=ZCwgx=a9wQv86a4Yla;;O$R4_v$@|eIXT|bQ{S317IM3A
z>-*Yp`jfdB_K75c4s!0!k-8L}+T?*R`WCwZG85zL#>UTkd*2>w!Z#{0JwI&l(N{K<
z@ity5_=}{H;6QJecXtbua=Q2Wwvo|TTSLQVGYtYc
z4>&m7UJxkQ-NW=G6I+ppm!ccQE3L1PITez|R22W8EuE;WE2oirBvTA#(?qp0pPe@`
z@myzh&*!xU$+&=(kV~bsc2_zDI7QW*4BRDQ@ZE-OZakz70
zu5R1_NaD41L$*^gz2_G{vUn@nPA84&y853kl~;YX3B4Sg6Gy0hUUWs&P>EqO#Ds}aMLG|x!bG{OGIA;kV{tCaeHdd
zh-`uTLqhENN55VDEI6KqzGCSaK4faQTWDQrpKA1OL^nbO8XQtP{`H+@%z~uku{g8x
zHLm^Z>2gW97-pY~>Aaj5Y!CQJ^H{v@mY{&kx)KH5NVe=@P5ZOwYST~w98IB_mm6hu
z^;2IdU|3M}NG`PrfU3eAaA`^_UPxHzHumTCmF3k(4-`4b;N(8QC
z>72i>j(R~grXuK_yqCQ)d8<}M_1>4CJ6QD=yOko7lcM1B87$H*hA)w?HuCHIRN1Fq
zr!Adh3eb2gEN#Fa?%tK4p?L$#NlN>P6%+sYZd6t_12!f3puH@J1Sy~eD>PSt2*XQZ&NcN`PTxWXPeDo9t
zU{s>xs#6{p8hm~{kp?TPKNUS8J~x(o2n%|gx4iH9!AaoFl@8eU@+IUD_5qMT+59@n{1rEff!Y^a7DIW(=?fw>&-A(C$yfno66{w`@k#lb=i9$nCxt?3kI{9
zF#Xa8z)eBX!yu}@-f=|Z+0C044^+9TT`r$5^iN0JuQr_$cvBUGBS@p50+W!8egr>o
zChroHq|iXe!1?kmvzx8)XE>d|cd2SQPVJ?0m4w+RX4zl3F^iA;;7k*mmW{}mc69V!
zoUg$ZUS1#faT=o{oCllowV8Ue+^t_Ov&c3aw(CN~l!cHdLl?go7W_~$dtAvn{uc`!
zg}tTBtMlIn?X4AL*OpJ(Yqyg^4lJ5+uuSYr@xG-7
zf8sBq3PNkC{_YR;^b%^1-%@d?j+Omxo|rhltWNL!1U8(1*lplC*#vHcC78yKCroIjlLzbmVjzIn;gL{RG-`yr(dz
z%~VS(rRte5b^oKBB0>s#GoWOs-zVpH=f9<$-<)8Aw?fN_dC;38dcQ)LfFLbBJ)`~(
z5;Q}J0#4x%{R!x2O-vkUZe-RyI+<2=bfkXvI#$JCS;v_M>19E;t8cgX>5-(p1Fp&F
zeh2UY&-y+a{AQ}LF65O*J0(Q>d1rpX#QT48KBx~myzxjL>}u`B!RDh(d%f?UBa7{P
zpl}T}`njI%a(64RPDH=Abqr;yez`7F;k`o=@cODs@*?rEn#%P8E^mcYhq*yghRs
zgWFHdYsjSh&agYfnD&6Y&qq91$mq7h18IRrv=wg?yQYhQ^
zjDZ*Ir6YOQx}Fg%L1b#gd<<^vjsM5m^t3@z{g*d`qxLVlIy3A4lgNzOi1ZOwO~EeriHe#YFp0fChorUp3jcFUiP5B>=Nv%yFoxupjn5yLX0x*a)~TU>Uv}A83?dE@1v*j3(u}+
z$dJlbbhz!~v8cm^_+}W`#LMH`iYY;P0yGGAB*(GY(#lGgE#?|qYF3C8UF4Gv*1}jM
z-44AEk?tt^oz~^04{lPNo-7f-%uRkPJ^m~y?A^9n3(Hb%poeI$QQkWYi8B{|w9G-3
zlmf?*2fdu${m;qLi?h9e!RjwJ0;`SZuW?NzoXk-~q-NTKS;hW0qrengJ-dozP?A~IuJ@f7mj~dF}7o_4;Q`w9CI-f&VWxUJ$M6R
z*hq8
z9*Y-8szDq|&rF`WRx|7E+kr0J83Md#f7V3KE{#7>5!bKF3rp;C;D7wd_L=AIYXX_4
z#h=|Xrb$oGW?H59H>h#$6Y4@=YUpyvh~S&{?&rc$T_yR|!1w>L_11A!x6Ssjba$wP
zbfX}RlyrAXOUb4~KvG&z1Qd``LXeh5LO>c+kW>+AP(ZqycQ!uv{hZ%>&j09Vf3KKp
zX3bh_5N}O7<p|jh(I$-9V(3i3IdWEqMdLzI7umRlE50o#pNyXBxyfB_?`J1=C2vW5Sdsu
z#MJMsyHZj9I$jx*ujA*N1xU#I{4DijVJl!l6U~9|z36fbv^>>HSRbaTGiqNSiHUsl
z0}DQ4w73-wtK&~nlFXTE*oO}l6sJL##Q#SnvTFRm*z;N?0$tGLPOHf~J^;3bgx4z_
z4O95&)+_`Mb{r<_-20);keu9AZ1^QqDzqZ0`8MD?P`Z&~Oh}7Iy2UDdp_%S`W2UQF>7c?oE$`2jyN$;@yib3sTd2ot3&rnjX>rZ
z3+s&!3?1psLBmjmba!EL8|zf^?sU_wgSY=99pRe*K24*sRa6ak)zf!##+uQ#V
zG~Se#)x#SbnFMSg%GgTE5#(#s1|?zsvme?R<5+LUawNBWm&?p)vmou#*ALs)U@c$h
zfy#;Eboc3*F$fCn`?<$LY$o4tF4F%P+r=e#`MGzWic0+ZkKy45J@L(8RO%1S!>F9E
zrBlCr*hBeDEACRUeUDNUc&Me9$g1+3j_w1p=S4)sw!;k#d33$x%l91xGKhWAFn1`|
zu$gyBUWHNx{2zTCCSK}Ilez)_)1&&KO98m!wbx$>^vb94`S0hE{7ayq=p)H3T#Szk
zf-_=V^%E`%M`u()?+6W9F;14au{^JN}4w7OxFbV57bD0<@y=PtoD#Puv?Dyc`-f?yy|k#>UJdB$n8Fb6!2
z>#YY?R?S?78un*GLIOes6Iy!$q=K=&V}SvY{b>s~cHMn^I`Hr^VR0ILqM|NpnXPyI
zg}RPZLIDx6jI7L`Q~5fb2k0F&nz>#GAOp1L`}LJL=4$@`gy;2Uf!Po=Z6_I&wrYp%
zr;Bdi-tx|;B#?BYGqdk9ATaJ%?lKiz`~4*otSTTk)8-n0q22n$28E5}H6%kW6uDW(
zDW1MvLrjK*ug+P8&l~X$CbY{VbaOHJ`N>k&0uLAbU~1T%>K?@d!6=zGxpHRj>*TM$
znSmOjFXiTs4_O!u=zwvJy<^Te@h3KIJ6``%yo4HXU`5I|Yj}HrMpyrVpb?LgR!8ci
zo{XO06zXVM-Ac>LlHKWDB-G+U-3;*Zxag|-PKtXJAL
z4-WFD1YdAi48&lZlKyiNMTFLP&wpQy);}vy-$K;d{S&38E+z^*l2dtpg8SXQ=_^OO
z78)AnnD5#yiPMSqqzd#dfM48|t2N-J6sb;QiCjGU%+*y0AFTZC>#rn8a%3a&^!;f`
zxuoGuM_ylo^tqfGO$Or=B4
zlM|ak{bD;t3?n12HY=MM818(VBX)arygR!Cz!c7j_l8Gb#-K6%v(lEo;427TxlI=d
zRv!*kx^#8LGPnWSS^CC#IQjbHcx~v?sPpSX`R8oVsHuXJ@m$iP|G_~g12ntfCI>>O?fsH)DzN&Y~g18^kn+RF%g$hJH^CV6b%uuF;1(;!cxUpRYMaq)Fj
z7#`BA5NpmNXtdhX*O%05Q`Gwy_!01Krdi*``GKdaI}GFA2di?a&_BX>Um|$v^v^og
zi0>DRzeCsfc~h{^l3&dK=+kpY4+DEs`Lc96(s}eXRV@Rhkn>RMd8Mm_*^Sf9e)oxv
zwikVovO_?Sn&?G6JmG01@zgN-O5}OKsn8clqq_cfI!O6+jR$TMw6u
z37U~BZB5z_6Ohz*rbt#J9X7;
zKfa65*w%Rt2)NYB^H&R5M&gvOgXaGC?3>FCet-`YA=C|zm_?+i)Y`9PbP
z9u|hNc9lFUGn30i9urlkE(Sk+qqmH){nY1@v{jl`804f^fJKMu>npdA9uDlnxP(Ot2x1z~%%uUs7}&>g*hQ
zWx?Cdf0mYR3NO>G0h(HqTu^&^q?9kt?Iywfm@gbxso!s`+CI-i^XGO)pW!8fb1Ramr4NLDp$
zJw{08rq}7q1=Py5?SH7168Ni(fx>WJ9NFOcBCRGQW{77z`A#mO${7|CB5h^G;91pp
z$++Mv=_syJH>R^eLuBsTjzYSa;OfU$9U6xS)S5H=%6Y9h*{u!W@;qGU|XUi04Cn&#{K=hL?Aiks5{!SY$
z6zz8i506LA)#Kr%!|PH(539y3
zUS(Fe4*J`xMB=VXG_Tj(Kk6ZnL^*CZo<2QhA_;^vab*K;1C>C*m*jBhCVc(oiYvcA
z--~gNvzC+DMEm*mi9+6oWo2Bb0sCg0Y*S&lYp}&@leC20n{(?GrsN7XR!?cUQnPQl
z&+_ioF#H5_ujjp=r+Yq)Ke?oo$+9&okHV<&N*rb`;OXe(xGgUZj{ae#5)y0{6c!T~YKfTp4nEu+Fxs#WIG0y7}gOer(6=AY9@>Rp@EDAf&|z^OG?N~
zAPbNaFmXquxVhCtq7${6;=PO8;#gC--97x)%`$0+lWAg~d^C-s)DfHzXs{9_t+5Et!s
z3rsT-M(iv%uHR|^?0A0r_aQt=fpf9n4%8?V=G))u;MVF;|Y+247xtpkH-7*6(l}R@DeESQV
zkwT9dzd8l7?e*~*pZ?oZc}?pYUPkNda#`nVV+@6OS7wCb+(KG@d{SUGczN-3qbd>V
z>gpCsLAnzD>eVZ+E5soFQ_I$3)}zI3)Q=C4cyTNCCvR_HRhfSdPtZ(coEGj^bUG=?
zFRlhwmII-szjE3~GJZus7fi>ND3vqQ&X1~CLrJoV_xHw=JjJ&(;^*ovXFiuV8edzg
z8Y!d<2AE{i3kW#rE20W*zC3@`NOjn9PJ8-%5xHc8L7o7vSyRbM65B%kMIC$<%we*Jb0@idy{9tHsK^g`qsin;d6NyOJ>ABweM
zVs5HFmv_Ye*r5NSjQq)@fEgvf_XkeRlc!TfF*tGno;Z#hoCEYfGZS<_k^3k|^?!cB
zdByAeiWoUZm!>vnD}+-2w|x2g>8GQGolB2DGnpPx216hK>WmGZ!1#E2JHf97mgKk2
z=I;w~TZs#$lda`C53es}YgL={56WIdb$$=bl1E*+J&pFn=e2ln?v
zA%eKE%LdX|-b+JkNrqI_j`?&H3uSv-BiD5GZwM+4=oCz&=-gbsr&E;|yYrJ&#JzhY
zH?*%rQZx90hkF0=lVZi`v*v@YkDu8yUS`lRK50YOS9)|=%;tw3w3b@KN-g|LX8=(I
zdG@E;VH{xmEp*vvA`tk;;vax1E<8nJ=l;&w1Z*ijK|)wl^=EhW-MO#JcU}w4GWSo(
zeFh~d28vmjhcu8$mTj-+dQx>_6!c}R={U6V)ahN
zQZB`dYmK!?pd<|$r?{wWBtFSU8CbVyc;I_Hg2dfgLow<&mTx3J4QtT1DXQBlkVefW
z|6nuZ6Lv=~{{V+cSnd0(7P6$nzL&0nwVGBL^}=q5Ew2G4cgB_^;@2{Q-y3$vwX}dP
z>Bh!-!!n()33Ah$H&N(<-;@2o%yC@QN^fhMH*dOCQR)C=Jn~#78qCeZz)%NUP!QgK
zafSkOzok5Aa4}>+n@mjTUZ3%(
zto$lN(7gMVnuzX|zL7OV=)1F(pW%4*@ss*49fCVOMh_#pYvT)brhM7>hTR
z#3Ekh6|@4hIgLi~F{<|q&lvr^c_m{zyEZ7#ae2tLNY?<0&)!^F?V~V9&7o&b=V-9~
z#CYZbgdIU9rZq?lxk_$E=rb27+|2`+5mExnV*-zJ+Ut5g*$Bb!LOTM+)xT~}aPsK`
zNGC&)0PvOFVKL^2lYWB6CYcj5F_IB;mm)vEcbR|4JC8agKy=sAs_T0x|I4}VWP2xG
z#=E%tWyEQ>?xSx5-PP7gMwV@^TsrKi?EO#{aPeo(ro(c9%_8Vz)B@==!5Og>)ZoN?
zoJBUC*|5180UPB{Z78lrLdTK#($cqt_4#%Whv8o@0jQ<$OU}WhrQwc0Zt@>%OU=Q%
z?1%KKj$-HCwz6+;KQ$@=rp4~cnDz_{_9#6Uek08*Tt_u4is+&QBZrINczJei&Y{s$
zT{eqm`9?(lKiiDHiYjQLKM%f=j>^MssIh`v-;U(q-_
ztkWWRO2ZKr>~~ZIm;BSSiG~`R`PJ!Gii`l-Wne<{`j*$oXxbu>+7y^QK+%t33nXyy
zb0Ax(zNnR6Y25}|a#fXDgyaJcluGC6+o};S==H+Vg_2gp)6?#FhyqR2;@yn{=%rqK
z?%?w4QTdC)JG8LS0dP@hCLIt#)xW#5v)DXBTwo&qCWc8+sQ_&7V)R5K!qQ4Px3-c{
zUmw=K7S=FLp*q`r>3SH`6nOr7bnH(T>(Oklivr=IZuBbI
z`CjVCA|Dgu0ljWPE5H3$JRTc>ToOSRfQ|l2#QjP*os`FS=wkwMNkXy)j0%qT=si7<
z^!5VXJOVFT>dY5kd3R}8g3Hkvs&ta9IuVnLD5w+m_uH?de!l9A$WMi0P`8enIeWQa
z&t8pJ^=sy^gg8#o2)7lN=hJOEYf?uF~JbLLM!q5&NHZ)>Gkl-Uq(bkaDLLTPrJTL
z`mF4?PJRM4YrX5MXVc0
zs{m8(?Cf|6a=_yQd|Hu#t*@o{j(@H}B%fUY6lT3i*u*P2EVJkFMWpE+J%B}%GFyO44$FV?9{1FYlzw?tJu7YdYjmKBT
zER)!Rx?Nu~rP1H{q>Ruiz6f^LEyX4PvkM;rr<1aef}b665K06=r@PWZWLRs^%Xw=|
zmWWh2@XYT)_9$l$ch?JO>fv+qz2Wtq-4(e8Wv^!LYGDTKW(d&coyIC3J=d&8
zR$#MGtk6Vt$F*E0pJ(_elUTV3&EU7!Q;lF&XV+DJ1%AOR6bo^8&rf|?k!eFC`k(Uu
zoIK96^7IjUZ9!(if>8jQRR<`cKD+Hy06&%QlAzMNLO*R;#0IRfl+-uCrJ+a+uRH>!
z7CeQZIjjICGsBZbZn_uedpyEEXu7saxP-OTWH!06u{dFk?@fRGYBdsGaatxlL6V};s9;KaK}
znPZSuULIddS7JUAPn99&Lt}D@Rlv(bP3;oRjT@&x8?1Jn@~F$Rze-WmT30u=-XcZx
z3W_w6weCjH#|XVmNv8B%_;^FxRGTudSbDzlzGE-%9B4LOCdEIFOheysjI!fB&8XGI
zcHZOA6L${#FQRq_rFQT=#4+~EZEbCfcKS@PZ+12vyX&sEpi|FY0T~C_7;OU4bMnFO
zQmJ$CDBheZAe93{P=p1s0R?k~HP+E#JuuvkL9Pi+n7bjM9K0s@F$jpwhKA$7i;S6#
zseI_dEl=m8Q7}%zi}65euI`E!ARpgD
z%k=c&dD-izx%B7^6O{<*UGL)Nv!kqt2zMma?f?15l&N+xq|tKfuaSt?FD4F--tKNi
zARg=C*V$H!+SEM!Cub?TgwX12Y=wMRTil!5<@`)3X?6GxS-{R>3Gf2{tI^GgSZ5l<&f@FG+YC;|@;q6KVI0e;qu!{eT!izE}7M-^o$5$gX^>ND7_
ztP>d@9rcFj7zF*`{mG^k04d*S(B2I24erUEpSKk;eeavo)bs!}r@+%BqD5@acAo!X
zshzw$EM!v49h&}peSwN*WvtQ1uukfb`S7LBq)Z~{3jfUU??8IPWGe!h<@@_wNY~Ie
zZ(jCi81rl?HiPsJ`e{|B2koF$K*FXU$=?mW#tJwOY+z4bymQczcbP>k0F=GZb^r$O
zll>Qz3RWzSa9?luCE4~NRsg@$&@jjhYA{)i3t7`fLJ924A<*80
zT<}BCWd4BECSXTrBn!r-)i@r{NV#NqT3K!VsAB6hiwAL0U(X}!b|1#z
zdAy{~-)(fW+(RLAKkH+GuteEOYKE6tx04edEnAx%-e#H`p>2ed)5iYZ+}8MYm%-Z%
z!mAHJBT*xTb_>~cM<<912|?)-8Zj@=Hv7R|$(iLsk;?gWgg%=S8y`PcP`)M&TwXr{
z#fEOnqy(t@IKUYTl6?ibq2Zys)4uy=-RGz4m*|?w1$}|GbB|3^(;l1QAnxki#_@W-
z>%>Rot5ruOGC->B+sX=?!DXN}=Q%@!hS~+rgJ3TmF$?)(_<#4ov;Z@;rJ5I)OIq(r
z#J6H@#}OkSt3iA87*JP4Fs9ctWEP)>|D7j|wP+O^4^MX!;e88p*&v~C7ATsr~AKWHfB4old<9###58^xaWHJ!CJlx8s&x$c&
zVISIqe68An3A%J{wZXxbL1&dr@m%fv`>!`aYjBnRx$*#O!Mdyk$Q9JJd`#pAw2-3GwC6Q2X*ar-ZbV>uHB8IL(~~PX
z>^af=P%}LOD^*Q~CFG64ZtBn6IeFVTN;$
z47Q9;SlT7N)NmD<>!;WM{d9Kp-mp6uwWnEk&gxkcqk$5}iVCvez9oIJ9vf0loSM(u
ztQV~xW)Kg^Ab*t3^BUavt8d=CS-ydhEs({p9AozP_v^_Kct{LKR$GiT$`*7kHC`T_
zlwcu^=466@Nxta*jJF`d&C~OB^rJM)8Da@%tQ;Kp>;il^e4|?oL5HJRE8$qfA)8a{
z4`o*;bQu#0_+V?4X6EK()1Q5lfu}wVbMTBVcT^Asxxhf(dmH(M+!moltbZz@2Y*h5
z{B!ANSzp1H`PClp01f$t_T>x>KKdiP($}YE4dn^^{BHTI{d^1F-;o3sA!zU27&f7v
zfH+`iNH=mpdjFb}Qw?A<*kzzSGKG>W7{rj`gJ2j8p;yt$3p7E{-+d+ZrF#rYspG?X
zgSVFOS}03!xvvJF-nRmU?fLOkhz@T17VckGec%24=nfqvL_9repp?NU6hS4X_Owew
zA!#^#sp!r!qxLZ}C_vAcB~sOv3qCiyfy2gJh6&v$dr8nei;5brPSTpcT6|A6{~D=W
zk|V;|EK>PW2Q?Tg|MMe5C4$NykDlyU)FA90Y=ycA{1ss9t7tGAJcXmj2)QjY3k&4o
z=r!3FDW#qm99W0Pm;2D+2-#-64LKVcoqqouXSW?I{rx%`Rz3g%g;e3;)S&SLHv^~^
zq_=NBtFIp$`<{}U*Gd2384DTU0-%2a$#!w0`&`D1^D}P-3d8-nrO2R&^by5uDs&K&Jq)d=
z0x9Cnm)`p>Ujd8TfFfrM#NN|r(J4ta26rF_xAE?ce;V)XcCsOROD|*RN8UHCl2}bi
z<*u6YsuEriyucn0Vg5fSph`PXFkp-1M!odkUPzv*&36$5eZ#iavl
z13`rP;Qvpw?Vwah1!4eO7xp|bGugN*R6@5MvbH>sP0iqBf*0jvS6BGC3-J+dxI#=c&WAz}Wdc;lZRA$|8>GfMbhe0cxO2$N
zMa+NoM-bENui*5f__PDq?O(dqjLI>(cuTdlzC3b7*t#Jli^x=?r;0OIk(;Yw6itVqiwizfv!dHTcL=I_x1J93a)
zg}!-sDwdVpt6p<;$LC2T@}=a{GPGAsrP@)CtsI}H4dfKR#V^jvPea%kEBW`M=I3*I
z0A?ZA0H&(f$X^DGbfI|YOWy8DCn#?0pN;Mf~*#Q7-9BK?nF2YVoHV`8;H8r7r
zyhk$-l^y-K2<7@h5yi!`pV<7bBo?tAR}{%7!(~fwIfsTgLINg~`BIpi#Q>>^>WBN?O_wx8P_Px1jc8rM*xj
z_=s+4D(Lox9hkp-@E2}d4mp^Zn9DchozaaEIg|-27>bB^Eu7l~MUEkMl{b+<#KoTl
zx;yZo)I9v}e>89-K9&K}t7j!*D7?J9S+VFNsFfpf*BQs~kQEFm`!m_=#?Sx#lUwm`
zqKois3M0HcU2}&gby$#h#+ZSz?d8RU{6e-V0ZLO@FY)AV#I@p;z{&YSL-6Aj9+4*E~
z?PsF*>dph7d=2L@!Q_4*0{ibP=vDjW<=u^IsNArba1@2A?p|5}l{WPVJ^D4LS%}Fh
zoBtu9GEyyvpj`)i6J|}%fYeseQfT&_TlPLOexn?aBXuSY&mIfder;1_GHM5v!
zvL9IE@o#cuC653c0|74Gt&un6bT8TdbDp*4(qE%ezji}31JE2Cmc2mTFYs`VD?_J^E9YnqgW@baiMSXg;=-B_~TSl+SL4
zt*wq#S-Y%7Zgt3L$HtB`sZelbzCXo~faRE3Hqnn0K;^I$
z)zm%!)(E)?*j)3EM|C}qmH^xsOin`$HsM`}K)C`l@i6h&Pd*V5NRrxLf8X{fjxJLQ
z*mqG4LfDpqy%v6GGB&dod8eAYy`ro&>(|M2+DWZ&-Jw%fSni(O{~X)#*p1
zj35jLUUD8k^JK^6>ANhc)cUpd1?Uh%IdsEv*2#z!5-Y2#m1?2&!EfKtj#~2{nWqZqK+yEWyrGLzSn3^b&>Mdqej{7@{2uVtn$9Ns9
zk7Kreqa)&9+{zIvetX>Gqlu9O!a+xp9qVnai)D*pKLTu5Q3
z;Q4(vCFt<|x=?M7AVx3+d#cKL$GYto|EIpez5{y<1P(wBczpRqbqsVd9lmc+2*sqt
z^V$Q7CLLBXV{qjmn;OEcob6bZ+<-zIiDQ&FCn|_TIv`ktJq*TXIqhbRZSmHSa-P2{
z8Oh&^zXj#!vuA
zRU`94z5s^=@v|-gXzfRm(rK`3ybg;`=ZFn*0XLE4xbg%A&95DWx)!))Z0jYmsaZi<
zO@D=DTt_M)nz;41mHDhVnv$)%XTPH-(FG|*?M++H#L&~jH3>Nl!-b@J>81X+zM#4H6RoZ)gr)1~hwKfDfAwG0dYh-+}RlcZl*P3ormqjpqrZE+KO
zicebsNl6!SW+nvHtFRw`#)+oO-U;G5y!LRoDUkWexUmuqeiE#O1i}M8lSKYYqKaf$nK{W#NVeZsGH48i$!7`f!4oLPmL0ZZc7MAN2Fw`y(
zRS1l*b{0_<*FCnZD7AeZnt|i36~}#9i8W%1AP8{T#bb1bk3&OSxD0<2ZVPItiIIq%
zBJg^#(d^<6zTp4rqlWaA{YXW+05gicsx%+)uV
zbS$5bfO7(w+fdA1k~|#FVqB8VjFl<6rB#V)hhbruT=KTWazWF=I7x*IMK}+Jfw;R@
zfhg*OvA0SZNum_BjA?aG)UK~q@8UI_GMODW6;JRKkz5|VH}QuU`&R7oyY9SZ^`t*9
z$fAq#W2OlE&>=0l3pC-;52-o3ZJ6>I(T_eypG4Ish=k|!;y0uqy_nX(%fahbghfJj
znE#ASPG#ZYQ2da?(GagrCa@j=X^qHx_LP9}33Lc2uOlN7%7IHD5J*)IU9=7YLj`Od
z9H8$4c9=kU$B4dNm(w_vC4CD0=Eud;Eezp3R%nrJW#r+A_%HH)*WoHV5i)=%4(7%I
zQ6gp}Yq7uRk0frD>?tvGKx#?=bv$DM=1l&r>CG3hGZ7VYl9~3%9Vn*Ka<8%
zgo-EF^3eO0GkJcCpUe`2Fn3W4oD8$3;#{ip@-`LeR^z?hL|JsV^BD4mcRsyl^zfKe
z%sf~c7C(RiZaiF!Bd$)V1hwv^0`J?tpncEk`;QtKVDyc@hbRcR-fvpN`Q_o1Qa&ZS
zVZ@74glU*vHkG)$%fK05x5$Md$zgS4$T8$IP!QeXkovi;hjGAG;^lGWSGl1VHgpk-
zdu=K3#>yl>Ayy+cn?i>MRRJI2KFPhb7yC%jLK(U@Vz$F_W00~X&7SW545h6pJp>^+Gp)oAS8otrpi%);p_jkRH5F|sj-{?SM5TMfn-xl
zfJ?Z!Q@C_Cm7a*81(nV%^%il?(C0o0r6mp7ziG+mL(bl|tz&}u3k;8nER|`sM2KO{RY)U7$yUUEMkb-QzdF59)|!jK6@2uu
zsM<>qd)5Ow!W4GsvkxMl*dueB3u`HbBexi&m(Rt$D?C>ju>!D-G$~<(9$7eOlT%U_
zxi75gIQ{=!Xp5Sn2U*@C?UN#ls-0wX4A@T~;UbO_OpEyO0APTi2z~Yj@aQ^$_BK@?
z{C5fLQ0p*iUsWc6&K(YgyrpFpmCx?=iLTEYakgS=AF}uMsbg9WzAlIa)`#>v9EtP1$
zj4I$r04b})!omZQ#D&8JPs~`Gc2>4kG4!;eQ8&2Rzkd`WC$Z~06%%4tziPj_+DA)!
zy`-dpR+NqulDESeD+oy83{h*m*4-x7!+d6kV=)PfOHJb3;2s@A=PZS!xIxERD4{HrF@w`
zKL02Iui4LS8SVVZ*XlhsPK4_Zr_4UAKMlQZb=68?+c_c>Np{xS0&@SsCmy!cFW?IS
z%%$mrsdK_<@|Nw`N8F6<|FScKmh#%HADkTcBMRdo?-hnTrP2F{fNG?B9mwvIzVW)h
z1Pz$N%A9XO=$v2fA5>j9gaZ#fmZc5
z3)cg1$|6aLJ-BYV*aST;q}&=jlQh%j8P!uQQVhvAf7G0U&@(X5ERH5RLV$vHYjAx^
zir+E$81(;n2P1dB-VyXYR0-L|eHT&4AZn3GNx^qqtowNQa;jq8hOWW`?Wpd^!wm$n
z-xBbYJ~n6AlfZt$`r3WIG69VHhWmeBiI7;Rw0`bu)U%b~opEWPV41{D{0b`*6!ULK1puw*HeH
z9q8OfybL$pL-Owb2|OuNDxJ|{-w4{KN&9#6|Un!RXnbQ=wYQj*mO1@A<(LcoQm0W!lnbI+qW;dhBg
z#Ezv@UNPWh-j7~Vlyg3pS07cM)cEUdK^^@xE;}v`V@$M64&!vpai|G4IxcRsD(Bm1
zG3J;o#+b&G_3`xNg(-n5olk0>%2nU0x6eKDe@VO)-S#u2>@(|A$KNZGESdMtF?>nw2lL}g
z5$IaOpLkmEf5G>y557iY{E~jzYo^WHx5%&zbryA`kk!WhlB?49T4!CGP(m1x&E4><
z%F|!Ys3qtIqtjT<-JUcvraJeTHewzg#RD=jdn$H}CZb$n@0CjjAtgm2b;J)Vq7*Mb
zVP5?q*jb|_7iPCqfYY^FUub;~A@Pn4J!qMRdbjpl6xat3ZrPMv&n#
znp%X^EkA*i4>HR3o$u`W5E~sGPh_XFWj}S+-gQ7jJ^Bz=f6d?e>urwLivFs%m^8WH
zAf{(KpHGXrS>m9A{0Ze&(*sYs!K|yd5U3u9Zi-K7+`YYptS~
zLowUi!=`(CjoY7%l$yXuLogKbsc>!2lwiY99C
zvGZ}S2bCO#5lIowLKc95dI#FV%I^%y5u@Lx$Len4hj?(cI=#O9N{G*cxoigJv2All
zbn6k|^Fyt%0lGs`3Fc}cb>n1~dqOohOjGk19UgDSs4pYskp}{cpwJ-ArjHi3=G&a=a
z@1rv?{X5f@!?+UNgiOToEAJWiTiZ{Oj08mrMiqB4QFV2#S!TxQqu58o9}G>uuyC=)
zbgjd9<12JBrfBk3T0H1jt+)iC@1moDP%o2yAERXR*JCK}ot
z586-D-J_BTH1OMuBh{AnczNOljlf
zoy=Ar$)`RhmEH~;8>>eb40=!0o}I)c%VkjVP!}*;a4BV$?IU9&)n_W7U0E#!2Z5W~
z+IiAwI0OUq0&r~Gz^PKue{UlM%}k4oeDil^zP|g7FFN?c(>0F%mp;FGWfn(g5#iy#
zvj|iewtu%#%wxU>o-cJHl=haJ!~1NBF^kUIt!};@RWTBeu?Uu<-3ge?T-ugod8uxR
z)&NhvgQ06`vPtalu)e<0hY)*ldu7a_K;xzG#`cFw)T{lOQVK(-f{&yvNWINLHTr^4
zv$=v#l9qP-@TkFi%}Ex{07b+d{W&aFmpMB!fsR&yXWcs{HnH
zDkcjpaqWX|qyC-PnWNH@(b5OubPOKk0>TrGK98D0JMiP7f@q)DA1Zo;$&w@Oap*xU
z^{iB1L@rDG>D@1PHNp}Sm|nkDtP;`9KLW`O#r)T@
zOftMwQBRn3{CsGL61EDwu1?%tpR?XyNaectkpfq)U8}ZiHKLr%!;_$9PKc3{gF6jf
z3j&n}Lxm}G!LOp;ZgKKK2Q-!5e8JKq_%MRG+0dNB!QMV_YaZe1YJafn9H7bh{_oFB
zUf4P9O2iN5;uGUrb{ny{MH(TC&Y9D@&z(F>A8ZYG!J?d|r*F853orF%yA*?!$14H$
zQ_tVFqvG0Y?;l9tyg6qCGu@G4G&d(+ewd!M@azwpKR4~9Ly**dc=ks6c6E{s2_sdt
z$m(~JiE4+YN?TQsFi44t(owD}9a0QtK{&c$;j%f~`KI(?^HfTMyCl;yHg%2k>|w8f
zS>lkG3jJpLP5VsewV_Uhq0+@aW5a7-q%@@h)2v-xPkY(u7;_b3i(v4vyydsI&V+Pl
zA3mh#1Q^;L_J1mR5Q?dd1y8Kp!BYO|!lxH3RIp$&$*N%qOR6X#uZ1=7)nE3aw>amr
zwW*s6KU;{o7cV!&mLnZ~FW$5{qxbj;{GP0ld-?k9cM0V>Y!o`|6h6#Vdx)SexRd)+
zN(J~+4T&!A~X!yV;&3TF&ojr4|+XRt=HQW2Io9{rbc?3%cIJU+9uj;!UjL
z67M(h6-9~piYX{K6OZ9TxaEGbnpkj*jeTnLcGj)98v)nK-roLYsxggfKCbb-=Fb{7
zw$~>b_XB^OufDUs67%OFCSUhRph~uObxJeB!pmVDw*M+
z-lK#WY;F2AvaSrrJe8KL-shUQ2=~UohaPnjk>InG@85rlOMAgdg^>_ptaNQk%+HFr
z6EMGIh)p;IwHOy>NAb|=jjRqBV*SePtBu{!OKFQr=bb4NrWYXy_14k(^~c0EJfzsP
zp06+cn?;k~*N;irAa7tdsog0xNqt}dhW)6`r7__cHxjul)NCEcGgjwWm((~Iv%_Rn
zd97N4GFiL6dBlvXYi{n&b08mP%N_{sXm^It&D9
zv`u8C9Mz5qKgV>tHnm2X-L9yw`}wnW_odAB$n(a=sT(~{y2d`_YEh;RT7F6iQO4bLm<(G!?K+|1&Z}0%hwwKSV6bRYQ55IKLisg(2n-msSfTQT$z0K6Z
zc}*#Gnfdba50M0pOgNQ(@X++2=RbvDuZwp%^2+mp+u3&sNPOpeV)j4hiB|&?C5PVEZ?Afe{V~nazE89NKJh2FuO(LS)XGQ)9(()m
zuO8%uE@H&?+h88dIWld^gqdYm*WUtS
zY1NK7{52%VT8UZb6|4y4J0t#`1G}Qs+Nou(W>=eon1>HapDVD$Mg)+d5l6|}3DiM)
z694%T$*X5nFfBF-2Z0!V13uC?3=C*vltY%h=!~Ns(P4Wl(bmULq;J1~S7CEw(PPg^
zr_oz|tYH!FaxIho?y~+v3Ho9Tysp{!(&ks9p6n+u_i#KV{0LXS6dFs%#8oEmYK@Im
zrNi`#^a2hx*joznRP&p`O~Jw8@y=*!>fHY3QZzHLTO)!$B`a0b7)Rb;evgv1yX6rs
zb<_P9BvdRai5vUtfh*rtc(0`;TBuGmj7s}icN0DghSq3NNYO3>T>H@i
zH!!X|=Sxm7g?%>V;NAbM3@!3KQKDo}&6WPvDci`sfvb)|r93s&G(-MpwJwV;(Ti1Z
z!RctaW^RI#$UvMLodDI0Q@?U+a|wsz9toW(6AOIp6%2>Ks4raGJS{(2r`Wk#^2l$qhu#~|p%Fw8RrR=Yiro4y+Q~{`
zAu`%&^b3(+ZQAywy!rB4^v9nah|d-m2XDWC
z+smwE_3PCL>3!FF!Blt8Voh%)jN%ifPq&zzN`%9T|1mF&4G`1DX!;B
zs|C-jPfoxTb{d17#`UN7Cf}b4PvsWP{wy(WKd9di|HCkX;V@%zdYMyY*WM=7WpUDtKsWX|KW7Ei#>}Y@e_@@VH0p>di
zYna_`*Uqz~hOhQ=`CGOup7OiqYQJ4hB@Z}RGwl*VhYR!`k@10qN)~%aPawD+e?
zw1DrgpG#f*G*jkRdAS5YQTY*QZU#VU7y0Syf!FY1x
zhhtf-!|?ov5SEl)258_K(CGJ*deW8WQ*W&idcGQwpP;-buC??ke)MY2~}nc1U|
zP1zK(XIW)rWoEC4tg<3|leKXlqkGjPo`EH8*eMS_YJ^knl>PHLWagz1vzdX>%GPJ4
zOwTAa_Ltja{h&V{_uL6b7@jKqXKTgee*u?F)
zBPnIpI(gw(JV<AhXa^U&2w4*sy
zv)+d(KByOI9}#$Z>zNUV7Z=&R5r&VP2?rUf#*l(77B#)|<9tql1|th#$|`1Cy_Fnh(Ak
zo$mwt^-J3?M&4MeDs$5|n;VW8IJE8)VzDsBz~$)4jb({?^#Z+Z*+w5l;&6xgZtAAn
zlL3$l;RyR9HqO{j4ya_P+{5d>SIy))=YTYxG%``66j!F`|JAR_r;`V9k$`|5M7I|h
z>##dBoa3^glQGL1DKu>A&(&1a4Tx=n#MFhO>0Q(^6Lnq=`>FNVBZxhXW{+Md84-z0
z$^=qj%4HnpoDqJ_)ur$x>Yly*1=#Y9MJO;oTB*3Uc0qL4;06KgAm?>@<5p`9YrZar
zR6kT_GACl2nf`Ji1LnD918X8I{9)?rdy5sT@yl0!YLvIO`WqWJE2WA^;?K|WtVz5q
zeQdq_r4Eo9n1Gfpn^{4YQdt{f6#0b)Z%~s$ik^uj{YlM!uylx&RG4154Z%1?KfZcr
zP1DUw5Llswjd1Ht-s{wdlJICdr>LvQ&y8)pY5qlN)E?ez29*X$K9`lTS7;bjgj7GK
zW@lkQPcJqh0paCQR)L{hFE5x1GxnD7DTn?s?7O|Qe-)uuml9szbN7V%L3OsmTFbD_
z_ix47&z6^yhaD$2H(k!sp)=*)|BxjpXqj-mATi?fEC_>
z_@)wZ)GuPiHS^!lJpa=bx`MyDgQT_a8~E^h-!GUS%l8$c`e={W?fKBkbh(&0T;PF!
zMz1LuK3Bki2>ItKHllyJ1?`L8R-uT
zM(KWD_!Bp)|9)gM@r^;KL15GU
z6E~r07)!z!oupXS)!sRW!#4Qpzo6lL6Uq-&|UEMJ^PjP)>0hasDsoLoB1*F
z0&jQ?L#6HbR7b36a7bdIQ42oR+)Uou)+0=M#kdK-COD}86-}aP?HfHdiT
zMd78%mFnro+g5#jnX1l-Ak9=()|Apf$OJts+DOe-xRhiR#Za$#M$c&{a<<3d-sn>hHaB2&
z2|C-Tx*s+Zio}IC!QLkPOA9HSNCo+Xk8}k(q`1hlcze5>XPJ-IJ~G2LHl^-&0@tj+
z35}G?G+ZDfBd4T{j35^E*eBvnie)`g^jjn{$-kd?fO2XrLbb(o`hMT7yk_vh(yple
z#Dx4iTC=e{+^l-!IHW4mp#qnM{mu0V0O3*X13jupmI+VtPsaSLzw%v(&p>PkkiP0_
zDr%9N`x6b54SsHrskT;D4z~t{wtRYKJE$uwhU88%8lZL}CPyxanuhMYWUdt$0R(FM
zeb4ur4Y!rBNT=>!M1eSId5@P8;6z!BReL^sm`6u-H^9M_xf=QAvKT8(n$pTxGOA^i
z-RjqDU$?AuVt!`w?uqhE#|SKSR(gKl*E~6cxdpK-*y73kiI0M*z$o_v-#W81W@dq`h(~J9Ya*)r~@SRw-Imv-$14qosq5
z?k{_aefhd0tE*|CRJ@NBpK@70SECe?ZHNz6`fF+4lJfnGZ|IC~t+~I@)Jmommp<|n
zaxQKzX&Hs2M2vW-NRA7-(Y~*5J)d>TY^~5eIQFKsP)VTRP!yu2*L2Zzy6)fZMiHbY
z$x;=r>OIEi;dSe6;21wOet^vRyf*I(RF_5+Q$-kVJbBNME-rFZ&rA~*rTU?;Q0!+a
zAI|sc%9YYVJ&(iP-KeWq$6Y^uZfWTn8@s__MCF%1dMmj3V;_S;_yj#j95Jo=vbFvq+k~W;&*W7U)i$)#jsMXaN*X>28DZWm&h3hdC4A=bewHuh4VkjtVDkMKGp}9Fe
zl7Q>s*EhH#HvxafXa4CeW6uJF)(gLAy)r9{Ggx+S9xn}2+zVQ>FBA9Efn$3{#J&jl
zgl266(#V4QLPA`H1um1aDkY}NH*t@FmUuHj1S=C4Uzs0lf37`rNF?_qJCjj#6V2-5
z^8zFGji1?aab-nzWOP}x?DZx&-xkuvAIJ|^@@9E?nNf|^denc)xtT3q#I_fUGimd)
zH{GutRVBO@zkPnc9lA#=>qOAaz2lVJPsD1e(;`AlV}|(IZv%TsLR_(VbicVODUP@6
z@runzN%ke_`R^YtvJjkX6(GpH50Bh7`dWx0<8SjeT|qdJvBUL#dxqx%GO3z#%xom%
zWl4~iB`ELu#U#1eB|2=k#revY%nMHbb7cjTG;#?g!8lCVfEq>y~-)@%9E
zY})AhRI2$p{X^we3e1y};?NqJ&{n7mAc9TW>m+e1uUV)J&Y-H=-ZYaRz-^!zbagF>
z?wh0O(z5&8aU)4ij2a9+rlg$Ai&6?Xml4yiQvG>pcI}bOZ1Zqy!Mv?XRs8-(k%)*e
z_dQb+_Wp~vcyujHD>8h#UZaXTQZdt8epi~tgFC}RZ%}Q;hD%No`K${hVVxXqyiZQP
zmW7RrbYH1aW}Aa_0hNMk&qVq7G8AaIcYU;jQ&TD3w26sl_?S}A5$mMRNmzT0g50%-
zR{c2z+=Pt0OjFa(2d~-coeYq}q!2S%+$FTyYB+9OFiRPsC-kbDz?SnLwyuzKu=w_%r9;30|m
z-NO*fh~W!$+9m#m_@w{*{#9sDfm=R@yZ)`ljkZV4zAb9JE>+mjmvFzthbYoj{`aZL
zr^|%w&$k%-X8Ol3#hjyZo22f*8M&x0ra$;DrJ@)Tf^6|0GwuCLBiEz8(1^HgzsF!V
zcxd<=^8ZvhHIT0WVHN)(J)Q4-XZw-nKD7JLQ#KsVmvr-&B(4hPgr>7l7%eppY8(D6?Z7D`S)h8&PPAHsG!bqTv)
zC)*?3E=CU|OuML9j$6=`KpoAgr%+aA<1Maw4Lz#1E<`IlishpJPOPkHOuC@4w_2a%0mO
z@z5Lb(ofjy2vWhZaX>yrY2q}DfsDXj7rasSfG}{E;6mU)ns`2xYK86XP>GaUkB~Ic
zOxTT9lsDW2G87i|5QyEnx%H!0*?FgH^(@x*BZr4OD_*uQ{GO7Jb0I`rfPlp5zCQLQ
zbm|P3zE|>xoVyvwrs0KYR=I#1(9ibD$4O2aRg%U78q$&9hKkXLP>da4iqH5Rr_a2D
z0^NDp%FhkMx=Z1>&`m-)#ut_AHZ&C!hfcGaP8`<&KJ_xUq3?6@sp&6{d+QcB;-Y{W
z-hv}`{Pbx%z05YOki8T6&5LW@SM7wu=>8priU%@$x@ds{9>QM#LN$*Nqr=Kg7d!Ly)(9s;(x@oMS0s)pfY*a!
zvwlXM#apbgsHnB%Dv+~R9~-NyJO%a*)K-%YtCQF2%R9IuN-7MXFYhkN>AASm#gNhABjHdGO)-Z?CqpBlU$OoBnSf~d$-Z3;Z
zhuKy4WosSH@I&f%I=W7E2$>0T4h|67N&#O3@cY%PV+VgP4i>TFRxQd##l`~V_j{C7NfPtV)mEsud(&AF&D|G0
z=^Z>b%sxe3x4T~<9H-y^#G1RuK<%q}?QNHo=oub4>yUV?wVLS&`W%Ao-=4gG*plG7Jc9RDe*d8<~9#%Pdb|{@9v34OghltOLthzTzHY2PV`XMmW2Qt^
zu(bRgj~HQ`%Y<&ms#%5<1-0{*&MIk-$?Ak2SkzXxA7iBk##jOE4eQDIjh<$MeyE;&
zDv&luvEi{=uIfBuFZ`jAj-H&}b=7_iY6MahcZvpkR1JFjHjO)eShdc-ODN_pROJZD
znCL&BmMyOthY^(*(UC_HtKiK
zZwkE3>qAAn^WhcluG}a@aVFItu~SkH|QIDB)%a
zz8B{@h+aAz?y^kCFMTWE-Bpf@xkja}e;oV}04iQpv2m|dETmy6rlYTl-8my-vu;Ko
zhAT${mdXJM*Bq%oG>m5{Msd~-vFH>_Q4w8o3;YHR0t)^250u&fapFMCvyG!tQVZ8B
zl?v**9(?8s%tFqsC?d9Lq?`}{%6Y!H`JM2BQkmxjEyMQfBZ;yMj(;7nXDY_~Dq<5q
zK3|YfHREZprTiIW7d03L#4TJ7)CtJlwXpkdik~1I3gX{;U(GU(*?
z+L!kBVaSKqAkR8;D@&&|r|3gtoJwPp9~m2Y$1OWcdt~Q^n~V(rBB;!Xl33Tq9Olu%IHiky#SOp=ngT>$e01f=H2cj}H$^iCcQDxh
zDUj3;`LuWr^V=5N-ZUwD!ARQEg3@9YnEwYZA6+uj#6@l>#!unJxb5@JkJU)r6r4K(
zFcuQa1IcK!T&*F->+F^S#Sf2-uF=u?&f1c`F1u!_frq~+WExtY;WmHw&)b`QbOu!s
zG3gYOP6yH&^Q!!I4MQ!BjhRPpMdn;fbB|Y~o4x%fK9k)Aandqh-FV*Do~Bp=
zmT#MXbL2Axp~veT4Iq!3z_tLsl2y}xAXhUTq*YU|!yC<)z6}FqmnvXSRQqxHyY*zi
zofHMWP&rI~Czy=Lju)W7r*~|MZs$aZIMaK6
zgQ$Pn@3biSJ(_lxW>88<;+M$&x!X(&S_T2ct*c7!K(rd4gtayd1;6QuH=mo^FC~#Z
zAgIWC+QyV6CtlFnUSUuWao@#YKxv@Rx!;37QHHxWHW77CQO7h*11d6{y}fybG{#)^
zE_6{Io~af(;CFcI6x4r}()B}p3Y%mtGRLqDX6gIHdX9(B@OOb_;Mx7J`U<9bxQdUF
z%$E5=Wtt;Q`z*Am+gL%QZ=A2~m@q-q3!hiJc}%)>(702|9#0M{4~?|q2?Iu7=VlgH
zxOt)X`afKMzVqtT@s)t-KGAW+iL-Ov{TCErCBXQxIo#<&3cfpp>YaN4gZRq#+iW1j
zZnRsO`MUfm`W}Y&ZiB=OkbO|$5Q{j@^}K&Cb?u>AJ_ON2*+Qz-2je;F^fXsI8{>z?
z7+Xytk1f71?1Qcf_F|~Lx>X4sEkFz}XQ|1^h6)X>HLmoJHV2EdYIMF)YtPZhe@MPK
z!`F5j)j4L$*BCwcqP2fD!-sV3Lm*xKqd0cjvvtD)cmO6hiKs3M
z7Nd&>R3rhNQkbX4sk&9wYxsvj8-ON18s;*VKr6ttX(6Ww{br@6g%c9PQNU9Rm8bg
zmBUY~-}I_p`ijF`NsnMUfKI(s~bW5WnJFr
zMpvCGr0~;pQ(p=Ie^;`#9VY-{hPVxNmzu_f0)6X@bZ%a{s$UcIGnGI7rCGzR3Kav<
zcQu-vZudSg40TPG`3fMAWmk=dHp8bDfz{qsS;c&n4BHCLX{dXL2x|%Wl_wkBF)ne@
z(_h}WAS!wtDp_F1?XI%QN9f8%8V`8G-o`GD9+whePvm*OBsL1XZb1L^XzlI_sl?#C
zmE;!>k6)iwx9HGcq6LM0TDX8+lDwsMSQ+c|~0O;bIesZJCl=a}s_J`Qwj?QQ};0nZBcT6+kl-DDlbprufY3
zQ(hQ;5tWzvYf%K
z6>lucmc%%8m_fxeGybQdAyuydnhE94VgAlXYm=j9eplZm6}gsc{;CwFb+Mvq+lH`+C$MQ62-#jb
z2{HEPX(LivLax%n2H7i-%Z8V55TVWT%9#z`-VjU<=#}Con$UsHHnUeleFq{u?k|00
za#h$)`{s6lE<8PRNf1#ilRh@qMXmrVN&>5G7J0yVk2d{i#U@vWBa(*k;J!XE7X?i~
z%4cPNoQ_rc^ZFU4p&D0tl%{$O`^wRg!Hdg;3C|U7`Smovf3|3Wb(7Kd=|ydK>uBx>
z5XUO&O-_+`?v`1*DQ&%s?@8n4k8f;5zsPZjw|j|72fYYhbtFKFZnyjuR|3sA?+w8g
zspK@80)S+U9E?zRpc^n17>G$zm*jCkCIp?I61{d?XS@WrsPaoX{R^yb^H2E3tj;sn
z{T(75{)nBwVwzX2tc=+OZ#}-(LnwbED#3x@WA)pbO$hdencuzV)YPI*=7OG`J>Q_4
zhI!U!Bve3lQ6EqrEgkmo_KADLd3wA<8V86A~Y`kS7#B>buCv_$yuf;zc2bO6Qdqhqp{WBTY@zF9$F^dsbLN
zOx(bx4&cnU_ZF{p-X&ovTkBzS^mnM$aI}<0g`$u<`?N1+1oA5B4WP&p_Btj%yb}u=
z3;@{Hn!3lAm~W8Q-W^byp1z8_ASfuf4`a+by{4tHs>Tv+2iP>AkeXFd3iS
zXx*f&dc1h_k+A1U0LNwOa_jAb;mYTy+Z5^^=j{Yf(vHw;%>a%Hj0y~B4!g8|{c3~k
zsy89=5Zp+5ixBWBG*Ctdj%_K7SFa`n{0g17EF0Gvm=uszEx2lB{3Mm1THtGv0;Uoymu9S~Dc
zr+2R0GUZ&|0f(agE11@ciM8EQh|Sxqn=feKr|l;#)gVS@O9rv+|d_^z&_LnLDy^q09uo
zS|XRbX*T6G_`DLX+oj>XBMI1@;a0~`Pei}wC09;R3B%?7bpg?N44a!W(ESplRE79Y
zdd+&;&LBR8U8dl#Nf&TCKGeW>ikq2m1Wn-SMI@RBRu8mFAl1Zbb#$`&c+7**LE8vb
zE83o~UrmazY7AZZ3x@VQH0HcE@>&IzhKxVir-8KSYJ=&!++PQN{$2v6%PDVubPBjP
ziZXGx9Sd_NMazs8(N{?XkZEYlf;iOr!54B>iL{B%B^vbwfcS;2==_gk=
zp?Nt-;fhW%MA~bW32HP*wa<#BMmW#I5I%Jv&F6Y6#TaM#X@}ByKxnUSx0)t2E>6g(
zE5Ong2rV}l?rfA3P((Tzcgg7M7flXnB?aL)hT4+84zLDt5e$MUN|DO?-dijTr22{w$5UdJx01g^R&Ex>OOst*ljI
zx(yiMTKP*t>SOPtBSVzH$p~p|IYRXv_d&o)E41Bx~C2&FrrZ+m9grbWr#+gPfxIYGA^0%8@`KacW=Z~Qx(kh0krGpivW@F3%
z97!3=-l@+peU3Nu5ZIVS9U?TTwCVKhk~pKZ+AOip+;S}b2QN-(L&$o@PZhHO76C+V
zkBB$mFGMb1)5Sij5UZJ;fuaygk_Gp#P|Ae1_pSQZLXFYW?gg6EW*Ya#=R}yek&?u5
z+A#qCv0zmlCip$sUgYyEY`EHn-P{-xQ8@1jt5YJ5$66SKg^$~#q5^xsowXg#bOt}b
z>R>{zX3-MZ8!aBjSGBiL0w9zUi|x*@fv|@Ic`-3%fi=&72Z>?Z$4@!c
z$;n&43N+EVi<9})L;UMN3cgrFzdCdKNeq$>yPkz-M#x;~#@w;0UqT55z8Fd2&iF}+
zH+Tsd^amP`*)&lq-CRLlF0HRSv`6TXd~6%9#F;r06%1&>UIfBWBIj1RB3=?{=r#4srvZJOKuTq&0xEJ$S?!w08VXZ*%w(q!A)ToyWQDXeQAY$vHtzSgn(z5WKABjrxfsi!je2;z%Sf}dX*I8
zer>0CzBVt4-Z8x_wmSSfMmHdK-6@Lbi<1|$N+C(0?<{+y#=;o1K~Q6YQeh2|
zekvX-OAEJ_dbITIG8ZWm!7UnIt>~CCa}f6YT*(g9Et7m*0Zxd$FG>enq@VQ;O=E7s
zv~UD$XTQh_^O?Q?6z1dOftK0c-Yd|;W7aCAnU9N^HSk7x3p953kZ~`DKRy_2+-?(u
zs2=hb`9_CY!_l;_wcf*JXZic;Dy+o4DEg7oPqHuaR1fqg+W@;g%YK?iIrQh!vJ~C0
z+rNJof(2|>*w_j|WZ9piUgda|735lt4<1OsTJDE~o*rFEqr%TX{3jU44Je0hrhE%Z
zRP3o0$bD{$w90zK4F@~L#EjGVv5l>X`f&jD_B-9{*gmr825wvZ4zkavUa+IX*5W0w
zEgsG)^}qH>!%4b1d@<8+e{nGnEqHa@DIN&Ab#O_QJ`j@>L*o=Qr(2F;u8
z*Ejs~L7`MZYJjMq6l?32hNiN_s@Lw8isa4Z(exj@u%Ae@tqoGzO`Q%Cr?Zed6&d^|
z#tbzY?-5m`L1g*Y2laI~=S7os?PpYtxFc9m5`UPjtY=B&RV@^cQ%;P--lXc&r
zVpXA^uO#~jJ&k46%raB@P-5m777dmUUf_{<+?Pr<4|beQpQA;<_;8Ip
zfo5Camup{p9SdGC>xg0hoN@rm+3G=;ikpA;RZ>mO*7lNe-o57eYg9sy&kU`AIO&X}
zvOFjSU>wnhN0z#;C4=Z?G};PKPCK}iH<|8liMWSTy;*5>S^ic;Kgf?&?rTodwZYO+
zXvfK&xC>blK{@BMLQsxf`vFL03T<5dpHEk8Ae*-gFD}kny|U`P&)6=D0_OMsTw9tT
z$xpg)!qowy$2MVZ9NZZd?5Pi1qk04>9dMIKapa6Wep_4^YgoGskg~%P6F}Rf8AW!f
zh(bCp6>hz!2GDewvOrUdQXHPQwULQt^5sV5a9Pr+^$S~
z{B+uqy?T6=b7J%8Tqo|-<`Ih*k@qt!#KJHLQS|i(Ap#DUJpl3@OazaXtuP1)h+qBY
z`~_gG4CCg~h&9|v!si?qSWei{YXU~=M+X;RY}G%XL)9Rer|aTL>t{DX4#~fG#QX0
zXM{4)n6DTH@HNHCv0VP&UZ6!Y@!g@N;B?3Z@Jx)2re~s|W=Q*b
zc{mW}H{AGxtaE6`ITJ@NJRGkb1{>nEee+DJ@N1e&AT<~kI?vx300S`A`YDZm
zGAhhqJ1$}XZHc;~Y+T+M-n&$7WT~YO)gSa@paGw&{&F2i_`p_G5Cc?!Yf-i;JGQfe
zc$`yr+$1ts@!xmC{PCw#HQvJ}f9GLJftWWCP`{1nmV}jrD3X0Qn&X7{z}KVwKG^H~
z#Ei$9$OvO*lH#Fmu3ey*YZ5q0p5dK*lN@Pyb%hA;>sLUOxCo7*3`vh-K|FC4ELH<0
z9q58SPY1RWS1P5xV=H#q{x=Id`6XKrYyBJ{p^=-L*!`**5z2dIR!~!7%*2-1jvK)T
zTC`yJ%XUVRnUTqE6!RedFW=do9rCMle1_45Q;pdlKr`VjZYMve7w{2VgU%X7bIoyA
zm@wN8J2=bR&Cczy|JDjhvHbP3#>UA@DwE@0%~YP^=0;U>xpu+HW)bFB3ST3&p-M~g$a>VU18fMuH`me(Yh
zQ>*LC2Iq0osW+|oHOaIE6iV>+IdKpUO|ql4#D@^g0hj&}$Iln+(JS5{xX&y2KN#^S9s$2VPMmCh$pCDKrX6670Ky$eo_=iK$)EW?j1p@N7?X9xle0G{A487jS!8smFrs9yUZllGukb9of5*8
zsOauqHrtrP;je4hd;`E%-1EyKhiF-roi1!=79k>$zpQd9iooxqc}~w5D?`?8wEooo
zd;t07Ujz9zG}O(;N(-L*7G8VnCc|GVEeH8QW?^M|P9RTpK8)IPD1G;DmB5jzudfCB*YVK`
zA~L)d;x4)y01+*Gzu*g_4E|zf-dL_w+?6+rUC1PCP!|7NlfOGAm}L`me3VR#@XHPf
zxy0+@c;dOeI(ZqQ8^$z<2QUWZs;DnXlJm^4)9Bk3UOW)JqlbHoNZ&@vzs4`8knX`Q
zk6a6V$!qZ@{&;*!1@uP-BHl!9Zk7sI4A+`u9S)>{4p+<7_z5ZvDdyMFjQ&i)K)M_2
z>yFI9Wdwh)J%;SfW8g@8=zD%OHKJd+_T?^qe9y|=rkNRY57Hm-E`B)^39KgCsz|{{
z-S@Q_8{L7PbSiI%u{vdnxpyYIx}jya;x)+4jClMF&-%3kGi=}XL3
zt?8~eK6L>2B_AG+_V^J0BY?dm+V9QkWW_L9p9Q*OD`Uf{f8_sS*q5*6)cteyVnHu|
zkv07rPVlEUdIhzwdyV1}4C)&V%+}q+-2UMVi5#>kr)n8pOdc!DjJd8(+$BbHROIh&
z>dZ21g2}PeT&@zNdaXCv8-^$;DH}Pe!BQquT2Bfsg&C>8doOddjbaRBVZI{mn4?7%`2d{$G#O@LS6orVmkNOUCYupde)_p{|
zcg}PL@ke7WV^`o
zxn8lg;}+?Ht-!y)oYYydTB=tWsT-w{kEE@v7Lg6-|45?TDc!c}TEl!nMa4PLGx=dBIWCW8K~$u6=emSig+_7XtFS&_+)KXaQhKE`?wSvj3M
zqc}S}W1bamS&L{7_lLVJsnM@B$)x8>mb));`v}He_fC){w&v
zCKn7qY`oFgDuo_6WVralef*E1&k9PSjdQ)U4?z#t+nYWNW>wJquzXWM=Rt|mHe$%w
z$C|Z01~C(io)ejMUk(pS%_t+%%n-L@e3ClExUT*wSoL)~tE*qgnthCJRE}DEuVcPJ8PzKMeXrEmi^eIs4i&jA9y;Nt|7efj$>zcXD1i1Ui@D
z`^Js4bm&z^VDofz7~lglH@Mh{3EoIlR+H!<)Ci|d#l%u!G=braO2$6;a`sB^RlRKF
z(X3%gsg(80i6;JIiy2IDZ(Nw4FM~Q`o9JDO4rTUcB%zDhpk1UJVR1*mF~&Llj$_drE<1
z3kQtL4UeT<@2BG84chQxL;XJ`s23M1wEy;m*(s8
zdS)P@W7A4-<@zE)OqZN9mu4=(cONsHehdSPmU#9v{U$*EmEEI(UlPjZ{p4Cdk2kT(V5f^tI3TG?}
zsoQtflSl(_-R^{9q4bq)v@~gi@@56MEPje)=!-@A|MLpG$;h)%cG5`TioFBjC9GeU
z0{&oWF>htOJI2Xa0Bq;y&PBCYQG5@Y1V?Rh@`#_cC-g*q{MWskr>0BHl!TI`x&T>7
zbzgsl1|vP{FhMy|Kfz3Pwi~o-y6;^s#5L1}n8wd&PtIeIK4AOjwilF;i-PnA^*RQe
z%(>Itq@}CT{B(7ez_jSaX2&9mpL6hL(Mp3XNqn=?TlQ@NX{
zL1s7HgLH2Kf|-S)GbyQIH!66D?LzB#jTb=-5ZKvIKaI8R%^a=687-8NWCZ
zm)jbPSJ@c~r3LPVbg@M-D(aD{{HNNhPmS*lSH{`r;9`VfDh*b)foAb)7Vs$l{4u#`
zEYj^Hazu(?32gCtF3S_us8dDw^WuvP!+1i3yz8*>6OPCg5nJNmKpdNqvY*2xa*KsO
zI(aPmX4Gl_uycPku8LBAxDxV!Fgka{v_X-22r@^x&txwfzeRzx*8gS27UQ!c7AYN%
zm?YFwbO-fLjMc16zsRS2Nom^C`af}>9YQ2HDX0WJx}Hvdb#&q+J>WC>UL^>v8227w
z3cs4uj^WxkIfF{k+c<2y1w{tD$Wyu3rqy4FO3Tfj`&BQEV6X*hw2hbFHzH_J)Xw~0
zO`|p+VtHsScBvVBN|de
z%^x6hmaDpw4yDxxFVPR=X;)Yt@|9@evAzGTD!cg&W-)&5?)J47!xSU_-O58?rm@qEMZU!gOcabld252r?Ybd_WvlzL{Jl?lAT9i1l80$0&jM6d#A#W
zk@69^GSFj+2?WxEnu^!_k1T&xaY)P`RQD0aAL74PL@57JwrO6SgE=Ouu^jv#9=Ck^
z#t%(RT^Qnsnb*>QcGN{ja%Zb6J06
z7PF;`=#)P_`4OZP;8LNORS>u%EMvBy!Jw&yay-;l`u>;t>=X+iba>%3A_2T0QVTui
zjAvnqSOl1TlZ6w{f=dU$ZVZfr;LI~R4+lCuVlcg+hp62(Vl`mowr3;|=LEF}W*IF(
zAc5r5dO#RG_GbCHCD{_h@d^>upF$2mzy?j|3n!%|*eiV%FZ8tDnyUBVV2TxPzThYk
z1oqdiHx4l0t5phSMM!f+PPXl@J3o3PcIiwmh)R@mp&UCye#hg)1E~|Od3okBfIz%f
zT2b95pY3Wb)4*;tmu0jJ!S%=RU-u7%dw}Eb&e+A35^I%D!_9T2xB)mXKc2(GJA08^
z^aU0lj`Ty2kuhQZk&#j94CE*Bf)Y@RXtk-MBVx}-0#rW7)6Z2wuu}76nEtR|v*T!Y
zT8}%NoQ~{s+7))|2w2U|Nq|znYv#4W5S+4qtJFB>{LiE0_;g-iZrc{HfsqtY#qomn
z=j2Z{^A_BDP|gImh6Yi5oK9a44_`WC3RLgys%*!(fkMU=lB^|xJ-Et|6n}&m;0$_M
z4v2l9m{~82Cz6fgSi|_S@z=>WbxsVYzYeXwaLWahKjfs>o{Uw~xKa_Y!!VzBt{eLf
z7%VV(6h$qp&sx_%hlxxuM-7Ic6*-f@ypx7BDPkFX;t>8wETHToZ0Rcv8ir7nf=#fA
zOY)6UtZZ%F>lHBm&Ca<0P~2~&=6dim1<;daz_&ClC|v(En5WIoRk#Ai!N_GyO-Ds-eQ&?;l3)Brkj%
zy9HJ#LlCa}$kBOvhs<@hdk}7buAyxknr2E2cB5X`TIS%SNjb%^(vlKWTQ#G(8-EId
zQIan*%@l&g67UvcERWIV)p!QXd(%aZFvNpuNLGY(>_dqXEwv(`!=zU)<}{^>0x4aLgj
z|1e6~x!l9mxjd1q%6LKtGGb+vU8FY+rIh4iy7tYYzc3Dim^+@hD4uv#AfGB6fGz;V
zsy;Yl1^-Ki?o>Z9(Q`hH2a3=vn?Hhew>??1W-~g{HcoC%95Sb2yfBc@0mu_fOp-H|g84xhV2~ijwfRnM;d-LPQ9Z$C}ct%lj;(kO=k{({$
zEe*_W&U%q(qEho33-M6cBLQQ#S<`M--bV3^kL;blo=X7niHG~h8TCAB@H}DEKV(gr
zqF}fgw>7O>0@`yIvJ$%A3{_7sDX+qq{C+b`T#uV50a}8wfbi{*F(cpZ)R6Ici$c8`
zGv1RGB
z-*-O6(x*yPz(qo(@;#bW7wvuX!&OUSr65Jxf>)EQIXYX{=FkwYaf*wKMZoIweZy6C
z6Al)Hev=VwG=tIaLenB{9Qx;Ncm|Z>@Xx5D4SaP#@;MY0MD&$23h48-aeQ3mF**Ns
z2nC=q9{pp4a<{kQX}=l+JEM&5v{}su_fHJcrJPT^r6qJ!A)2Hi{%2!O!%B`0+s-M?L;|bz>qqWMSugYplH-JW4A^v-G8(o4g)|Fu+
z{l~2OV2$Va3S!NL(Br5G;>31L8L#Tj;&ay45sB*RM6KDy1x1T8@l%bv*$NtZ3cn
z*=%gOZ9Gqq+93*qi1G{}JFS@F&mn3B_~UnPoBghW$rx>|K3&!D(+_cxx59NrAoL?-
z{oq3>z=yh#ZhqIgpVQf^CFt+02LQydM5BAY9jRs-Po1n^FlNE}wNfKSqf3vMLw}Bs
zYxgbrSemHoWr+V=X{lY*(1R9X`u%T@l!O7whLy_tgB`*UBJUj5jn}F58%H}9FzM(5
zE2oB*r{MmvJDf#*)ZOT+g1cc4cO$MkHbPb^B+12+KaU66ks*D7yRjTB-B_7*7Y}%l
z)pmw%)2)wueXAd@=;4H$bT4bYkLL~G(7V}QpD+PVNgE#B($g0iH6QX5&Ro!`CltVb
zM29=r`4bhSJ5&-H`=q{5wv!|IO#3;xegYzVNK`?3o`*}H^{o^PIuDaU-1E?`+djQqeN&Jm!`&?@PNz}TtP?)we>vNdg$3y+w
zb8C*O<4I9-u&yMG$+m)aEZ6gQM>s6>f~JX9Vho*e*78|y1$uPy=ZlEo_`pX)Fyv4;
z4K+m!#-XYAq`4Pyri(X2i8iYF&Ik50!%zCuO;FpfJ&bOQOk
z`1Nfm_b;1S`yYzRk$b=0uzX%uEVNF!4zS4rPy(+WkNqBbUygeEZ&@jdP^L*bd}pVg
z2XB8v$`5reJRy9Y9Cv{;1~mok2k?&jWbpQ35GgAi#=>f)$!!Mo2;2(1J9q@!Pqq~@
zLAW~CbJy!@Hs~;5E>tM$Mf^F*uO}mu$}WA@mqVfsbA}RMO+@H>x~Tb_@ryDoR#)DV
z$1q3zW!=q6s4ET&XBg&TXszpx901&xf6RSvOVR+61$Xca_7;
z8h2Lfeq_!-bKFd1*Bf2%lg?a@gfUVuH4XJ!Jp;})<$CH_rUX76DOgJ@9o9$j)O%+;Z=_d0W(cN1v&NT@bDrT8Pm_lrVD?U?%;tY&@#f`hKZARB}^yuO3|SPf)Q1Z
z7D-M)*1fEX_4|VYUH5Abi4Q9tOEm(nx_apesni=r8Txc#ZJKveAZ7)5&8HZ4gw@>T
z{<%mm8BSEs3Ue=hhM^{kMuZY0VrSkj;UA*sEL9vl$9XostzpQkFj}YC8Pl6g{%&YK
zW~5?n4SXQp?h{HNJxb$IyG-+mzt{RVA&21ygHSLs4|We%hSRlrz<=Kwy4E_0n*2BR
zT_ZC7hQzUzt>t!(8Pw{~^>2b>bZAUD_-VDj5phmC4D*FSX@1hn+|{uwcuc3}B(SNY
z`X+`4l1*0xtv@s_R_N|p+marflWRP#ImL|ZT13imk)fef6qke(k`r$9gA(WMlyrqb
zVdRzD%^#JldZ!eV`kn97ux{hngZfEMZiAuJ`UOeB6JJqCL9FN3k-_keuKQylR%Q>-
ze|x9kF2W)C>pZ;U5?V%mFhNAl@;Iw$$B#Ssnv0ICeKaGt&L!})ID_5ob&+M40W27RuYV^kVJ}b`e!~kbAp;XMk7cy&wphlUp)ea56ne+RdsdsH$KG6Rmd5_=A}v!%Y1ZU{skH72)Ohj
zUJTx4yLC)u)I1zak*Lt6B7{>eX_lu_a)IMVN=l_2((0N%FmM{Vy;5vtj%4
z)sZol$FZb4E2Jf}QKt5}dV3<}?kBpJy;||T45CqE72W%|5VxS<17rDHva`^g?0_+}
zv-^5Wv~I+tt|Xtej_rb)DEBM(06i%<3fvts4`2$(b7Vht*ts-Pi@Tk{<~>wTE~uvP
z#}8Tdmz8}!I&w?5T)k3&>nP)&&s{{RVmN@~3S`xJp^-Pr)}scv>GFAO+-86&WW2uc
zpD)pD{gN}>J+chY%lK8qiRvd#eYy}CEDl0x*Kfw?&((qTI6ksk)dOi_ad8aKtqY$o
z&02)X@mapNGsG$3K1e;WIy)C69j&Ep)Wvv$B`07>ZhMJpwz3
z>r&p6*D=4NqkT&br4zPZn}#&}Ul5F3H#wRI3!j^o4sc
zeUDvh>+$05ulw{Z3=`mK1byVX3^n@;{bv!{q-p3CbnaVVr&?XXxp;-*Ub%JTit=R#
zpwkNtFTW9k1Yh;Y(hXeO{pPJ~!h?g}zbidxgsrWR0si}K;jGBTpp``TuquMd(1&z|g_s$2Z
z=iYMLD&`ckNy3_~B-J{@V#mC(A=Rw_Q&|z07P@4bZbnF?kY3P_1B&q;v46+h=U*ik
z!Pk~Bvcpt&!|odjGsL{hQTSp+jcLZYVH5BLpf-!GYwH()t%Mbz@n$WdU|d=o!5d7;nJ-
zLCq`4@LxZRLdnlx^GLp`&TfX)zGbWS$DKtq;X!aoMB4B_AD#yV1ju|QmzFv;ufWQN71^#mn=KxGBiMF8ZJeHy0F#+4Da{C$PWP2>-s`-pueyp4o!A?V
z{PUJxm7D6FZHHUe-VWg`@?)e<=gQp)AJFsxlznLR#X?5I
zP0gd=)7NJ?*fsa~&8$)PT!np;9wtM#rTQY#v(mXOEDx~CYjkEOX`ZH!xzhq+ezfCrLHw<
z+k<$>dX&7ivS
z_xkV0q=Zl`SmIWKr7aii9=e#Z^_R~t8-{8Neyg4_d`tD#;uC4bMphST&Ngxlb~
z5bl%RX*C!@>DIOJdq6`0xeR{8%W|M6;~q*C-h#VcY=gaLhmI3q<$~Vd~;{+x_@p~{$#D>oU_Z>&$Ca?ySK=8
z%#r)$N#ItU_hNtY{3QZFBY1DJ2{5#P`sQ4j^L|sNy!G4@RHnSzEv1@BfNY;K);ydD
zjUHeUI`9PQPC$UF14goV;T_MnK1BvZ9sZaK^CAEsT&4S3uj8M3iz4O!bz+4;=(jB*
z5N}!~8=@484Sj*X8aXs-d`s5C-%)fV3X8@GI}03TmMq=+=S~F9#U;$be8KwM7(g@E
zX#c61?H{MWHF{G_O&$7nJ8&ftI0=iU!&HF0*6@l&t4%#nC0@s+NJUG5V;Sb$
z(ebT)f-$ut9fPnp0&M)R(pphx5r}9Ny|`h
z-c)LlATGG*5}LNR=i_oEELla3Wx5Cf6Hc?!3$wD$RF987In1vbepQDkF}9bGz#}b^
zdslVXJAS^IsxX(;*Vn1+yl>&ZAgHC-dux)(lKb8~AqfeqKrN*mI;lscJ|hBoc$F6X
z^QRXrR|0e5x7>UV{~+@AI883!pEe2ulg1M-PHgU=2XxLfOxq=%JpI%Z_wN0&ik?Kk
zsqEKr0joKQ$l+dr!5rYt1@B
z1aRdT3Vyi+G$ZYpv~V>TDY47I$!hGst2V22J35+}A$&Ck7rNNz79G-0WIg)wbldF~rwa+DImn+Pfz?V;(XG3NmLn!xl`-~M
z(|UISh3eSbd*I|)tL@5MbehJ3ft1?*%!t94oQ&0L^pixpfoX+-!h3ym)x~8apu`fl
zGmRm?6-50hnH))NU}Ci$O>Ry={?eGIm$$dIg=*m~TieYnd-_SHhKQJyj_A)NjfcXR
zn%|X&)ZX%4ol>jgeAl&osKdT1=S3#0(rDOv7x@+!qc0PrSe_CPNiNRIsxivEMBsG5&-0&nR(t!xbql46B?hR%=s~0=?|r^p}p59neM4t
zI6YW1jwW8pnUV`)JrXKvTIVd&IT+5~Pfcw;iP!i&BHnLVX+=eKm__vA@1bDO4@C3h
z%AMox8P}QP>8nIU^QLi<$KB(LB=_#zB##O&!L!iY=ZD6xWQ*fl5;DR|Jf!KRp7Ggu
zeRCyIO*KT9N!jK2kd0D1zvu_~wTJVD+Za8|
z0+(uB2D;tt&PR<{9hHso4(Cjcs@nG@=(UBiwG9&8jeal#2`B;=Xqj|(%Q!Fm;2!34
zvT0J&S*N%Gek7Grp{Z12wbZ{D8hVIjBPCm;D}h4RxFjO+6EE)?v{;$#FHP|YR;pKd-?J=t
ze~AH`IU(+D9fpoMyw2!&0|MD&`Sl3OKhAX=;BY)sE+ybA
zosCQK!uUi)ozs4zfO)+zEtL3UWS3>2UYtd9PJk@clc*@@B%4e)49vn3?W=DQakP(k
zS`KNfWw^DMD;;%PM(tBh`_!R|V{NL8M_wAZ#lnNJAY0wU_DZwQjqo3FmtAyCb0-=v
z7XWSzcnZaH3uIbcK9dnzh1HlK=G>H`ogfU}W6ab;O)RTjZ1BP3vWmMNWKAc<_M18B
z(tHrM9Vp!8jycJVGkmK*k={z-Jy61vhnezcT9}cf>SA15%3@bP>
zK^)4nvKT)IKfs>a2Rn&Pl+yr32Cr2c_pZsvF|sqp7EZB|Zog?^MsTyB0A{3x^p8%%kI5s8H2Q!Tkb?oFW+Y
zuE8dgwhmH+ouzpBhN^6xcjkVsI|-kTa&@iVNhd1y1Oqn`r5zn%T3TE+Y&wHr&!|Y9
zdv$o#NEf!oKQ-@R?e*f;+DcZRs4V+Bf2nY%I4f>N%cRzoqbUpI_e3Fo#!}f)Qk`bDf(9d7l7#cd2`q{u*5{eou
zmf#QxZ*WbPxX?PMT98YeVoG(RW`&$qt<&rESvCM1m+=Rh^;TXPL4$Wy)m91n5+-SA
zMzBrZ&k&PWxDf!IxxmN!zy4hDWh<{!PBRs0hxppJ5g|cj=W0&@KO}!7j-Ec9ab-2OYs;Fe331bO}x7i%&ge{jF5qU=r~DRuhTC<@6~q7%0=-vzRe%F&*&gdZ&1
zMUme*M3E{0yTz9nD52*tnDkAFpa0;Z_e$`Nw`V8zOFWddkP2NO(0u)tw
z?C-bHs+yhE;Wq25Q(AGC5`$(kiss>=91Lq%*UccMF8eSbQ`yl&*GBS!0|Lo6?&D?<
zx8@B6imtHK@-wiq$9X-lP(Oz`J9Esj7XFR8`iA@E0TL2dLh^v#uGj*h=psh9RkeB9
zJM$BuD_U}Pc2#3v|1dL~+s1Boej*}5&f+9dHeO+N?7ex8wWn+4In)uThJx&dDqH_K
zjX{XoZ6FlRw_U3~Oi@G|S-pXv4GgeOcel&#l>ghlHfW|SO9?5+J0%7hTmt1+Zn?ee
zd=4)`+$skdZQV^A1n+OXxR*to`)6n_#1fK`M;fp7PB}ZR)@L_ylE<8W(AU3TTry|x)1H}p3uIHgOmk#MTCX)zj`rA8g~&10H$K6%~N+^VfjYsr*MpPp}$v#
z{>xK`(z-f^0<)E2!&LAvZG>Em4cF*Uta)#C9=k&l_@osm}iKlJ@4y3v+2*EWB;ZHRQ0r*Jybv#qeJ?VJ7+gjU$(RQ=(Nl15C+f
z`Ua|DL(IO4)WuMoW5#w*R7La|=LIfV_UPpAfLq(!fhKij=+EnA*YSd=Un?8qeBJL9
z-}mFcmyaO_mpdccy1Pq_6G+5_Q(rxH!HW_y$2Tsl
z{jDC=q)DJDR>^Ruod6_a&S|3jzJs8OOsm~~e7PF)vV`Ms`Nt8@Sm;aI1oxdnZ#JEA
zvABB720%Z7TMpGOl_Cx=@*d034FDm|Ew$&?iR>%(>u`!X+LKXq&3JEhbRCNLFUEBx
z+%mivOV5WKt`i&-VAshfK`k72Ync>=`@>V>jHxBL?j88@;X@53tGb(G{ZId
zMhHnsjZ)~e=1)&d1J|WaPxlWC3w5-shIOkxDgoGl=v=+?)Nuz$#vY}o2gW^nN^hrD
z)d<9?WFOOysv7YPTQdaj?F25}1*~IqII9bqj*|~1znTg41URTZ(K+3lKce0$xKRTm
ztGO*IJdvM3TTy#LtVO}zgQ?ApX<@q+tx4(9gop+F@DKz{`$mWFobSsuQz(T
z#*F2uEovZDrLEsIBI26l;-je`wQcHK8^6k$d37~`t*@RB({yzebfLAYKPn*Smnk!C
zneTKwT-K3`jV!iZrTWdB3=6Ku=k8<#iK;cMcBZxX`nt~im>Ew=aZ17m1RPBXuYf*H
zr~(avZmt2By!Zqi3v~}?r~fZOu+&>6Id!vxRnEr-lg64yF{Df5aC{9C<<4gU#~gP;
zlxBK#{W4_e_tz_)Zg2B6?b1xO`0iVA{XjFJr8hA%C_)w>jp>e#Bzc-Div7tT^p3}<
z+g!mHr`xnU5AM#)Q$>9Gz4Lp8QgwO+L>kQXt0eOwA74HYm*o@C1!GwAlj0hT!V)RH
zC;2p0&|NoLc%kVS=lr}Q02f<1E^o|#P&ww45Z<4Ns#*oXHIE3_53gN5wOay6h1dus&%TcYJ0c3i&|5*7wDas{e@)-CBZ
z;#wQQ4Ftl8hH1>y0i`$=AQAZ=!mpa>e$?eWC0M`LyNo`H(>bzqG&i8X@GM%y?BhId
zrw(d!dcmEIX1}Ibu(FABYz%)R<`_3*Ia3rri56SL^ZZzvjgh_>QimQp(@uYg(0~p=&5E;@U}h11e#eg!4kVn9C}(;=
zw}jFuSFk*5gKze%sFa~Vui0J=1jP6?P}9@a?r
zh|8AEyw;mxVDRY5$#s5J=AT`%682|GNlkTloq;Ys3aahMZE&&CW1n?afUhFs*4Atg
zAP*q-#kNmHOvvak+GFw9IZQS8J^Y?hE{hPrY$S1E0J>cLO4CUJh
z>K{I{_PQydph`L`Afezf>UI!UKZ?AcPLszPM0$vppbN$QB2xMoEmn^ywwRF?saLEQ
zu!jf7?DM%6eNS|}v~LNO{Z%ATvVcD0lBj^1B
z{WNAt4Xd_E${2mxx4?Yy+I5pms9K>bS6yfC^Az|NH)kttzIx?zR4v)D&Ivk<_(e3d
z{pHJxon_SqT&pBNRc|q{_o3qJ_i>|cO5WNGPa?;Q3?wYK-I}+iX=6fpm19Bxq5&9<
zdoc6?AlJ=m_Y@Ytl{F_IIZeY--G>*h`fa!R_)Et~Z4796o)2JR`aC4&Szgu$xO7+K
z@iG0YATxS?Gk4uI=053w(woFfgx4mSBouB+{6)dItvc%pN<2va
zxw%FF{c+7V)SB1XwPRT6Onkpb##z~a$v|BLf(Wvrk
zx~UDtp)T-&ZEq!)-k=SAVzoBg>ZM&}Bk1Cg3akK7R_8yIW#iS-_~je;D(mLF+<{VW
zWV5N?jpNH;6sVt>Z!lDi4)9g@+kTKDFyqbh`I51OA~5YA-P|654cfd9IFecS$_=}=ipp>Cd{eR_iL=!DVTr#th-Hh&So{Djrew80s1h0U0Empuxw8Q8
zVJy`o)AAqvAkr$4i?6V(So*?4Y?%I@MByeLDGq)8jKanXz?Jh+Sp1x{NLAAq{G0@?
s9R-opT`1_!;o=qkJ23G1e|>kM0Gv?1LLEClK=n!

diff --git a/reactor/etc/reactor.ucls b/reactor/etc/reactor.ucls
index d072e4029..90e28cdd7 100644
--- a/reactor/etc/reactor.ucls
+++ b/reactor/etc/reactor.ucls
@@ -124,80 +124,108 @@
           
       
     
-      
-        
-      
-    
-      
-          
-            
-          
+      
+          
+            
+          
         
         
       
     
-      
-        
-        
-      
-    
-      
-        
-          
-            
-          
-        
-        
-      
-    
-      
-        
-      
-    
-      
-        
-      
-    
-      
-          
-            
-          
-        
-        
-      
-    
-      
-          
-            
-          
-        
-        
-      
-    
-      
-        
-      
-    
-      
+      
           
-            
-          
+              
+              
+            
+              
+              
+          
         
         
       
     
-      
-        
-      
-    
-      
+      
         
+      
+    
+      
+        
       
     
-      
+      
+        
+        
+      
+    
+      
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
         
       
     
+      
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+        
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+        
+      
+    
       
         
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index 5c6d91ee8..7bb01ddc8 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -66,6 +66,15 @@ 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.
@@ -73,16 +82,15 @@ public class App {
    * @throws IOException
    */
   public static void main(String[] args) throws IOException {
-    new App().start(new ThreadPoolDispatcher(2));
+    new App(new ThreadPoolDispatcher(2)).start();
   }
 
   /**
    * Starts the NIO reactor.
- * @param threadPoolDispatcher 
-   * 
+   *
    * @throws IOException if any channel fails to bind.
    */
-  public void start(Dispatcher dispatcher) throws IOException {
+  public void start() throws IOException {
     /*
      * The application can customize its event dispatching mechanism.
      */
@@ -110,8 +118,9 @@ public class App {
    */
   public void stop() throws InterruptedException, IOException {
     reactor.stop();
+    dispatcher.stop();
     for (AbstractNioChannel channel : channels) {
-    	channel.getChannel().close();
+    	channel.getJavaChannel().close();
     }
   }
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
index 4abacd86f..9f2f8a95c 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
@@ -48,7 +48,7 @@ public abstract class AbstractNioChannel {
   /**
    * @return the wrapped NIO channel.
    */
-  public SelectableChannel getChannel() {
+  public SelectableChannel getJavaChannel() {
     return channel;
   }
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
index b55480ffc..a2ff3d3d8 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioDatagramChannel.java
@@ -64,8 +64,8 @@ public class NioDatagramChannel extends AbstractNioChannel {
    * @return the underlying datagram channel.
    */
   @Override
-  public DatagramChannel getChannel() {
-    return (DatagramChannel) super.getChannel();
+  public DatagramChannel getJavaChannel() {
+    return (DatagramChannel) super.getJavaChannel();
   }
 
   /**
@@ -75,8 +75,8 @@ public class NioDatagramChannel extends AbstractNioChannel {
    */
   @Override
   public void bind() throws IOException {
-    getChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
-    getChannel().configureBlocking(false);
+    getJavaChannel().socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
+    getJavaChannel().configureBlocking(false);
     System.out.println("Bound UDP socket at port: " + port);
   }
 
@@ -87,7 +87,7 @@ public class NioDatagramChannel extends AbstractNioChannel {
   @Override
   protected void doWrite(Object pendingWrite, SelectionKey key) throws IOException {
     DatagramPacket pendingPacket = (DatagramPacket) pendingWrite;
-    getChannel().send(pendingPacket.getData(), pendingPacket.getReceiver());
+    getJavaChannel().send(pendingPacket.getData(), pendingPacket.getReceiver());
   }
 
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
index b818612e5..16c13e5f9 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioReactor.java
@@ -74,12 +74,13 @@ public class NioReactor {
    * 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 {
+  public void stop() throws InterruptedException, IOException {
     reactorMain.shutdownNow();
     selector.wakeup();
     reactorMain.awaitTermination(4, TimeUnit.SECONDS);
-    dispatcher.stop();
+    selector.close();
   }
 
   /**
@@ -94,7 +95,7 @@ public class NioReactor {
    * @throws IOException if any I/O error occurs.
    */
   public NioReactor registerChannel(AbstractNioChannel channel) throws IOException {
-    SelectionKey key = channel.getChannel().register(selector, channel.getInterestedOps());
+    SelectionKey key = channel.getJavaChannel().register(selector, channel.getInterestedOps());
     key.attach(channel);
     channel.setReactor(this);
     return this;
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index c635a6076..c5caaa7ff 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -43,8 +43,8 @@ public class NioServerSocketChannel extends AbstractNioChannel {
    * @return the underlying {@link ServerSocketChannel}.
    */
   @Override
-  public ServerSocketChannel getChannel() {
-    return (ServerSocketChannel) super.getChannel();
+  public ServerSocketChannel getJavaChannel() {
+    return (ServerSocketChannel) super.getJavaChannel();
   }
 
   /**
@@ -71,8 +71,8 @@ public class NioServerSocketChannel extends AbstractNioChannel {
    */
   @Override
   public void bind() throws IOException {
-    ((ServerSocketChannel) getChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
-    ((ServerSocketChannel) getChannel()).configureBlocking(false);
+    ((ServerSocketChannel) getJavaChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
+    ((ServerSocketChannel) getJavaChannel()).configureBlocking(false);
     System.out.println("Bound TCP socket at port: " + port);
   }
 
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
index 752192ef3..9abb4e690 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
@@ -22,8 +22,8 @@ public class AppTest {
    */
   @Test
   public void testAppUsingThreadPoolDispatcher() throws IOException, InterruptedException {
-    App app = new App();
-    app.start(new ThreadPoolDispatcher(2));
+    App app = new App(new ThreadPoolDispatcher(2));
+    app.start();
 
     AppClient client = new AppClient();
     client.start();
@@ -48,8 +48,8 @@ public class AppTest {
    */
   @Test
   public void testAppUsingSameThreadDispatcher() throws IOException, InterruptedException {
-    App app = new App();
-    app.start(new SameThreadDispatcher());
+    App app = new App(new SameThreadDispatcher());
+    app.start();
 
     AppClient client = new AppClient();
     client.start();

From d0af12b1ee59e261b4368d28c101169a2305e943 Mon Sep 17 00:00:00 2001
From: Alan 
Date: Wed, 16 Sep 2015 21:32:52 +0100
Subject: [PATCH 229/687] Removed magic number.

---
 dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
index e5e5eb220..230314d80 100644
--- a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
@@ -84,7 +84,7 @@ public class CustomerDaoImplTest {
 
   @Test
   public void getNonExistinCustomerById() {
-    final int nonExistingId = 999;
+    final int nonExistingId = getNonExistingCustomerId();
     assertNull(impl.getCustomerById(nonExistingId));
   }
 

From dd0fcea09094b885f4f58fed7ef15ae7a63bb8a7 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Fri, 18 Sep 2015 19:59:52 +0300
Subject: [PATCH 230/687] Package naming corrections and cleanup.

---
 fluentinterface/etc/fluentinterface.ucls      | 36 +++++------
 .../fluentinterface/{ => app}/App.java        |  2 +-
 .../fluentinterface/{ => app}/AppTest.java    |  4 +-
 .../view/controller/with/observer/App.java    | 29 ---------
 .../controller/with/observer/Fatigue.java     | 22 -------
 .../with/observer/GiantController.java        | 46 --------------
 .../controller/with/observer/GiantModel.java  | 63 -------------------
 .../with/observer/GiantModelObserver.java     | 12 ----
 .../controller/with/observer/GiantView.java   | 18 ------
 .../view/controller/with/observer/Health.java | 22 -------
 .../controller/with/observer/Nourishment.java | 22 -------
 .../controller/with/observer/AppTest.java     | 19 ------
 .../com/iluwatar/servicelayer/app/App.java    |  6 +-
 .../servicelayer/hibernate/HibernateUtil.java |  2 +-
 .../servicelayer/magic/MagicService.java      |  2 +-
 .../servicelayer/magic/MagicServiceImpl.java  |  4 +-
 .../{servicelayer => }/spell/Spell.java       |  2 +-
 .../{servicelayer => }/spell/SpellDao.java    |  2 +-
 .../spell/SpellDaoImpl.java                   |  2 +-
 .../servicelayer/spellbook/Spellbook.java     |  2 +-
 20 files changed, 33 insertions(+), 284 deletions(-)
 rename fluentinterface/src/main/java/com/iluwatar/fluentinterface/{ => app}/App.java (98%)
 rename fluentinterface/src/test/java/com/iluwatar/fluentinterface/{ => app}/AppTest.java (59%)
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java
 delete mode 100644 model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java
 delete mode 100644 model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java
 rename service-layer/src/main/java/com/iluwatar/servicelayer/{servicelayer => }/spell/Spell.java (95%)
 rename service-layer/src/main/java/com/iluwatar/servicelayer/{servicelayer => }/spell/SpellDao.java (75%)
 rename service-layer/src/main/java/com/iluwatar/servicelayer/{servicelayer => }/spell/SpellDaoImpl.java (94%)

diff --git a/fluentinterface/etc/fluentinterface.ucls b/fluentinterface/etc/fluentinterface.ucls
index aab2c9ad7..e30c45bb2 100644
--- a/fluentinterface/etc/fluentinterface.ucls
+++ b/fluentinterface/etc/fluentinterface.ucls
@@ -1,8 +1,8 @@
 
   
-      
+      
         
           
@@ -55,7 +55,7 @@
       
     
       
+    file="C:/Program Files/Java/jdk1.8.0_25/jre/lib/rt.jar" binary="true" corner="BOTTOM_RIGHT">    
         
           
@@ -64,33 +64,33 @@
       
     
       
-        
-      
-    
-      
-        
-      
-    
-      
         
       
     
-      
-        
-      
-    
-      
+      
         
       
     
-      
+      
         
       
     
-      
+      
         
       
     
+      
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
       
         
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
similarity index 98%
rename from fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
rename to fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
index f7352fe39..81a1ccb6a 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
@@ -1,4 +1,4 @@
-package com.iluwatar.fluentinterface;
+package com.iluwatar.fluentinterface.app;
 
 import com.iluwatar.fluentinterface.fluentiterable.FluentIterable;
 import com.iluwatar.fluentinterface.fluentiterable.lazy.LazyFluentIterable;
diff --git a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
similarity index 59%
rename from fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
rename to fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
index d0abb7bf1..29ad885c0 100644
--- a/fluentinterface/src/test/java/com/iluwatar/fluentinterface/AppTest.java
+++ b/fluentinterface/src/test/java/com/iluwatar/fluentinterface/app/AppTest.java
@@ -1,7 +1,9 @@
-package com.iluwatar.fluentinterface;
+package com.iluwatar.fluentinterface.app;
 
 import org.junit.Test;
 
+import com.iluwatar.fluentinterface.app.App;
+
 public class AppTest {
 
   @Test
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java
deleted file mode 100644
index 0b74f4b5a..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/App.java
+++ /dev/null
@@ -1,29 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * In this second example the model-view relationship is different. This time we use the Observer pattern to notify
- * the {@link GiantView} each time the {@link GiantModel} is changed. This way the {@link GiantController} responsibilities
- * are narrowed and it only needs to modify the {@link GiantModel} according to the user input.
- * 
- */
-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
-    	// model modifications trigger the view rendering automatically
-    	controller.setHealth(Health.WOUNDED);
-    	controller.setNourishment(Nourishment.HUNGRY);
-    	controller.setFatigue(Fatigue.TIRED);
-    }
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java
deleted file mode 100644
index 301a579fb..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Fatigue.java
+++ /dev/null
@@ -1,22 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * 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;
-	}	
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java
deleted file mode 100644
index e892b2946..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantController.java
+++ /dev/null
@@ -1,46 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * GiantController updates the giant model.
- *
- */
-public class GiantController {
-
-	private GiantModel giant;
-	private GiantView view;
-
-	public GiantController(GiantModel giant, GiantView view) {
-		this.giant = giant;
-		this.view = view;
-		this.giant.registerObserver(this.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);
-	}
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java
deleted file mode 100644
index 84b32a50a..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModel.java
+++ /dev/null
@@ -1,63 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- * 
- * GiantModel contains the giant data.
- *
- */
-public class GiantModel {
-	
-	private Health health;
-	private Fatigue fatigue;
-	private Nourishment nourishment;
-	private List observers = new ArrayList<>();
-
-	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;
-		notifyObservers();
-	}
-
-	public Fatigue getFatigue() {
-		return fatigue;
-	}
-
-	public void setFatigue(Fatigue fatigue) {
-		this.fatigue = fatigue;
-		notifyObservers();
-	}
-
-	public Nourishment getNourishment() {
-		return nourishment;
-	}
-
-	public void setNourishment(Nourishment nourishment) {
-		this.nourishment = nourishment;
-		notifyObservers();
-	}
-	
-	@Override
-	public String toString() {
-		return String.format("The giant looks %s, %s and %s.", health, fatigue, nourishment);
-	}
-	
-	public void registerObserver(GiantModelObserver observer) {
-		observers.add(observer);
-	}
-	
-	private void notifyObservers() {
-		observers.stream().forEach((GiantModelObserver o) -> o.modelChanged(this));
-	}
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java
deleted file mode 100644
index 6363ef4f7..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantModelObserver.java
+++ /dev/null
@@ -1,12 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * GiantModelObserver is the interface for delivering update notifications.
- *
- */
-public interface GiantModelObserver {
-	
-	void modelChanged(GiantModel model);
-
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java
deleted file mode 100644
index f4cebad80..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/GiantView.java
+++ /dev/null
@@ -1,18 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * GiantView displays the giant
- *
- */
-public class GiantView implements GiantModelObserver {
-
-	public void displayGiant(GiantModel giant) {
-		System.out.println(giant);
-	}
-
-	@Override
-	public void modelChanged(GiantModel model) {
-		displayGiant(model);
-	}
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java
deleted file mode 100644
index e4b8ed9a7..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Health.java
+++ /dev/null
@@ -1,22 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * 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;
-	}
-}
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java
deleted file mode 100644
index c1a8253c3..000000000
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/with/observer/Nourishment.java
+++ /dev/null
@@ -1,22 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-/**
- * 
- * 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;
-	}	
-}
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java
deleted file mode 100644
index 9a43ce7bc..000000000
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/with/observer/AppTest.java
+++ /dev/null
@@ -1,19 +0,0 @@
-package com.iluwatar.model.view.controller.with.observer;
-
-import org.junit.Test;
-
-import com.iluwatar.model.view.controller.with.observer.App;
-
-/**
- * 
- * Application test
- *
- */
-public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
-}
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
index 2d91b43d9..47eb5231e 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
@@ -4,9 +4,9 @@ import java.util.List;
 
 import com.iluwatar.servicelayer.magic.MagicService;
 import com.iluwatar.servicelayer.magic.MagicServiceImpl;
-import com.iluwatar.servicelayer.servicelayer.spell.Spell;
-import com.iluwatar.servicelayer.servicelayer.spell.SpellDao;
-import com.iluwatar.servicelayer.servicelayer.spell.SpellDaoImpl;
+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;
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
index 70d586c08..61d0f5d5d 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
@@ -3,7 +3,7 @@ package com.iluwatar.servicelayer.hibernate;
 import org.hibernate.SessionFactory;
 import org.hibernate.cfg.Configuration;
 
-import com.iluwatar.servicelayer.servicelayer.spell.Spell;
+import com.iluwatar.servicelayer.spell.Spell;
 import com.iluwatar.servicelayer.spellbook.Spellbook;
 import com.iluwatar.servicelayer.wizard.Wizard;
 
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
index a6046742b..38742c78d 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
@@ -2,7 +2,7 @@ package com.iluwatar.servicelayer.magic;
 
 import java.util.List;
 
-import com.iluwatar.servicelayer.servicelayer.spell.Spell;
+import com.iluwatar.servicelayer.spell.Spell;
 import com.iluwatar.servicelayer.spellbook.Spellbook;
 import com.iluwatar.servicelayer.wizard.Wizard;
 
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
index e5599fc4e..37249894a 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
@@ -3,8 +3,8 @@ package com.iluwatar.servicelayer.magic;
 import java.util.ArrayList;
 import java.util.List;
 
-import com.iluwatar.servicelayer.servicelayer.spell.Spell;
-import com.iluwatar.servicelayer.servicelayer.spell.SpellDao;
+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;
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/Spell.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
similarity index 95%
rename from service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/Spell.java
rename to service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
index 5dc7a6acc..ed166eccc 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/Spell.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
@@ -1,4 +1,4 @@
-package com.iluwatar.servicelayer.servicelayer.spell;
+package com.iluwatar.servicelayer.spell;
 
 import javax.persistence.Column;
 import javax.persistence.Entity;
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/SpellDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
similarity index 75%
rename from service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/SpellDao.java
rename to service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
index 079ef39a0..a59307e7f 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/SpellDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
@@ -1,4 +1,4 @@
-package com.iluwatar.servicelayer.servicelayer.spell;
+package com.iluwatar.servicelayer.spell;
 
 import com.iluwatar.servicelayer.common.Dao;
 
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/SpellDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
similarity index 94%
rename from service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/SpellDaoImpl.java
rename to service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
index d8655ac3a..d278defe2 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/servicelayer/spell/SpellDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
@@ -1,4 +1,4 @@
-package com.iluwatar.servicelayer.servicelayer.spell;
+package com.iluwatar.servicelayer.spell;
 
 import org.hibernate.Criteria;
 import org.hibernate.Session;
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
index 5bf42c7ed..c596c9926 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
@@ -13,7 +13,7 @@ import javax.persistence.OneToMany;
 import javax.persistence.Table;
 
 import com.iluwatar.servicelayer.common.BaseEntity;
-import com.iluwatar.servicelayer.servicelayer.spell.Spell;
+import com.iluwatar.servicelayer.spell.Spell;
 import com.iluwatar.servicelayer.wizard.Wizard;
 
 /**

From b3e4e8a47bf5f88277029534456334d9e2c59432 Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Tue, 22 Sep 2015 18:25:56 +0530
Subject: [PATCH 231/687] Work on #226, #213, added references of Gang Of Four
 to all GoF patterns, added tag for Gang Of Four, added difficulty tags to
 some of them

---
 abstract-factory/index.md | 8 +++++++-
 adapter/index.md          | 8 +++++++-
 bridge/index.md           | 8 +++++++-
 builder/index.md          | 8 +++++++-
 chain/index.md            | 8 +++++++-
 command/index.md          | 8 +++++++-
 composite/index.md        | 8 +++++++-
 decorator/index.md        | 8 +++++++-
 facade/index.md           | 8 +++++++-
 factory-method/index.md   | 5 +++++
 flyweight/index.md        | 8 +++++++-
 interpreter/index.md      | 8 +++++++-
 iterator/index.md         | 9 ++++++++-
 mediator/index.md         | 9 ++++++++-
 memento/index.md          | 8 +++++++-
 observer/index.md         | 9 ++++++++-
 prototype/index.md        | 8 +++++++-
 proxy/index.md            | 9 ++++++++-
 singleton/index.md        | 9 ++++++++-
 state/index.md            | 9 ++++++++-
 strategy/index.md         | 9 ++++++++-
 template-method/index.md  | 9 ++++++++-
 visitor/index.md          | 9 ++++++++-
 23 files changed, 168 insertions(+), 22 deletions(-)

diff --git a/abstract-factory/index.md b/abstract-factory/index.md
index cb229f4ab..7db699a99 100644
--- a/abstract-factory/index.md
+++ b/abstract-factory/index.md
@@ -4,7 +4,9 @@ title: Abstract Factory
 folder: abstract-factory
 permalink: /patterns/abstract-factory/
 categories: Creational
-tags: Java
+tags: 
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Provide an interface for creating families of related or dependent
@@ -22,3 +24,7 @@ objects without specifying their concrete classes.
 **Real world examples:**
 
 * [javax.xml.parsers.DocumentBuilderFactory](http://docs.oracle.com/javase/8/docs/api/javax/xml/parsers/DocumentBuilderFactory.html)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/adapter/index.md b/adapter/index.md
index 23aaeadcc..be9a87228 100644
--- a/adapter/index.md
+++ b/adapter/index.md
@@ -4,7 +4,9 @@ title: Adapter
 folder: adapter
 permalink: /patterns/adapter/
 categories: Structural
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Convert the interface of a class into another interface the clients
@@ -22,3 +24,7 @@ incompatible interfaces.
 **Real world examples:**
 
 * [java.util.Arrays#asList()](http://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#asList%28T...%29)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/bridge/index.md b/bridge/index.md
index 6ef1c6519..1ad969183 100644
--- a/bridge/index.md
+++ b/bridge/index.md
@@ -4,7 +4,9 @@ title: Bridge
 folder: bridge
 permalink: /patterns/bridge/
 categories: Structural
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Decouple an abstraction from its implementation so that the two can
@@ -20,3 +22,7 @@ vary 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)
diff --git a/builder/index.md b/builder/index.md
index aa5c86201..f350638d2 100644
--- a/builder/index.md
+++ b/builder/index.md
@@ -4,7 +4,9 @@ title: Builder
 folder: builder
 permalink: /patterns/builder/
 categories: Creational
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Separate the construction of a complex object from its
@@ -22,3 +24,7 @@ representations.
 
 * [java.lang.StringBuilder](http://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.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)
diff --git a/chain/index.md b/chain/index.md
index 25e14bf06..9be376324 100644
--- a/chain/index.md
+++ b/chain/index.md
@@ -4,7 +4,9 @@ title: Chain of responsibility
 folder: chain
 permalink: /patterns/chain/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Avoid coupling the sender of a request to its receiver by giving
@@ -23,3 +25,7 @@ objects and pass the request along the chain until an object handles it.
 
 * [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)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/command/index.md b/command/index.md
index 23582406e..c9790819f 100644
--- a/command/index.md
+++ b/command/index.md
@@ -4,7 +4,9 @@ title: Command
 folder: command
 permalink: /patterns/command/
 categories: Behavioral
-tags: Java
+tags: 
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Encapsulate a request as an object, thereby letting you
@@ -30,3 +32,7 @@ support undoable operations.
 **Real world examples:**
 
 * [java.lang.Runnable](http://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/composite/index.md b/composite/index.md
index 374e1d5aa..4a31a1b33 100644
--- a/composite/index.md
+++ b/composite/index.md
@@ -4,7 +4,9 @@ title: Composite
 folder: composite
 permalink: /patterns/composite/
 categories: Structural
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Compose objects into tree structures to represent part-whole
@@ -22,3 +24,7 @@ of objects uniformly.
 
 * [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)
diff --git a/decorator/index.md b/decorator/index.md
index 02f129258..55849fce6 100644
--- a/decorator/index.md
+++ b/decorator/index.md
@@ -4,7 +4,9 @@ title: Decorator
 folder: decorator
 permalink: /patterns/decorator/
 categories: Structural
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Attach additional responsibilities to an object dynamically.
@@ -18,3 +20,7 @@ functionality.
 * 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
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/facade/index.md b/facade/index.md
index 0f6e2fbb1..59ff888b2 100644
--- a/facade/index.md
+++ b/facade/index.md
@@ -4,7 +4,9 @@ title: Facade
 folder: facade
 permalink: /patterns/facade/
 categories: Structural
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Provide a unified interface to a set of interfaces in a subsystem.
@@ -17,3 +19,7 @@ Facade defines a higher-level interface that makes the subsystem easier to use.
 * 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)
diff --git a/factory-method/index.md b/factory-method/index.md
index 8011e42c8..fee6b6e83 100644
--- a/factory-method/index.md
+++ b/factory-method/index.md
@@ -7,6 +7,7 @@ categories: Creational
 tags: 
  - Java
  - Difficulty-Beginner
+ - Gang Of Four
 ---
 
 **Intent:** Define an interface for creating an object, but let subclasses
@@ -20,3 +21,7 @@ instantiation to subclasses.
 * 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
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/flyweight/index.md b/flyweight/index.md
index 85fa54ad1..e2273c197 100644
--- a/flyweight/index.md
+++ b/flyweight/index.md
@@ -4,7 +4,9 @@ title: Flyweight
 folder: flyweight
 permalink: /patterns/flyweight/
 categories: Structural
-tags: Java
+tags: 
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Use sharing to support large numbers of fine-grained objects
@@ -25,3 +27,7 @@ true
 **Real world examples:**
 
 * [java.lang.Integer#valueOf(int)](http://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html#valueOf%28int%29)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/interpreter/index.md b/interpreter/index.md
index c7c4539d5..57b117e06 100644
--- a/interpreter/index.md
+++ b/interpreter/index.md
@@ -4,7 +4,9 @@ title: Interpreter
 folder: interpreter
 permalink: /patterns/interpreter/
 categories: Behavioral
-tags: Java
+tags: 
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Given a language, define a representation for its grammar along
@@ -19,3 +21,7 @@ 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
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/iterator/index.md b/iterator/index.md
index 63bdaf516..ecfdb1b2a 100644
--- a/iterator/index.md
+++ b/iterator/index.md
@@ -4,7 +4,10 @@ title: Iterator
 folder: iterator
 permalink: /patterns/iterator/
 categories: Behavioral
-tags: Java
+tags: 
+ - Java
+ - Difficulty-Beginner
+ - Gang Of Four
 ---
 
 **Intent:** Provide a way to access the elements of an aggregate object
@@ -21,3 +24,7 @@ sequentially without exposing its underlying representation.
 **Real world examples:**
 
 * [java.util.Iterator](http://docs.oracle.com/javase/8/docs/api/java/util/Iterator.html)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/mediator/index.md b/mediator/index.md
index e67218a53..cb4ce7fb1 100644
--- a/mediator/index.md
+++ b/mediator/index.md
@@ -4,7 +4,10 @@ title: Mediator
 folder: mediator
 permalink: /patterns/mediator/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
+ - Difficulty-Intermediate
 ---
 
 **Intent:** Define an object that encapsulates how a set of objects interact.
@@ -18,3 +21,7 @@ other explicitly, and it lets you vary their interaction independently.
 * 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
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)	
diff --git a/memento/index.md b/memento/index.md
index b91e34739..056af8b26 100644
--- a/memento/index.md
+++ b/memento/index.md
@@ -4,7 +4,9 @@ title: Memento
 folder: memento
 permalink: /patterns/memento/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Without violating encapsulation, capture and externalize an
@@ -20,3 +22,7 @@ object's internal state so that the object can be restored to this state later.
 **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)
diff --git a/observer/index.md b/observer/index.md
index d5b380a30..fedb4cb8c 100644
--- a/observer/index.md
+++ b/observer/index.md
@@ -4,7 +4,10 @@ title: Observer
 folder: observer
 permalink: /patterns/observer/
 categories: Behavioral
-tags: Java
+tags: 
+ - Java
+ - Difficulty-Beginner
+ - Gang Of Four
 ---
 
 **Intent:** Define a one-to-many dependency between objects so that when one
@@ -26,3 +29,7 @@ automatically.
 **Real world examples:**
 
 * [java.util.Observer](http://docs.oracle.com/javase/8/docs/api/java/util/Observer.html)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/prototype/index.md b/prototype/index.md
index cab97f7dc..9d108ff06 100644
--- a/prototype/index.md
+++ b/prototype/index.md
@@ -4,7 +4,9 @@ title: Prototype
 folder: prototype
 permalink: /patterns/prototype/
 categories: Creational
-tags: Java
+tags: 
+ - Java
+ - Gang Of Four
 ---
 
 **Intent:** Specify the kinds of objects to create using a prototypical
@@ -21,3 +23,7 @@ instance, and create new objects by copying this prototype.
 **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)
diff --git a/proxy/index.md b/proxy/index.md
index 96ea40714..f863a96a5 100644
--- a/proxy/index.md
+++ b/proxy/index.md
@@ -4,7 +4,10 @@ title: Proxy
 folder: proxy
 permalink: /patterns/proxy/
 categories: Structural
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
+ - Difficulty-Intermediate
 ---
 
 **Intent:** Provide a surrogate or placeholder for another object to control
@@ -32,3 +35,7 @@ are several common situations in which the Proxy pattern is applicable
 
 * [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/)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/singleton/index.md b/singleton/index.md
index 7a280bdfa..18c137448 100644
--- a/singleton/index.md
+++ b/singleton/index.md
@@ -4,7 +4,10 @@ title: Singleton
 folder: singleton
 permalink: /patterns/singleton/
 categories: Creational
-tags: Java
+tags:
+ - Java
+ - Gang Of Four
+ - Difficulty-Beginner
 ---
 
 **Intent:** Ensure a class only has one instance, and provide a global point of
@@ -26,3 +29,7 @@ access to it.
 **Real world examples:**
 
 * [java.lang.Runtime#getRuntime()](http://docs.oracle.com/javase/8/docs/api/java/lang/Runtime.html#getRuntime%28%29)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/state/index.md b/state/index.md
index 1b1e4717f..b743cb8be 100644
--- a/state/index.md
+++ b/state/index.md
@@ -4,7 +4,10 @@ title: State
 folder: state
 permalink: /patterns/state/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Difficulty-Intermediate
+ - Gang Of Four
 ---
 
 **Intent:** Allow an object to alter its behavior when its internal state
@@ -16,3 +19,7 @@ changes. The object will appear to change its class.
 
 * 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.
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)
diff --git a/strategy/index.md b/strategy/index.md
index 1d3250517..120dd64d4 100644
--- a/strategy/index.md
+++ b/strategy/index.md
@@ -4,7 +4,10 @@ title: Strategy
 folder: strategy
 permalink: /patterns/strategy/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Difficulty-Beginner
+ - Gang Of Four
 ---
 
 **Intent:** Define a family of algorithms, encapsulate each one, and make them
@@ -19,3 +22,7 @@ that use it.
 * 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)
diff --git a/template-method/index.md b/template-method/index.md
index f647d2cd5..8b8b7878e 100644
--- a/template-method/index.md
+++ b/template-method/index.md
@@ -4,7 +4,10 @@ title: Template method
 folder: template-method
 permalink: /patterns/template-method/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Difficulty-Beginner
+ - Gang Of Four
 ---
 
 **Intent:** Define the skeleton of an algorithm in an operation, deferring some
@@ -18,3 +21,7 @@ an algorithm without changing the algorithm's structure.
 * 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)
diff --git a/visitor/index.md b/visitor/index.md
index eeb11a5e5..5f32edbbd 100644
--- a/visitor/index.md
+++ b/visitor/index.md
@@ -4,7 +4,10 @@ title: Visitor
 folder: visitor
 permalink: /patterns/visitor/
 categories: Behavioral
-tags: Java
+tags:
+ - Java
+ - Difficulty-Expert
+ - Gang Of Four
 ---
 
 **Intent:** Represent an operation to be performed on the elements of an object
@@ -22,3 +25,7 @@ of the elements on which it operates.
 **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)
+
+**Credits**
+
+* [Design Patterns: Elements of Reusable Object-Oriented Software](http://www.amazon.com/Design-Patterns-Elements-Reusable-Object-Oriented/dp/0201633612)

From ec9af416ba82ba95e07686529b2468900be8f453 Mon Sep 17 00:00:00 2001
From: Maxim Galushka 
Date: Wed, 23 Sep 2015 17:58:58 +0100
Subject: [PATCH 232/687] #247 adding getAttackPower method to pattern
 decorator

---
 decorator/src/main/java/com/iluwatar/decorator/App.java     | 2 ++
 decorator/src/main/java/com/iluwatar/decorator/Hostile.java | 2 ++
 .../src/main/java/com/iluwatar/decorator/SmartTroll.java    | 6 ++++++
 decorator/src/main/java/com/iluwatar/decorator/Troll.java   | 5 +++++
 4 files changed, 15 insertions(+)

diff --git a/decorator/src/main/java/com/iluwatar/decorator/App.java b/decorator/src/main/java/com/iluwatar/decorator/App.java
index 88e1c7103..a9eabf606 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/App.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/App.java
@@ -23,11 +23,13 @@ public class App {
 		Hostile troll = new Troll();
 		troll.attack();
 		troll.fleeBattle();
+		System.out.printf("Simple troll power %d.\n", troll.getAttackPower());
 
 		// change the behavior of the simple troll by adding a decorator
 		System.out.println("\nA smart looking troll surprises you.");
 		Hostile smart = new SmartTroll(troll);
 		smart.attack();
 		smart.fleeBattle();
+		System.out.printf("Smart troll power %d.\n", smart.getAttackPower());
 	}
 }
diff --git a/decorator/src/main/java/com/iluwatar/decorator/Hostile.java b/decorator/src/main/java/com/iluwatar/decorator/Hostile.java
index 4df751cca..709072501 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/Hostile.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/Hostile.java
@@ -9,6 +9,8 @@ public interface Hostile {
 
 	void attack();
 
+	int getAttackPower();
+
 	void fleeBattle();
 
 }
diff --git a/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java b/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java
index 22ba88dc8..909f94c95 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java
@@ -21,6 +21,12 @@ public class SmartTroll implements Hostile {
 		decorated.attack();
 	}
 
+	@Override
+	public int getAttackPower() {
+		// decorated troll power + 20 because it is smart
+		return decorated.getAttackPower() + 20;
+	}
+
 	@Override
 	public void fleeBattle() {
 		System.out.println("The troll calls for help!");
diff --git a/decorator/src/main/java/com/iluwatar/decorator/Troll.java b/decorator/src/main/java/com/iluwatar/decorator/Troll.java
index 11e9b9d1a..85d873dbe 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/Troll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/Troll.java
@@ -11,6 +11,11 @@ public class Troll implements Hostile {
 		System.out.println("The troll swings at you with a club!");
 	}
 
+	@Override
+	public int getAttackPower() {
+		return 10;
+	}
+
 	public void fleeBattle() {
 		System.out.println("The troll shrieks in horror and runs away!");
 	}

From 36809537d997bc39d8c7e7d51670add5213fa603 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Thu, 24 Sep 2015 01:01:51 -0400
Subject: [PATCH 233/687] checkstyle fixes - docs, indent etc

---
 .../main/java/com/iluwatar/singleton/App.java | 69 ++++++++++---------
 .../iluwatar/singleton/EnumIvoryTower.java    | 11 +--
 .../InitializingOnDemandHolderIdiom.java      | 36 +++++-----
 .../com/iluwatar/singleton/IvoryTower.java    | 31 ++++++---
 .../ThreadSafeDoubleCheckLocking.java         | 62 +++++++++--------
 .../ThreadSafeLazyLoadedIvoryTower.java       | 33 ++++-----
 6 files changed, 132 insertions(+), 110 deletions(-)

diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index 67cb6fd00..e8a3a1571 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -1,3 +1,6 @@
+/**
+ * Singleton pattern.
+ */
 package com.iluwatar.singleton;
 
 /**
@@ -16,40 +19,40 @@ package com.iluwatar.singleton;
  */
 public class App {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
+    /**
+     * 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();
-		System.out.println("ivoryTower1=" + ivoryTower1);
-		System.out.println("ivoryTower2=" + ivoryTower2);
+        // eagerly initialized singleton
+        IvoryTower ivoryTower1 = IvoryTower.getInstance();
+        IvoryTower ivoryTower2 = IvoryTower.getInstance();
+        System.out.println("ivoryTower1=" + ivoryTower1);
+        System.out.println("ivoryTower2=" + ivoryTower2);
 
-		// lazily initialized singleton
-		ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower
-				.getInstance();
-		ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower
-				.getInstance();
-		System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1);
-		System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2);
+        // lazily initialized singleton
+        ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower
+                .getInstance();
+        ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower
+                .getInstance();
+        System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1);
+        System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2);
 
-		// enum singleton
-		EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE;
-		EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE;
-		System.out.println("enumIvoryTower1=" + enumIvoryTower1);
-		System.out.println("enumIvoryTower2=" + enumIvoryTower2);
-		
-		InitializingOnDemandHolderIdiom demandHolderIdiom = InitializingOnDemandHolderIdiom.getInstance();
-		System.out.println(demandHolderIdiom);
-		InitializingOnDemandHolderIdiom demandHolderIdiom2 = InitializingOnDemandHolderIdiom.getInstance();
-		System.out.println(demandHolderIdiom2);
-		
-		ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance();
-		System.out.println(dcl1);
-		ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
-		System.out.println(dcl2);
-	}
+        // enum singleton
+        EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE;
+        EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE;
+        System.out.println("enumIvoryTower1=" + enumIvoryTower1);
+        System.out.println("enumIvoryTower2=" + enumIvoryTower2);
+
+        InitializingOnDemandHolderIdiom demandHolderIdiom = InitializingOnDemandHolderIdiom.getInstance();
+        System.out.println(demandHolderIdiom);
+        InitializingOnDemandHolderIdiom demandHolderIdiom2 = InitializingOnDemandHolderIdiom.getInstance();
+        System.out.println(demandHolderIdiom2);
+
+        ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance();
+        System.out.println(dcl1);
+        ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
+        System.out.println(dcl2);
+    }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
index 8f9895924..b2523a45f 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
@@ -1,13 +1,14 @@
+/**
+ * Enum Singleton class.
+ * Effective Java 2nd Edition (Joshua Bloch) p. 18
+ */
 package com.iluwatar.singleton;
 
 /**
- *
- * Enum Singleton class.
- * Effective Java 2nd Edition (Joshua Bloch) p. 18
- *
+ * Enum based singleton implementation.
  */
 public enum EnumIvoryTower {
-	
+
     INSTANCE;
 
     @Override
diff --git a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
index 4fd4c8163..423bc3242 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
@@ -1,36 +1,38 @@
+/**
+ * Singleton pattern.
+ */
 package com.iluwatar.singleton;
 
 import java.io.Serializable;
 
 /**
- * The Initialize-on-demand-holder idiom is a secure way of 
+ * The Initialize-on-demand-holder idiom is a secure way of
  * creating lazy initialized singleton object in Java.
  * refer to "The CERT Oracle Secure Coding Standard for Java"
  * By Dhruv Mohindra, Robert C. Seacord p.378
- * 
    
+ * 
    
  * Singleton objects usually are heavy to create and sometimes need to serialize them.
  * This class also shows how to preserve singleton in serialized version of singleton.
- * 
- * @author mortezaadi@gmail.com
  *
+ * @author mortezaadi@gmail.com
  */
-public class InitializingOnDemandHolderIdiom implements Serializable{
+public class InitializingOnDemandHolderIdiom implements Serializable {
 
-	private static final long serialVersionUID = 1L;
+    private static final long serialVersionUID = 1L;
 
-	private static class HelperHolder {
-		public static final InitializingOnDemandHolderIdiom INSTANCE = new InitializingOnDemandHolderIdiom();
-	}
+    private InitializingOnDemandHolderIdiom() {
+    }
 
-	public static InitializingOnDemandHolderIdiom getInstance() {
-		return HelperHolder.INSTANCE;
-	}
+    public static InitializingOnDemandHolderIdiom getInstance() {
+        return HelperHolder.INSTANCE;
+    }
 
-	private InitializingOnDemandHolderIdiom() {
-	}
+    protected Object readResolve() {
+        return getInstance();
+    }
 
-	protected Object readResolve() {
-		return getInstance();
-	}
+    private static class HelperHolder {
+        public static final InitializingOnDemandHolderIdiom INSTANCE = new InitializingOnDemandHolderIdiom();
+    }
 
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
index 5d418aa54..29f9e1b24 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
@@ -1,20 +1,33 @@
+/**
+ * Singleton pattern.
+ */
 package com.iluwatar.singleton;
 
 /**
- * 
  * Singleton class.
  * Eagerly initialized static instance guarantees thread
  * safety.
- * 
  */
-public class IvoryTower {
+public final class IvoryTower {
 
-	private static IvoryTower instance = new IvoryTower();
+    /**
+     * Static to class instance of the class.
+     */
+    private static IvoryTower instance = new IvoryTower();
 
-	private IvoryTower() {
-	}
+    /**
+     * Private constructor so nobody can instantiate the class.
+     */
+    private IvoryTower() {
+    }
 
-	public static IvoryTower getInstance() {
-		return instance;
-	}
+    /**
+     * To be called by user to
+     * obtain instance of the class.
+     *
+     * @return instance of the singleton.
+     */
+    public static IvoryTower getInstance() {
+        return instance;
+    }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
index d15509236..c0ac0b4c4 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
@@ -1,41 +1,43 @@
+/**
+ * Singleton pattern.
+ *
+ */
 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
  *
+ * @author mortezaadi@gmail.com
  */
 public 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 static ThreadSafeDoubleCheckLocking getInstance() {
-		//local variable increases performance by 25 percent 
-		//Joshua Bloch "Effective Java, Second Edition", p. 283-284
-		ThreadSafeDoubleCheckLocking result = INSTANCE;
-		if (result == null) {
-			synchronized (ThreadSafeDoubleCheckLocking.class) {
-				result = INSTANCE;
-				if (result == null) {
-					INSTANCE = result = new ThreadSafeDoubleCheckLocking();
-				}
-			}
-		}
-		return result;
-	}
+    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 static ThreadSafeDoubleCheckLocking getInstance() {
+        //local variable increases performance by 25 percent
+        //Joshua Bloch "Effective Java, Second Edition", p. 283-284
+        ThreadSafeDoubleCheckLocking result = INSTANCE;
+        if (result == null) {
+            synchronized (ThreadSafeDoubleCheckLocking.class) {
+                result = INSTANCE;
+                if (result == null) {
+                    INSTANCE = result = new ThreadSafeDoubleCheckLocking();
+                }
+            }
+        }
+        return result;
+    }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
index f7184cfb0..b1f9b81a3 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
@@ -1,28 +1,29 @@
+/**
+ * Singleton pattern.
+ */
 package com.iluwatar.singleton;
 
 /**
- *
  * Thread-safe Singleton class.
  * The instance is lazily initialized and thus needs synchronization
  * mechanism.
- *
  */
 public class ThreadSafeLazyLoadedIvoryTower {
 
-	private static ThreadSafeLazyLoadedIvoryTower instance = null;
-	
-	private ThreadSafeLazyLoadedIvoryTower() {
-	}
+    private static ThreadSafeLazyLoadedIvoryTower instance = null;
 
-	public synchronized static ThreadSafeLazyLoadedIvoryTower getInstance() {
-		/*
-		 * The instance gets created only when it is called for first time.
-		 * Lazy-loading
-		 */
-		if (instance == null) {
-			instance = new ThreadSafeLazyLoadedIvoryTower();
-		}
+    private ThreadSafeLazyLoadedIvoryTower() {
+    }
 
-		return instance;
-	}
+    public synchronized static ThreadSafeLazyLoadedIvoryTower getInstance() {
+        /*
+         * The instance gets created only when it is called for first time.
+         * Lazy-loading
+         */
+        if (instance == null) {
+            instance = new ThreadSafeLazyLoadedIvoryTower();
+        }
+
+        return instance;
+    }
 }

From ba6511fe5dd92179ffa323593bfe4c198653c30c Mon Sep 17 00:00:00 2001
From: Narendra Pathai 
Date: Thu, 24 Sep 2015 12:23:02 +0530
Subject: [PATCH 234/687] Work on #226, moved POSA reference and some J2EE
 design pattern references

---
 README.md                      | 2 --
 dao/index.md                   | 8 +++++++-
 front-controller/index.md      | 6 ++++++
 half-sync-half-async/index.md  | 1 +
 intercepting-filter/index.md   | 5 +++++
 layers/index.md                | 5 +++++
 model-view-controller/index.md | 2 ++
 model-view-presenter/index.md  | 4 ++++
 reactor/index.md               | 1 +
 service-layer/index.md         | 1 +
 service-locator/index.md       | 6 +++++-
 11 files changed, 37 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 77282f569..255fca0f2 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,6 @@ If you are willing to contribute to the project you will find the relevant infor
 
 # 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 Generics and Collections](http://www.amazon.com/Java-Generics-Collections-Maurice-Naftalin/dp/0596527756/)
 * [Let's Modify the Objects-First Approach into Design-Patterns-First](http://edu.pecinovsky.cz/papers/2006_ITiCSE_Design_Patterns_First.pdf)
@@ -48,7 +47,6 @@ If you are willing to contribute to the project you will find the relevant infor
 * [Patterns of Enterprise Application Architecture](http://www.amazon.com/Patterns-Enterprise-Application-Architecture-Martin/dp/0321127420)
 * [Spring Data](http://www.amazon.com/Spring-Data-Mark-Pollack/dp/1449323952/ref=sr_1_1)
 * [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2)
-* [Pattern Oriented Software Architecture Vol I-V](http://www.amazon.com/Pattern-Oriented-Software-Architecture-Volume-Patterns/dp/0471958697)
 
 # License
 
diff --git a/dao/index.md b/dao/index.md
index 7fd936c12..cf9f43a68 100644
--- a/dao/index.md
+++ b/dao/index.md
@@ -4,7 +4,9 @@ title: Data Access Object
 folder: dao
 permalink: /patterns/dao/
 categories: Architectural
-tags: Java
+tags:
+ - Java
+ - Difficulty-Beginner
 ---
 
 **Intent:** Object provides an abstract interface to some type of database or
@@ -16,3 +18,7 @@ other persistence mechanism.
 
 * 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)
diff --git a/front-controller/index.md b/front-controller/index.md
index dd83bc396..ba593a157 100644
--- a/front-controller/index.md
+++ b/front-controller/index.md
@@ -22,3 +22,9 @@ internationalization, routing and logging in a single place.
 **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)
diff --git a/half-sync-half-async/index.md b/half-sync-half-async/index.md
index 0ea0254b8..dc1930e3b 100644
--- a/half-sync-half-async/index.md
+++ b/half-sync-half-async/index.md
@@ -30,3 +30,4 @@ degrading execution efficiency.
 **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)
diff --git a/intercepting-filter/index.md b/intercepting-filter/index.md
index 9625e445d..41825745b 100644
--- a/intercepting-filter/index.md
+++ b/intercepting-filter/index.md
@@ -18,6 +18,11 @@ post-processing to requests from a client to a target
 * 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:**
+
+* [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)
diff --git a/layers/index.md b/layers/index.md
index 1d12d3b4e..37089a19c 100644
--- a/layers/index.md
+++ b/layers/index.md
@@ -17,3 +17,8 @@ tags: Java
 * 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)
+
diff --git a/model-view-controller/index.md b/model-view-controller/index.md
index f96daf243..1ba1089c0 100644
--- a/model-view-controller/index.md
+++ b/model-view-controller/index.md
@@ -21,3 +21,5 @@ display.
 **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)
diff --git a/model-view-presenter/index.md b/model-view-presenter/index.md
index 609c59c13..b51268013 100644
--- a/model-view-presenter/index.md
+++ b/model-view-presenter/index.md
@@ -17,3 +17,7 @@ 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)
diff --git a/reactor/index.md b/reactor/index.md
index 7333c74dd..6e20598d2 100644
--- a/reactor/index.md
+++ b/reactor/index.md
@@ -26,5 +26,6 @@ tags:
 **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/)
diff --git a/service-layer/index.md b/service-layer/index.md
index f9e7ac1cb..ea3f3d0ba 100644
--- a/service-layer/index.md
+++ b/service-layer/index.md
@@ -24,3 +24,4 @@ its business logic. The Service Layer fulfills this role.
 **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)
diff --git a/service-locator/index.md b/service-locator/index.md
index 8c2aa6417..03c432749 100644
--- a/service-locator/index.md
+++ b/service-locator/index.md
@@ -10,7 +10,7 @@ tags: Java
 **Intent:** Encapsulate the processes involved in obtaining a service with a
 strong abstraction layer.
 
-![alt text](./etc/service-locator.png "Proxy")
+![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
@@ -26,3 +26,7 @@ improves the performance of application to great extent.
 * when network hits are expensive and time consuming
 * lookups of services are done quite frequently
 * large number of services are being used
+
+**Credits:**
+
+* [J2EE Design Patterns](http://www.amazon.com/J2EE-Design-Patterns-William-Crawford/dp/0596004273/ref=sr_1_2)

From 60f9b7127819e383edd374fe3b80b79f7ee994a9 Mon Sep 17 00:00:00 2001
From: zafarella 
Date: Thu, 24 Sep 2015 13:29:39 -0400
Subject: [PATCH 235/687] eliminate all warnings of checkstyle.

---
 .../main/java/com/iluwatar/singleton/App.java | 85 ++++++++++---------
 .../iluwatar/singleton/EnumIvoryTower.java    | 15 ++--
 .../InitializingOnDemandHolderIdiom.java      | 28 +++---
 .../com/iluwatar/singleton/IvoryTower.java    | 39 ++++-----
 .../ThreadSafeDoubleCheckLocking.java         | 48 ++++++-----
 .../ThreadSafeLazyLoadedIvoryTower.java       | 30 +++----
 6 files changed, 121 insertions(+), 124 deletions(-)

diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index e8a3a1571..11cb4daa6 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -1,58 +1,63 @@
 /**
  * Singleton pattern.
  */
+
 package com.iluwatar.singleton;
 
 /**
- *
  * Singleton pattern ensures that the class ({@link IvoryTower}) can have only one
- * existing instance per Java classloader instance and provides global access to it. 
- * 
    
+ * existing instance per Java classloader instance and provides global access to it.
+ * 
    
  * http://stackoverflow.com/questions/70689/what-is-an-efficient-way-to-implement-a-singleton-pattern-in-java
- *
    
- * The risk 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.
- * 
    
+ * 
    
+ * The risk 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.
+ * 
    
  * http://stackoverflow.com/questions/17721263/singleton-across-jvm-or-application-instance-or-tomcat-instance
  */
 public class App {
 
-    /**
-     * Program entry point
-     * @param args command line args
-     */
-    public static void main(String[] args) {
+  /**
+   * 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();
-        System.out.println("ivoryTower1=" + ivoryTower1);
-        System.out.println("ivoryTower2=" + ivoryTower2);
+    // eagerly initialized singleton
+    IvoryTower ivoryTower1 = IvoryTower.getInstance();
+    IvoryTower ivoryTower2 = IvoryTower.getInstance();
+    System.out.println("ivoryTower1=" + ivoryTower1);
+    System.out.println("ivoryTower2=" + ivoryTower2);
 
-        // lazily initialized singleton
-        ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower
-                .getInstance();
-        ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower
-                .getInstance();
-        System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1);
-        System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2);
+    // lazily initialized singleton
+    ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower
+            .getInstance();
+    ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower
+            .getInstance();
+    System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1);
+    System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2);
 
-        // enum singleton
-        EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE;
-        EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE;
-        System.out.println("enumIvoryTower1=" + enumIvoryTower1);
-        System.out.println("enumIvoryTower2=" + enumIvoryTower2);
+    // enum singleton
+    EnumIvoryTower enumIvoryTower1 = EnumIvoryTower.INSTANCE;
+    EnumIvoryTower enumIvoryTower2 = EnumIvoryTower.INSTANCE;
+    System.out.println("enumIvoryTower1=" + enumIvoryTower1);
+    System.out.println("enumIvoryTower2=" + enumIvoryTower2);
 
-        InitializingOnDemandHolderIdiom demandHolderIdiom = InitializingOnDemandHolderIdiom.getInstance();
-        System.out.println(demandHolderIdiom);
-        InitializingOnDemandHolderIdiom demandHolderIdiom2 = InitializingOnDemandHolderIdiom.getInstance();
-        System.out.println(demandHolderIdiom2);
+    InitializingOnDemandHolderIdiom demandHolderIdiom =
+            InitializingOnDemandHolderIdiom.getInstance();
+    System.out.println(demandHolderIdiom);
+    InitializingOnDemandHolderIdiom demandHolderIdiom2 =
+            InitializingOnDemandHolderIdiom.getInstance();
+    System.out.println(demandHolderIdiom2);
 
-        ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance();
-        System.out.println(dcl1);
-        ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
-        System.out.println(dcl2);
-    }
+    ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance();
+    System.out.println(dcl1);
+    ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
+    System.out.println(dcl2);
+  }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
index b2523a45f..f39babe45 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
@@ -1,18 +1,15 @@
-/**
- * Enum Singleton class.
- * Effective Java 2nd Edition (Joshua Bloch) p. 18
- */
 package com.iluwatar.singleton;
 
 /**
  * Enum based singleton implementation.
+ * Effective Java 2nd Edition (Joshua Bloch) p. 18
  */
 public enum EnumIvoryTower {
 
-    INSTANCE;
+  INSTANCE;
 
-    @Override
-    public String toString() {
-        return getDeclaringClass().getCanonicalName() + "@" + hashCode();
-    }
+  @Override
+  public String toString() {
+    return getDeclaringClass().getCanonicalName() + "@" + hashCode();
+  }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
index 423bc3242..88738b8ca 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
@@ -1,6 +1,3 @@
-/**
- * Singleton pattern.
- */
 package com.iluwatar.singleton;
 
 import java.io.Serializable;
@@ -18,21 +15,22 @@ import java.io.Serializable;
  */
 public class InitializingOnDemandHolderIdiom implements Serializable {
 
-    private static final long serialVersionUID = 1L;
+  private static final long serialVersionUID = 1L;
 
-    private InitializingOnDemandHolderIdiom() {
-    }
+  private InitializingOnDemandHolderIdiom() {
+  }
 
-    public static InitializingOnDemandHolderIdiom getInstance() {
-        return HelperHolder.INSTANCE;
-    }
+  public static InitializingOnDemandHolderIdiom getInstance() {
+    return HelperHolder.INSTANCE;
+  }
 
-    protected Object readResolve() {
-        return getInstance();
-    }
+  protected Object readResolve() {
+    return getInstance();
+  }
 
-    private static class HelperHolder {
-        public static final InitializingOnDemandHolderIdiom INSTANCE = new InitializingOnDemandHolderIdiom();
-    }
+  private static class HelperHolder {
+    public static final InitializingOnDemandHolderIdiom INSTANCE =
+            new InitializingOnDemandHolderIdiom();
+  }
 
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
index 29f9e1b24..96809c477 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
@@ -1,6 +1,3 @@
-/**
- * Singleton pattern.
- */
 package com.iluwatar.singleton;
 
 /**
@@ -10,24 +7,24 @@ package com.iluwatar.singleton;
  */
 public final class IvoryTower {
 
-    /**
-     * Static to class instance of the class.
-     */
-    private static IvoryTower instance = new IvoryTower();
+  /**
+   * Static to class instance of the class.
+   */
+  private static IvoryTower instance = new IvoryTower();
 
-    /**
-     * Private constructor so nobody can instantiate the class.
-     */
-    private IvoryTower() {
-    }
+  /**
+   * Private constructor so nobody can instantiate the class.
+   */
+  private IvoryTower() {
+  }
 
-    /**
-     * To be called by user to
-     * obtain instance of the class.
-     *
-     * @return instance of the singleton.
-     */
-    public static IvoryTower getInstance() {
-        return instance;
-    }
+  /**
+   * To be called by user to
+   * obtain instance of the class.
+   *
+   * @return instance of the singleton.
+   */
+  public static IvoryTower getInstance() {
+    return instance;
+  }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
index c0ac0b4c4..26b57d4cf 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
@@ -1,7 +1,3 @@
-/**
- * Singleton pattern.
- *
- */
 package com.iluwatar.singleton;
 
 /**
@@ -15,29 +11,35 @@ package com.iluwatar.singleton;
  */
 public class ThreadSafeDoubleCheckLocking {
 
-    private static volatile ThreadSafeDoubleCheckLocking INSTANCE;
+  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.");
+  /**
+   * private constructor to prevent client from instantiating.
+   */
+  private ThreadSafeDoubleCheckLocking() {
+    //to prevent instantiating by Reflection call
+    if (INSTANCE != null) {
+      throw new IllegalStateException("Already initialized.");
     }
+  }
 
-    public static ThreadSafeDoubleCheckLocking getInstance() {
-        //local variable increases performance by 25 percent
-        //Joshua Bloch "Effective Java, Second Edition", p. 283-284
-        ThreadSafeDoubleCheckLocking result = INSTANCE;
+  /**
+   * 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;
+    if (result == null) {
+      synchronized (ThreadSafeDoubleCheckLocking.class) {
+        result = INSTANCE;
         if (result == null) {
-            synchronized (ThreadSafeDoubleCheckLocking.class) {
-                result = INSTANCE;
-                if (result == null) {
-                    INSTANCE = result = new ThreadSafeDoubleCheckLocking();
-                }
-            }
+          INSTANCE = result = new ThreadSafeDoubleCheckLocking();
         }
-        return result;
+      }
     }
+    return result;
+  }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
index b1f9b81a3..f9b62e798 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
@@ -1,6 +1,3 @@
-/**
- * Singleton pattern.
- */
 package com.iluwatar.singleton;
 
 /**
@@ -10,20 +7,21 @@ package com.iluwatar.singleton;
  */
 public class ThreadSafeLazyLoadedIvoryTower {
 
-    private static ThreadSafeLazyLoadedIvoryTower instance = null;
+  private static ThreadSafeLazyLoadedIvoryTower instance = null;
 
-    private ThreadSafeLazyLoadedIvoryTower() {
+  private ThreadSafeLazyLoadedIvoryTower() {
+  }
+
+  /**
+   * The instance gets created only when it is called for first time.
+   * Lazy-loading
+   */
+  public synchronized static ThreadSafeLazyLoadedIvoryTower getInstance() {
+
+    if (instance == null) {
+      instance = new ThreadSafeLazyLoadedIvoryTower();
     }
 
-    public synchronized static ThreadSafeLazyLoadedIvoryTower getInstance() {
-        /*
-         * The instance gets created only when it is called for first time.
-         * Lazy-loading
-         */
-        if (instance == null) {
-            instance = new ThreadSafeLazyLoadedIvoryTower();
-        }
-
-        return instance;
-    }
+    return instance;
+  }
 }

From e077aa34d74bbb8040f8b8a8100a5beae4a328a3 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 26 Sep 2015 20:19:39 +0300
Subject: [PATCH 236/687] Travis deploy web site to S3

---
 .travis.yml | 32 +++++++++++++++++++++-----------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index a59370c30..59711b779 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,20 +1,30 @@
 language: java
-
 jdk:
-  - oraclejdk8
+- oraclejdk8
 
 env:
   global:
   - GH_REF: github.com/iluwatar/java-design-patterns.git
-  - secure: "LxTDuNS/rBWIvKkaEqr79ImZAe48mCdoYCF41coxNXgNoippo4GIBArknqtv+XvdkiuRZ1yGyj6pn8GU33c/yn+krddTUkVCwTbVatbalW5jhQjDbHYym/JcxaK9ZS/3JTeGcWrBgiPqHEEDhCf26vPZsXoMSeVCEORVKTp1BSg="
-
-before_install:
-  - "export DISPLAY=:99.0"
-  - "sh -e /etc/init.d/xvfb start"
+  - secure: LxTDuNS/rBWIvKkaEqr79ImZAe48mCdoYCF41coxNXgNoippo4GIBArknqtv+XvdkiuRZ1yGyj6pn8GU33c/yn+krddTUkVCwTbVatbalW5jhQjDbHYym/JcxaK9ZS/3JTeGcWrBgiPqHEEDhCf26vPZsXoMSeVCEORVKTp1BSg=
   
-after_success:
-  - mvn clean test jacoco:report coveralls:report
-  - bash update-ghpages.sh
+before_install:
+- export DISPLAY=:99.0
+- sh -e /etc/init.d/xvfb start
+
+after_success:
+- mvn clean test jacoco:report coveralls:report
+- bash update-ghpages.sh
 
-# Migration to container-based infrastructure  
 sudo: false
+
+deploy:
+  provider: s3
+  access_key_id: AKIAJVPJZO7743HVSDHA
+  secret_access_key:
+    secure: aYaEhSd6/8SV/gvsn/22iOoyWrQtjKX7VHUoNTX16Mw6flYy29BE+/ZOL1CTL5EXEZsC1zyqCi7RoM6QUXk9DYVg4Lc5yTIwaM0evd3obzPeGQVCR9JRAqM9KGKwyW19oEkNxwEE/pKNDLCfkctMZ4bcwDhkIdsMSAVzKDzq+Yw=
+  bucket: java-design-patterns
+  local-dir: _site
+  acl: public_read_write
+  on:
+    repo: iluwatar/java-design-patterns
+    branch: gh-pages
\ No newline at end of file

From 2ad361f2c36ca4ab9dcc99260a3e46864d2f0acb Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 26 Sep 2015 21:23:00 +0300
Subject: [PATCH 237/687] Travis configuration changes #255

---
 .travis.yml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 59711b779..27076f08c 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -21,10 +21,9 @@ deploy:
   provider: s3
   access_key_id: AKIAJVPJZO7743HVSDHA
   secret_access_key:
-    secure: aYaEhSd6/8SV/gvsn/22iOoyWrQtjKX7VHUoNTX16Mw6flYy29BE+/ZOL1CTL5EXEZsC1zyqCi7RoM6QUXk9DYVg4Lc5yTIwaM0evd3obzPeGQVCR9JRAqM9KGKwyW19oEkNxwEE/pKNDLCfkctMZ4bcwDhkIdsMSAVzKDzq+Yw=
-  bucket: java-design-patterns
+    secure: iHjLIy+dHku1o8PrjGhz1mMfM971nqmpjo2mzVNYqYrxlB8zoAqwlz9LoFJcUAKbxhHLJT/LgtYYj+uBspUMOITejaiyCDcM8edGwSXKJu+g+Fp0PVGZQXGziGInmUVT9b2lpAV8Nn2sRpAHgHrM9fKaAU3epG5LfVkQxSkGZp0=
+  bucket: java-design-patterns.com
   local-dir: _site
-  acl: public_read_write
+  acl: public_read
   on:
-    repo: iluwatar/java-design-patterns
-    branch: gh-pages
\ No newline at end of file
+    branch: gh-pages

From 793b1cc17212497a589eb7f65e453814ec9fcad2 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 26 Sep 2015 22:08:23 +0300
Subject: [PATCH 238/687] Travis configuration changes #255

---
 .travis.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 27076f08c..2f18b64d2 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -25,5 +25,6 @@ deploy:
   bucket: java-design-patterns.com
   local-dir: _site
   acl: public_read
+  skip_cleanup: true
   on:
-    branch: gh-pages
+    branch: **

From 83fed6dd34759bc0870e7c11086ccf2f214be1e4 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 26 Sep 2015 22:14:36 +0300
Subject: [PATCH 239/687] Fix Travis config syntax #255

---
 .travis.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.travis.yml b/.travis.yml
index 2f18b64d2..686eeae8d 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -27,4 +27,4 @@ deploy:
   acl: public_read
   skip_cleanup: true
   on:
-    branch: **
+    all_branches: true

From 621c3498f685f490e149cffe1f1a9a93cd3ac488 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 26 Sep 2015 22:52:59 +0300
Subject: [PATCH 240/687] Remove broken deploy config #255

---
 .travis.yml | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/.travis.yml b/.travis.yml
index 686eeae8d..60693c5cc 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -16,15 +16,3 @@ after_success:
 - bash update-ghpages.sh
 
 sudo: false
-
-deploy:
-  provider: s3
-  access_key_id: AKIAJVPJZO7743HVSDHA
-  secret_access_key:
-    secure: iHjLIy+dHku1o8PrjGhz1mMfM971nqmpjo2mzVNYqYrxlB8zoAqwlz9LoFJcUAKbxhHLJT/LgtYYj+uBspUMOITejaiyCDcM8edGwSXKJu+g+Fp0PVGZQXGziGInmUVT9b2lpAV8Nn2sRpAHgHrM9fKaAU3epG5LfVkQxSkGZp0=
-  bucket: java-design-patterns.com
-  local-dir: _site
-  acl: public_read
-  skip_cleanup: true
-  on:
-    all_branches: true

From 11cdd20f6fd5fd48360336a7709009b667202359 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Wed, 30 Sep 2015 22:36:01 +0300
Subject: [PATCH 241/687] Update version to 1.7.0

---
 abstract-factory/pom.xml                       | 2 +-
 adapter/pom.xml                                | 2 +-
 async-method-invocation/pom.xml                | 2 +-
 bridge/pom.xml                                 | 2 +-
 builder/pom.xml                                | 2 +-
 business-delegate/pom.xml                      | 2 +-
 callback/pom.xml                               | 2 +-
 chain/pom.xml                                  | 2 +-
 command/pom.xml                                | 2 +-
 composite/pom.xml                              | 2 +-
 dao/pom.xml                                    | 2 +-
 decorator/pom.xml                              | 2 +-
 dependency-injection/pom.xml                   | 2 +-
 double-checked-locking/pom.xml                 | 2 +-
 double-dispatch/pom.xml                        | 2 +-
 event-aggregator/pom.xml                       | 2 +-
 execute-around/pom.xml                         | 2 +-
 facade/pom.xml                                 | 2 +-
 factory-method/pom.xml                         | 2 +-
 fluentinterface/pom.xml                        | 2 +-
 flux/pom.xml                                   | 2 +-
 flyweight/pom.xml                              | 2 +-
 front-controller/pom.xml                       | 2 +-
 half-sync-half-async/pom.xml                   | 2 +-
 intercepting-filter/pom.xml                    | 2 +-
 interpreter/pom.xml                            | 2 +-
 iterator/pom.xml                               | 2 +-
 layers/pom.xml                                 | 2 +-
 lazy-loading/pom.xml                           | 2 +-
 mediator/pom.xml                               | 2 +-
 memento/pom.xml                                | 2 +-
 message-channel/pom.xml                        | 2 +-
 model-view-controller/pom.xml                  | 2 +-
 model-view-presenter/pom.xml                   | 2 +-
 multiton/pom.xml                               | 2 +-
 naked-objects/dom/pom.xml                      | 2 +-
 naked-objects/fixture/pom.xml                  | 2 +-
 naked-objects/integtests/pom.xml               | 2 +-
 naked-objects/pom.xml                          | 8 ++++----
 naked-objects/webapp/pom.xml                   | 2 +-
 null-object/pom.xml                            | 2 +-
 object-pool/pom.xml                            | 2 +-
 observer/pom.xml                               | 2 +-
 poison-pill/pom.xml                            | 2 +-
 pom.xml                                        | 2 +-
 private-class-data/pom.xml                     | 2 +-
 property/pom.xml                               | 2 +-
 prototype/pom.xml                              | 2 +-
 proxy/pom.xml                                  | 2 +-
 reactor/pom.xml                                | 2 +-
 repository/pom.xml                             | 2 +-
 resource-acquisition-is-initialization/pom.xml | 2 +-
 servant/pom.xml                                | 2 +-
 service-layer/pom.xml                          | 2 +-
 service-locator/pom.xml                        | 2 +-
 singleton/pom.xml                              | 2 +-
 specification/pom.xml                          | 2 +-
 state/pom.xml                                  | 2 +-
 step-builder/pom.xml                           | 2 +-
 strategy/pom.xml                               | 2 +-
 template-method/pom.xml                        | 2 +-
 thread-pool/pom.xml                            | 2 +-
 tolerant-reader/pom.xml                        | 2 +-
 visitor/pom.xml                                | 2 +-
 64 files changed, 67 insertions(+), 67 deletions(-)

diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index ddb7e7b9d..bb9df6bc9 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   abstract-factory
   
diff --git a/adapter/pom.xml b/adapter/pom.xml
index 74a58de92..d07d26b94 100644
--- a/adapter/pom.xml
+++ b/adapter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   adapter
   
diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml
index 2a5010b74..d5e0e2b3e 100644
--- a/async-method-invocation/pom.xml
+++ b/async-method-invocation/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   async-method-invocation
   
diff --git a/bridge/pom.xml b/bridge/pom.xml
index 947fa2c60..533074d72 100644
--- a/bridge/pom.xml
+++ b/bridge/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   bridge
   
diff --git a/builder/pom.xml b/builder/pom.xml
index 65997c9e6..effc18f0c 100644
--- a/builder/pom.xml
+++ b/builder/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   builder
   
diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml
index 482d59fab..84ae64a17 100644
--- a/business-delegate/pom.xml
+++ b/business-delegate/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.6.0
+		1.7.0
 	
 	business-delegate
 	
diff --git a/callback/pom.xml b/callback/pom.xml
index f8cf6babf..7e66f6e2b 100644
--- a/callback/pom.xml
+++ b/callback/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   callback
   
diff --git a/chain/pom.xml b/chain/pom.xml
index ebae620d6..80591a477 100644
--- a/chain/pom.xml
+++ b/chain/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   chain
   
diff --git a/command/pom.xml b/command/pom.xml
index 401acba32..22f1c256b 100644
--- a/command/pom.xml
+++ b/command/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   command
   
diff --git a/composite/pom.xml b/composite/pom.xml
index ca4daaaad..2b8298647 100644
--- a/composite/pom.xml
+++ b/composite/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   composite
   
diff --git a/dao/pom.xml b/dao/pom.xml
index a7a5c74ca..0361f3c9b 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   dao
   
diff --git a/decorator/pom.xml b/decorator/pom.xml
index 57946b711..92142f184 100644
--- a/decorator/pom.xml
+++ b/decorator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   decorator
   
diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml
index a6780cb20..9a28933f8 100644
--- a/dependency-injection/pom.xml
+++ b/dependency-injection/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   dependency-injection
   
diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
index 46d4a70f0..6f1fe93eb 100644
--- a/double-checked-locking/pom.xml
+++ b/double-checked-locking/pom.xml
@@ -3,7 +3,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   double-checked-locking
   
diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml
index 5f16635f6..057d75e8e 100644
--- a/double-dispatch/pom.xml
+++ b/double-dispatch/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   double-dispatch
   
diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml
index 1c9a3b626..4e7f1b55b 100644
--- a/event-aggregator/pom.xml
+++ b/event-aggregator/pom.xml
@@ -4,7 +4,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.6.0
+		1.7.0
 	
 	event-aggregator
 	
diff --git a/execute-around/pom.xml b/execute-around/pom.xml
index 7d806337b..c6a7785aa 100644
--- a/execute-around/pom.xml
+++ b/execute-around/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   execute-around
   
diff --git a/facade/pom.xml b/facade/pom.xml
index 17d3d707c..cea5bf0c3 100644
--- a/facade/pom.xml
+++ b/facade/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   facade
   
diff --git a/factory-method/pom.xml b/factory-method/pom.xml
index 81072a4f9..39e0b7b4e 100644
--- a/factory-method/pom.xml
+++ b/factory-method/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   factory-method
   
diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
index be8ab8039..16e237bd5 100644
--- a/fluentinterface/pom.xml
+++ b/fluentinterface/pom.xml
@@ -5,7 +5,7 @@
     
         java-design-patterns
         com.iluwatar
-        1.6.0
+        1.7.0
     
     4.0.0
 
diff --git a/flux/pom.xml b/flux/pom.xml
index 3efccbfa4..f706b49ed 100644
--- a/flux/pom.xml
+++ b/flux/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   flux
   
diff --git a/flyweight/pom.xml b/flyweight/pom.xml
index 54ca5bef2..7c0f3e2b0 100644
--- a/flyweight/pom.xml
+++ b/flyweight/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   flyweight
   
diff --git a/front-controller/pom.xml b/front-controller/pom.xml
index a554186f3..c80121df2 100644
--- a/front-controller/pom.xml
+++ b/front-controller/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.6.0
+		1.7.0
 	
 	front-controller
 	
diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml
index 94c12d797..e7436d29f 100644
--- a/half-sync-half-async/pom.xml
+++ b/half-sync-half-async/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   half-sync-half-async
   
diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml
index 35ebd9f59..230f76ca3 100644
--- a/intercepting-filter/pom.xml
+++ b/intercepting-filter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   intercepting-filter
   
diff --git a/interpreter/pom.xml b/interpreter/pom.xml
index 8583464d3..8a536748c 100644
--- a/interpreter/pom.xml
+++ b/interpreter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   interpreter
   
diff --git a/iterator/pom.xml b/iterator/pom.xml
index da5040dce..22e574ba5 100644
--- a/iterator/pom.xml
+++ b/iterator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   iterator
   
diff --git a/layers/pom.xml b/layers/pom.xml
index de672a3df..5d3fd778c 100644
--- a/layers/pom.xml
+++ b/layers/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.6.0
+		1.7.0
 	
 	com.iluwatar.layers
 	layers
diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml
index b795abf87..61da2f3b5 100644
--- a/lazy-loading/pom.xml
+++ b/lazy-loading/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   lazy-loading
   
diff --git a/mediator/pom.xml b/mediator/pom.xml
index 5a9c00042..1e325bb8f 100644
--- a/mediator/pom.xml
+++ b/mediator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   mediator
   
diff --git a/memento/pom.xml b/memento/pom.xml
index 182a46204..98d1d4a9f 100644
--- a/memento/pom.xml
+++ b/memento/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   memento
   
diff --git a/message-channel/pom.xml b/message-channel/pom.xml
index ef66f2401..ee7d54c95 100644
--- a/message-channel/pom.xml
+++ b/message-channel/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.6.0
+		1.7.0
 	
 	message-channel
 	
diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml
index 7162c71d9..8c9c07809 100644
--- a/model-view-controller/pom.xml
+++ b/model-view-controller/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   model-view-controller
   
diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml
index 41a2d2013..4f2d320ba 100644
--- a/model-view-presenter/pom.xml
+++ b/model-view-presenter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   model-view-presenter
   model-view-presenter
diff --git a/multiton/pom.xml b/multiton/pom.xml
index 6ea1ad2fa..9735bc8ea 100644
--- a/multiton/pom.xml
+++ b/multiton/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   multiton
   
diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml
index cadf6d82e..b0efdb435 100644
--- a/naked-objects/dom/pom.xml
+++ b/naked-objects/dom/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.6.0
+		1.7.0
 	
 
 	naked-objects-dom
diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml
index 33cd798f7..bbed2fe1b 100644
--- a/naked-objects/fixture/pom.xml
+++ b/naked-objects/fixture/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.6.0
+		1.7.0
 	
 
 	naked-objects-fixture
diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml
index 1fd518bb1..221b072e5 100644
--- a/naked-objects/integtests/pom.xml
+++ b/naked-objects/integtests/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.6.0
+		1.7.0
 	
 
 	naked-objects-integtests
diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml
index c9387b58d..067d4a5a8 100644
--- a/naked-objects/pom.xml
+++ b/naked-objects/pom.xml
@@ -15,7 +15,7 @@
 	
 		java-design-patterns
 		com.iluwatar
-		1.6.0
+		1.7.0
 	
 
 	naked-objects
@@ -350,17 +350,17 @@
 			
 				${project.groupId}
 				naked-objects-dom
-				1.6.0
+				1.7.0
 			
 			
 				${project.groupId}
 				naked-objects-fixture
-				1.6.0
+				1.7.0
 			
 			
 				${project.groupId}
 				naked-objects-webapp
-				1.6.0
+				1.7.0
 			
 
 		
diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml
index 3e018995a..bc7d7c299 100644
--- a/naked-objects/webapp/pom.xml
+++ b/naked-objects/webapp/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.6.0
+		1.7.0
 	
 
 	naked-objects-webapp
diff --git a/null-object/pom.xml b/null-object/pom.xml
index eec32fd4d..a372851ed 100644
--- a/null-object/pom.xml
+++ b/null-object/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   null-object
   
diff --git a/object-pool/pom.xml b/object-pool/pom.xml
index 4a3b237c6..528e3db16 100644
--- a/object-pool/pom.xml
+++ b/object-pool/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   object-pool
   
diff --git a/observer/pom.xml b/observer/pom.xml
index 19e93421c..023d93bea 100644
--- a/observer/pom.xml
+++ b/observer/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   observer
   
diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml
index 2a0653981..06d9f34de 100644
--- a/poison-pill/pom.xml
+++ b/poison-pill/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   poison-pill
   
diff --git a/pom.xml b/pom.xml
index 2da35eb46..3064f3c0d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
 
 	com.iluwatar
 	java-design-patterns
-	1.6.0
+	1.7.0
 	pom
 
 	
diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml
index 70a716062..274739257 100644
--- a/private-class-data/pom.xml
+++ b/private-class-data/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   private-class-data
   
diff --git a/property/pom.xml b/property/pom.xml
index 5435f06f5..f32a4008e 100644
--- a/property/pom.xml
+++ b/property/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   property
   
diff --git a/prototype/pom.xml b/prototype/pom.xml
index 0ebba706e..d5772da60 100644
--- a/prototype/pom.xml
+++ b/prototype/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   prototype
   
diff --git a/proxy/pom.xml b/proxy/pom.xml
index 1f625d736..750c12b84 100644
--- a/proxy/pom.xml
+++ b/proxy/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   proxy
   
diff --git a/reactor/pom.xml b/reactor/pom.xml
index 599376e32..516a4b93c 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   reactor
   
diff --git a/repository/pom.xml b/repository/pom.xml
index db0a8af5f..70f2ff6b2 100644
--- a/repository/pom.xml
+++ b/repository/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.6.0
+		1.7.0
 	
 	repository
 	
diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml
index c8382ceb8..a16eae745 100644
--- a/resource-acquisition-is-initialization/pom.xml
+++ b/resource-acquisition-is-initialization/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   resource-acquisition-is-initialization
   
diff --git a/servant/pom.xml b/servant/pom.xml
index b6497215f..1928f83c9 100644
--- a/servant/pom.xml
+++ b/servant/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   servant
   
diff --git a/service-layer/pom.xml b/service-layer/pom.xml
index 8e0ea8322..a42d07c5e 100644
--- a/service-layer/pom.xml
+++ b/service-layer/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   service-layer
   
diff --git a/service-locator/pom.xml b/service-locator/pom.xml
index a596e4b0c..f210c74b6 100644
--- a/service-locator/pom.xml
+++ b/service-locator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   service-locator
   
diff --git a/singleton/pom.xml b/singleton/pom.xml
index cdd9b613a..ab118a1c3 100644
--- a/singleton/pom.xml
+++ b/singleton/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   singleton
   
diff --git a/specification/pom.xml b/specification/pom.xml
index b4d6efe90..3c58aa29f 100644
--- a/specification/pom.xml
+++ b/specification/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   specification
   
diff --git a/state/pom.xml b/state/pom.xml
index 0119146b3..2d87a796a 100644
--- a/state/pom.xml
+++ b/state/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   state
   
diff --git a/step-builder/pom.xml b/step-builder/pom.xml
index f9c98474b..7c7e8ac69 100644
--- a/step-builder/pom.xml
+++ b/step-builder/pom.xml
@@ -6,7 +6,7 @@
   
     java-design-patterns
     com.iluwatar
-    1.6.0
+    1.7.0
   
   step-builder
   
diff --git a/strategy/pom.xml b/strategy/pom.xml
index 9532a8079..0b71652ba 100644
--- a/strategy/pom.xml
+++ b/strategy/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   strategy
   
diff --git a/template-method/pom.xml b/template-method/pom.xml
index 53a7dc56e..4aa776591 100644
--- a/template-method/pom.xml
+++ b/template-method/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   template-method
   
diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml
index 42e54de7e..e335b06e5 100644
--- a/thread-pool/pom.xml
+++ b/thread-pool/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   thread-pool
   
diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml
index 7e852d4ee..086251772 100644
--- a/tolerant-reader/pom.xml
+++ b/tolerant-reader/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   tolerant-reader
   
diff --git a/visitor/pom.xml b/visitor/pom.xml
index 8adda4855..ca5f72be8 100644
--- a/visitor/pom.xml
+++ b/visitor/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   visitor
   

From 6413c4d2be13a0376904ea2690caa8ff899b89ed Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Fri, 2 Oct 2015 22:53:41 +0300
Subject: [PATCH 242/687] Added more Singleton documentation #188

---
 .../main/java/com/iluwatar/singleton/App.java | 44 ++++++++++++-------
 .../com/iluwatar/singleton/IvoryTower.java    |  2 +-
 2 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index 11cb4daa6..7566c9c4d 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -1,23 +1,35 @@
-/**
- * Singleton pattern.
- */
-
 package com.iluwatar.singleton;
 
 /**
- * Singleton pattern ensures that the class ({@link IvoryTower}) can have only one
- * existing instance per Java classloader instance and provides global access to it.
+ * Singleton pattern ensures that the class can have only one existing instance per Java classloader instance 
+ * and provides global access to it.
  * 
    
- * http://stackoverflow.com/questions/70689/what-is-an-efficient-way-to-implement-a-singleton-pattern-in-java
- * 
    
- * The risk of this pattern is that bugs resulting from setting a singleton up in
+ * 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.
  * 
    
- * http://stackoverflow.com/questions/17721263/singleton-across-jvm-or-application-instance-or-tomcat-instance
+ * 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 {
 
@@ -48,16 +60,18 @@ public class App {
     System.out.println("enumIvoryTower1=" + enumIvoryTower1);
     System.out.println("enumIvoryTower2=" + enumIvoryTower2);
 
+    // double checked locking
+    ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance();
+    System.out.println(dcl1);
+    ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
+    System.out.println(dcl2);
+    
+    // initialize on demand holder idiom
     InitializingOnDemandHolderIdiom demandHolderIdiom =
             InitializingOnDemandHolderIdiom.getInstance();
     System.out.println(demandHolderIdiom);
     InitializingOnDemandHolderIdiom demandHolderIdiom2 =
             InitializingOnDemandHolderIdiom.getInstance();
     System.out.println(demandHolderIdiom2);
-
-    ThreadSafeDoubleCheckLocking dcl1 = ThreadSafeDoubleCheckLocking.getInstance();
-    System.out.println(dcl1);
-    ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
-    System.out.println(dcl2);
   }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
index 96809c477..7470c3f29 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
@@ -10,7 +10,7 @@ public final class IvoryTower {
   /**
    * Static to class instance of the class.
    */
-  private static IvoryTower instance = new IvoryTower();
+  private static final IvoryTower instance = new IvoryTower();
 
   /**
    * Private constructor so nobody can instantiate the class.

From 0a61d7b06729bec9906ec99fca9d9e9c8cd9f9eb Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 11:53:44 +0300
Subject: [PATCH 243/687] Improve Abstract Factory Javadocs

---
 .../java/com/iluwatar/abstractfactory/App.java  | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 29e9272f6..618b98c52 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -3,12 +3,21 @@ package com.iluwatar.abstractfactory;
 
 /**
  * 
+ * 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.
+ * {@link OrcKingdomFactory}). The example uses both concrete implementations to 
+ * create a king, a castle and an army.
  * 
  */
 public class App {

From 8c6caa29b728a53e49cb973cf902dd528cc16c07 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 11:56:59 +0300
Subject: [PATCH 244/687] Improve Adapter Javadoc

---
 adapter/src/main/java/com/iluwatar/adapter/App.java | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/adapter/src/main/java/com/iluwatar/adapter/App.java b/adapter/src/main/java/com/iluwatar/adapter/App.java
index 3d10a4d41..ed036b391 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/App.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/App.java
@@ -1,7 +1,13 @@
 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

From cdd586ec7cc3e7d83bcec61235ce7e010d3115ff Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 12:40:24 +0300
Subject: [PATCH 245/687] Improve Bridge Javadoc

---
 bridge/src/main/java/com/iluwatar/bridge/App.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/bridge/src/main/java/com/iluwatar/bridge/App.java b/bridge/src/main/java/com/iluwatar/bridge/App.java
index e8774caea..972f49b2f 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/App.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/App.java
@@ -2,6 +2,9 @@ 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.

From 9a08e35101df96536c63476b7b18abf54065121e Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 17:13:38 +0300
Subject: [PATCH 246/687] Improve Builder Javadoc

---
 .../src/main/java/com/iluwatar/builder/App.java   | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/builder/src/main/java/com/iluwatar/builder/App.java b/builder/src/main/java/com/iluwatar/builder/App.java
index bcdbb8821..b6131c3ab 100644
--- a/builder/src/main/java/com/iluwatar/builder/App.java
+++ b/builder/src/main/java/com/iluwatar/builder/App.java
@@ -4,7 +4,20 @@ import com.iluwatar. builder.Hero.HeroBuilder;
 
 /**
  * 
- * This is the Builder pattern variation as described by Joshua Bloch in
+ * 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

From a2f3d587091fcdb7b954c22ec1d7f5e30f224a60 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 20:19:01 +0300
Subject: [PATCH 247/687] Improve Chain Javadoc

---
 chain/src/main/java/com/iluwatar/chain/App.java | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/chain/src/main/java/com/iluwatar/chain/App.java b/chain/src/main/java/com/iluwatar/chain/App.java
index 5f98b2478..4d3ca69db 100644
--- a/chain/src/main/java/com/iluwatar/chain/App.java
+++ b/chain/src/main/java/com/iluwatar/chain/App.java
@@ -2,10 +2,16 @@ package com.iluwatar.chain;
 
 /**
  * 
- * Chain of Responsibility organizes request handlers ({@link RequestHandler}) into a
- * chain where each handler has a chance to act on the request on its turn. In
- * this example the king ({@link OrcKing}) makes requests and the military orcs
- * ({@link OrcCommander}, {@link OrcOfficer}, {@link OrcSoldier}) form the handler 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 {

From d5f52edecfd8cf56ae79263035af094b5a149176 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 20:21:56 +0300
Subject: [PATCH 248/687] Improve Command Javadoc

---
 command/src/main/java/com/iluwatar/command/App.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/command/src/main/java/com/iluwatar/command/App.java b/command/src/main/java/com/iluwatar/command/App.java
index fc05afa66..b421b683b 100644
--- a/command/src/main/java/com/iluwatar/command/App.java
+++ b/command/src/main/java/com/iluwatar/command/App.java
@@ -2,7 +2,9 @@ package com.iluwatar.command;
 
 /**
  * 
- * In Command pattern actions are objects that can be executed and undone. 
+ * 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 

From 807478ab3da057f98a5b51f5f7dab5d2c8b2b7cf Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 20:27:28 +0300
Subject: [PATCH 249/687] Improve Composite Javadoc

---
 .../src/main/java/com/iluwatar/composite/App.java    | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/composite/src/main/java/com/iluwatar/composite/App.java b/composite/src/main/java/com/iluwatar/composite/App.java
index 7dfd15443..7bd0e4d01 100644
--- a/composite/src/main/java/com/iluwatar/composite/App.java
+++ b/composite/src/main/java/com/iluwatar/composite/App.java
@@ -1,10 +1,14 @@
 package com.iluwatar.composite;
 
 /**
- * 
- * With Composite we can treat tree hierarchies of objects with uniform
- * interface ({@link LetterComposite}). In this example we have sentences composed of
- * words composed of letters.
+ * 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 {

From 621793ed2d966f6dcc1cb6e390ffd92bee5fe861 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 20:34:15 +0300
Subject: [PATCH 250/687] Improved DAO Javadoc

---
 dao/src/main/java/com/iluwatar/dao/App.java | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/dao/src/main/java/com/iluwatar/dao/App.java b/dao/src/main/java/com/iluwatar/dao/App.java
index ac6794973..851153f22 100644
--- a/dao/src/main/java/com/iluwatar/dao/App.java
+++ b/dao/src/main/java/com/iluwatar/dao/App.java
@@ -5,8 +5,14 @@ import java.util.List;
 
 /**
  * 
+ * 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.
+ * 
    
  * With the DAO pattern, we can use various method calls to retrieve/add/delete/update data without directly
- * interacting with the data. The below example demonstrates basic operations(CRUD): select, add, update, and delete.
+ * interacting with the data. The below example demonstrates basic CRUD operations: select, add, update, and delete.
  * 
  */
 public class App {

From 8cf35fc315c595b6d8f3a2cfd3b744756c94df4d Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 20:43:38 +0300
Subject: [PATCH 251/687] Improve Decorator Javadoc

---
 .../src/main/java/com/iluwatar/decorator/App.java     | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/decorator/src/main/java/com/iluwatar/decorator/App.java b/decorator/src/main/java/com/iluwatar/decorator/App.java
index a9eabf606..bd697d4a4 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/App.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/App.java
@@ -2,12 +2,15 @@ package com.iluwatar.decorator;
 
 /**
  * 
- * Decorator pattern is a more flexible alternative to subclassing. The decorator
+ * The Decorator pattern is a more flexible alternative to subclassing. The Decorator
  * class implements the same interface as the target and uses composition to
- * "decorate" calls to the target.
+ * "decorate" calls to the target. Using the Decorator pattern it is possible to 
+ * change the behavior of the class during runtime.
  * 
    
- * Using decorator pattern it is possible to change class behavior during
- * runtime, as the example shows.
+ * In this example we show how the simple {@link Troll} first attacks and then
+ * flees the battle. Then we decorate the {@link Troll} with a {@link SmartTroll}
+ * and perform the attack again. You can see how the behavior changes after the
+ * decoration.
  * 
  */
 public class App {

From e32b440a38e74520de5813e277c105e8e14074d2 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:00:21 +0300
Subject: [PATCH 252/687] Improve Double Checked Locking Javadoc

---
 .../main/java/com/iluwatar/doublechecked/locking/App.java    | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
index 2a5c65813..80806e9eb 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
@@ -5,6 +5,11 @@ import java.util.concurrent.Executors;
 
 /**
  * 
+ * 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

From 584a22238d380600c3f7a4c781fb6db0a15ed9a5 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:06:52 +0300
Subject: [PATCH 253/687] Improve Event Aggregator Javadoc

---
 .../src/main/java/com/iluwatar/event/aggregator/App.java  | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
index 029489077..b69d8ceaa 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
@@ -5,8 +5,12 @@ import java.util.List;
 
 /**
  * 
- * The Event Aggregator pattern channels events from multiple objects 
- * into a single object to simplify registration for clients.
+ * 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

From 516b127d217cfe5eff4cf0aea0d6edc843b6cd83 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:11:19 +0300
Subject: [PATCH 254/687] Improved Facade Javadoc

---
 facade/src/main/java/com/iluwatar/facade/App.java | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/facade/src/main/java/com/iluwatar/facade/App.java b/facade/src/main/java/com/iluwatar/facade/App.java
index 0d8eccd4b..37cda0281 100644
--- a/facade/src/main/java/com/iluwatar/facade/App.java
+++ b/facade/src/main/java/com/iluwatar/facade/App.java
@@ -2,9 +2,15 @@ package com.iluwatar.facade;
 
 /**
  * 
- * Facade ({@link DwarvenGoldmineFacade}) provides simpler interface to subsystem.
+ * 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.
  * 
    
- * http://en.wikipedia.org/wiki/Facade_pattern
+ * In this example the Facade is ({@link DwarvenGoldmineFacade}) and it provides a simpler 
+ * interface to the goldmine subsystem.
  * 
  */
 public class App {

From c989f6cb219ba38ee0c2a76852065095f762f9a8 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:14:40 +0300
Subject: [PATCH 255/687] Improve Factory Method Javadoc

---
 .../src/main/java/com/iluwatar/factory/method/App.java   | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/App.java b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
index 69bda3489..118413564 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/App.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
@@ -2,7 +2,14 @@ package com.iluwatar.factory.method;
 
 /**
  * 
- * In Factory Method we have an interface ({@link Blacksmith}) with a method for
+ * 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.

From c27291fd27c4f8d9e6aef22fc4c91fcc0e5c19f8 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:17:56 +0300
Subject: [PATCH 256/687] Improve Fluent Interface Javadoc

---
 .../java/com/iluwatar/fluentinterface/app/App.java  | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)

diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
index 81a1ccb6a..7733df37d 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
@@ -11,15 +11,14 @@ import java.util.function.Predicate;
 import static java.lang.String.valueOf;
 
 /**
- * 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.
+ * 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
- * SimpleFluentIterable evaluates eagerly and would be too costly for real world applications. The
- * 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.
- * 
    
+ * {@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 {
 

From b4118bb8668b2574094483d8357fddb80ce699d3 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:28:17 +0300
Subject: [PATCH 257/687] Improve Intercepting Filter Javadoc

---
 .../com/iluwatar/intercepting/filter/App.java | 30 +++++++++++++++++--
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
index 7cdb17fb8..c913da66c 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
@@ -1,9 +1,33 @@
 package com.iluwatar.intercepting.filter;
 
 /**
- *
- * This is an app that checks whether the order request is valid through pre-processing done via {@link Filter}.
- * Each field has its own corresponding {@link 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
  *
  */

From 44d7be9c94d23fbab3c09a6b0849909868869c2a Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:32:56 +0300
Subject: [PATCH 258/687] Improve Interpreter Javadoc

---
 .../src/main/java/com/iluwatar/interpreter/App.java    | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/App.java b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
index 2273b386b..955563915 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/App.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
@@ -4,8 +4,14 @@ import java.util.Stack;
 
 /**
  * 
- * Interpreter pattern breaks sentences into expressions ({@link Expression}) that can
- * be evaluated and as a whole form the result.
+ * 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 {

From e4ff39e08098da9fab6ca41a544e720d7fac6d03 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 21:37:29 +0300
Subject: [PATCH 259/687] Improve Iterator Javadoc

---
 iterator/src/main/java/com/iluwatar/iterator/App.java | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/iterator/src/main/java/com/iluwatar/iterator/App.java b/iterator/src/main/java/com/iluwatar/iterator/App.java
index 5b59cbcbc..b8ecfa42c 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/App.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/App.java
@@ -2,9 +2,13 @@ package com.iluwatar.iterator;
 
 /**
  * 
- * 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.
+ * 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 {

From fc66ae80849fd8938267f50618bf82544efc7208 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 23:34:20 +0300
Subject: [PATCH 260/687] Improve Mediator Javadoc

---
 .../main/java/com/iluwatar/mediator/App.java  | 22 +++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/mediator/src/main/java/com/iluwatar/mediator/App.java b/mediator/src/main/java/com/iluwatar/mediator/App.java
index a7df7d39f..9648ac608 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/App.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/App.java
@@ -2,8 +2,26 @@ package com.iluwatar.mediator;
 
 /**
  * 
- * Mediator encapsulates how a set of objects ({@link PartyMember}) interact. Instead of
- * referring to each other directly they use a mediator ({@link Party}) interface.
+ * 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 {

From ca6bb7a3a878bd6c24fd607af73f4b310c21358a Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 23:38:37 +0300
Subject: [PATCH 261/687] Improve Memento Javadoc

---
 .../src/main/java/com/iluwatar/memento/App.java   | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/memento/src/main/java/com/iluwatar/memento/App.java b/memento/src/main/java/com/iluwatar/memento/App.java
index 623ffb00e..71d0ed466 100644
--- a/memento/src/main/java/com/iluwatar/memento/App.java
+++ b/memento/src/main/java/com/iluwatar/memento/App.java
@@ -4,7 +4,20 @@ import java.util.Stack;
 
 /**
  * 
- * Memento pattern is for storing and restoring object state. The object ({@link Star})
+ * 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.
  * 

From 4d1aae21f74e7762d115ef3e369d18b8b45cd1dc Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 23:48:51 +0300
Subject: [PATCH 262/687] Improve Observer Javadoc

---
 .../src/main/java/com/iluwatar/observer/App.java    | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/observer/src/main/java/com/iluwatar/observer/App.java b/observer/src/main/java/com/iluwatar/observer/App.java
index bd99da841..bc4742a14 100644
--- a/observer/src/main/java/com/iluwatar/observer/App.java
+++ b/observer/src/main/java/com/iluwatar/observer/App.java
@@ -6,8 +6,17 @@ import com.iluwatar.observer.generic.GWeather;
 
 /**
  * 
- * Observer pattern defines one-to-many relationship between objects. The target
- * object sends change notifications to its registered observers.
+ * 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 {

From 98aa28d94e76157e2c7124db49ac930f1412b220 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 23:53:09 +0300
Subject: [PATCH 263/687] Improve Poison Pill Javadoc

---
 .../src/main/java/com/iluwatar/poison/pill/App.java    | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
index 526ca5b86..91d30fddd 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
@@ -2,12 +2,12 @@ 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 exchange is over
- * and reject any further messages. 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).
+ * 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 as Poison Pill can be used just null-reference, but holding unique separate shared
+ * 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.
  * 
  */

From 40e378c1f3ed1407a4918c1d7bd5ff1e09730adc Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sat, 3 Oct 2015 23:57:17 +0300
Subject: [PATCH 264/687] Improve Property Javadoc

---
 property/src/main/java/com/iluwatar/property/App.java | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/property/src/main/java/com/iluwatar/property/App.java b/property/src/main/java/com/iluwatar/property/App.java
index 54c140574..ac46f5448 100644
--- a/property/src/main/java/com/iluwatar/property/App.java
+++ b/property/src/main/java/com/iluwatar/property/App.java
@@ -4,12 +4,14 @@ import com.iluwatar.property.Character.Type;
 
 /**
  * 
- * Example of {@link Character} instantiation using the Property pattern (also known as Prototype inheritance).
+ * 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 {

From 9a4f83e7b804af6620ab03106d7ec613cacfc4a9 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 4 Oct 2015 00:04:12 +0300
Subject: [PATCH 265/687] Improve Prototype Javadoc

---
 .../src/main/java/com/iluwatar/prototype/App.java     | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/prototype/src/main/java/com/iluwatar/prototype/App.java b/prototype/src/main/java/com/iluwatar/prototype/App.java
index 4003862cb..74bb6989d 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/App.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/App.java
@@ -2,9 +2,14 @@ package com.iluwatar.prototype;
 
 /**
  * 
- * In Prototype we have a factory class ({@link HeroFactoryImpl}) producing objects by
- * cloning the existing ones. In this example the factory's prototype objects are
- * given as constructor parameters.
+ * 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 {

From c3a827b475c895493fd2d4256c46b817856eaee1 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 4 Oct 2015 00:08:34 +0300
Subject: [PATCH 266/687] Improved Proxy Javadoc

---
 proxy/src/main/java/com/iluwatar/proxy/App.java | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java
index fb401ac9f..420ad5c0a 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/App.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/App.java
@@ -2,7 +2,18 @@ package com.iluwatar.proxy;
 
 /**
  * 
- * Proxy ({@link WizardTowerProxy}) controls access to the actual object ({@link WizardTower}).
+ * 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 WizardTower}).
  * 
  */
 public class App {

From 8db2bb2ac83eacc72a7cbf8f7fdaba58a544fc0d Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 4 Oct 2015 00:13:08 +0300
Subject: [PATCH 267/687] Improve Servant Javadoc

---
 servant/src/main/java/com/iluwatar/servant/App.java | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/servant/src/main/java/com/iluwatar/servant/App.java b/servant/src/main/java/com/iluwatar/servant/App.java
index 6a0ba6ca4..832d3d52c 100644
--- a/servant/src/main/java/com/iluwatar/servant/App.java
+++ b/servant/src/main/java/com/iluwatar/servant/App.java
@@ -7,6 +7,8 @@ import java.util.ArrayList;
  * 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 {

From 74e32259bef4aae0b856552d8b6944f7e91a333e Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 4 Oct 2015 00:16:05 +0300
Subject: [PATCH 268/687] Improve Service Locator Javadoc

---
 .../src/main/java/com/iluwatar/servicelocator/App.java | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
index f86e1cc32..5b6615495 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
@@ -1,9 +1,15 @@
 package com.iluwatar.servicelocator;
 
 /**
- * Service locator pattern, used to lookup JNDI-services
+ * 
+ * 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
  * 
  */

From 2234a25c76d0e926c5e078883c9553a670f78cc8 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 4 Oct 2015 00:19:34 +0300
Subject: [PATCH 269/687] Improve State Javadoc

---
 state/src/main/java/com/iluwatar/state/App.java | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/state/src/main/java/com/iluwatar/state/App.java b/state/src/main/java/com/iluwatar/state/App.java
index 5b39d02f7..95d411076 100644
--- a/state/src/main/java/com/iluwatar/state/App.java
+++ b/state/src/main/java/com/iluwatar/state/App.java
@@ -2,10 +2,14 @@ package com.iluwatar.state;
 
 /**
  * 
- * In State pattern the container object ({@link Mammoth}) has an internal state object ({@link State}) that
+ * 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.
  * 
  */

From 0a9879a277eb7c3b928c687a2e2ca945970a6517 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 4 Oct 2015 00:22:27 +0300
Subject: [PATCH 270/687] Improve Strategy Javadoc

---
 strategy/src/main/java/com/iluwatar/strategy/App.java | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/strategy/src/main/java/com/iluwatar/strategy/App.java b/strategy/src/main/java/com/iluwatar/strategy/App.java
index 992514801..b88eae242 100644
--- a/strategy/src/main/java/com/iluwatar/strategy/App.java
+++ b/strategy/src/main/java/com/iluwatar/strategy/App.java
@@ -2,7 +2,10 @@ package com.iluwatar.strategy;
 
 /**
  * 
- * Strategy ({@link DragonSlayingStrategy}) encapsulates an algorithm. The containing
+ * 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.
+ * 
    
+ * In this example ({@link DragonSlayingStrategy}) encapsulates an algorithm. The containing
  * object ({@link DragonSlayer}) can alter its behavior by changing its strategy.
  * 
  */

From c8fd9f3a0d6db31743b58d623a78701c9f4ca008 Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Sun, 4 Oct 2015 03:06:11 +0530
Subject: [PATCH 271/687] Monostate pattern #85

---
 monostate/etc/MonoState.ucls                  |  53 ++++++++++++++++++
 monostate/etc/monostate.png                   | Bin 0 -> 16526 bytes
 monostate/index.md                            |  28 +++++++++
 monostate/pom.xml                             |  18 ++++++
 .../main/java/com/iluwatar/monostate/App.java |  11 ++++
 .../com/iluwatar/monostate/LoadBalancer.java  |  39 +++++++++++++
 .../java/com/iluwatar/monostate/Request.java  |  10 ++++
 .../java/com/iluwatar/monostate/Server.java   |  21 +++++++
 8 files changed, 180 insertions(+)
 create mode 100644 monostate/etc/MonoState.ucls
 create mode 100644 monostate/etc/monostate.png
 create mode 100644 monostate/index.md
 create mode 100644 monostate/pom.xml
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/App.java
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/Request.java
 create mode 100644 monostate/src/main/java/com/iluwatar/monostate/Server.java

diff --git a/monostate/etc/MonoState.ucls b/monostate/etc/MonoState.ucls
new file mode 100644
index 000000000..76b48ad0f
--- /dev/null
+++ b/monostate/etc/MonoState.ucls
@@ -0,0 +1,53 @@
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/monostate/etc/monostate.png b/monostate/etc/monostate.png
new file mode 100644
index 0000000000000000000000000000000000000000..273fa95459d4d0853c58bfa25cb6e1117fd48032
GIT binary patch
literal 16526
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
lB1^Ap5DW=7cfNYWCnbDHap(Cm_
+
+  4.0.0
+  
+    com.iluwatar
+    java-design-patterns
+    1.6.0
+  
+  monostate
+  
+    
+      junit
+      junit
+      test
+    
+  
+
diff --git a/monostate/src/main/java/com/iluwatar/monostate/App.java b/monostate/src/main/java/com/iluwatar/monostate/App.java
new file mode 100644
index 000000000..a96895126
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/App.java
@@ -0,0 +1,11 @@
+package com.iluwatar.monostate;
+
+public class App {
+	public static void main(String[] args) {
+		LoadBalancer loadBalancer1 = new LoadBalancer();
+		LoadBalancer loadBalancer2 = new LoadBalancer();
+		loadBalancer1.serverequest(new Request("Hello"));
+		loadBalancer2.serverequest(new Request("Hello World"));
+	}
+
+}
diff --git a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
new file mode 100644
index 000000000..29a101b81
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
@@ -0,0 +1,39 @@
+package com.iluwatar.monostate;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class LoadBalancer {
+  private static List servers = new ArrayList<>();
+  private static int id = 0;
+  private static int lastServedId = 0;
+
+  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));
+  }
+
+  public final void addServer(Server server) {
+    synchronized (servers) {
+      servers.add(server);
+    }
+
+  }
+
+  public final int getNoOfServers() {
+    return servers.size();
+  }
+
+  public void serverequest(Request request) {
+    if (lastServedId >= servers.size()) {
+      lastServedId = 0;
+    }
+    Server server = servers.get(lastServedId++);
+    server.serve(request);
+  }
+
+
+}
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Request.java b/monostate/src/main/java/com/iluwatar/monostate/Request.java
new file mode 100644
index 000000000..c57072a21
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/Request.java
@@ -0,0 +1,10 @@
+package com.iluwatar.monostate;
+
+public class Request {
+  public final String value;
+
+  public Request(String value) {
+    super();
+    this.value = value;
+  }
+}
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
new file mode 100644
index 000000000..43be5300b
--- /dev/null
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -0,0 +1,21 @@
+package com.iluwatar.monostate;
+
+public class Server {
+  public final String host;
+  public final int port;
+  public final int id;
+  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 final void serve(Request request) {
+    System.out.println("Server ID "+id + "  processed request with value  "+request.value);
+  }
+}

From 2c45f732543bc4d3bec1ac3757d271cec6ded625 Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Sun, 4 Oct 2015 03:12:51 +0530
Subject: [PATCH 272/687] MonoState #85

---
 pom.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index 7b0d80bd8..e36687eb4 100644
--- a/pom.xml
+++ b/pom.xml
@@ -72,6 +72,7 @@
 		front-controller
 		repository
 		async-method-invocation
+                monostate
     	business-delegate
     	half-sync-half-async
 		step-builder
@@ -208,4 +209,4 @@
 		
 	
 
-
\ No newline at end of file
+

From 19f5966cb9b5d5c24f25434f57e2bbea28c80873 Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Wed, 7 Oct 2015 20:37:45 +0530
Subject: [PATCH 273/687] Added Comments and Feedback

---
 .../main/java/com/iluwatar/monostate/App.java | 36 +++++++++++++++----
 .../com/iluwatar/monostate/LoadBalancer.java  | 13 +++++++
 .../java/com/iluwatar/monostate/Request.java  |  6 ++++
 .../java/com/iluwatar/monostate/Server.java   | 12 ++++++-
 .../java/com/iluwatar/monostate/AppTest.java  | 26 ++++++++++++++
 5 files changed, 86 insertions(+), 7 deletions(-)
 create mode 100644 monostate/src/test/java/com/iluwatar/monostate/AppTest.java

diff --git a/monostate/src/main/java/com/iluwatar/monostate/App.java b/monostate/src/main/java/com/iluwatar/monostate/App.java
index a96895126..0daad5b67 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/App.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/App.java
@@ -1,11 +1,35 @@
 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 {
-	public static void main(String[] args) {
-		LoadBalancer loadBalancer1 = new LoadBalancer();
-		LoadBalancer loadBalancer2 = new LoadBalancer();
-		loadBalancer1.serverequest(new Request("Hello"));
-		loadBalancer2.serverequest(new Request("Hello World"));
-	}
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    LoadBalancer loadBalancer1 = new LoadBalancer();
+    LoadBalancer loadBalancer2 = new LoadBalancer();
+    loadBalancer1.serverequest(new Request("Hello"));
+    loadBalancer2.serverequest(new Request("Hello World"));
+  }
 
 }
diff --git a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
index 29a101b81..7bc0043e8 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
@@ -3,6 +3,14 @@ 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 = 0;
@@ -27,6 +35,10 @@ public class LoadBalancer {
     return servers.size();
   }
 
+  public static int getLastServedId() {
+    return lastServedId;
+  }
+
   public void serverequest(Request request) {
     if (lastServedId >= servers.size()) {
       lastServedId = 0;
@@ -34,6 +46,7 @@ public class LoadBalancer {
     Server server = servers.get(lastServedId++);
     server.serve(request);
   }
+  
 
 
 }
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Request.java b/monostate/src/main/java/com/iluwatar/monostate/Request.java
index c57072a21..037ab96aa 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Request.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Request.java
@@ -1,5 +1,11 @@
 package com.iluwatar.monostate;
 
+/**
+ * 
+ * The Request class. A {@link Server} can handle an instance of a Request. 
+ * 
+ */
+
 public class Request {
   public final String value;
 
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
index 43be5300b..15973c40d 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Server.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -1,21 +1,31 @@
 package com.iluwatar.monostate;
 
+/**
+ * 
+ * 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 {
   public final String host;
   public final int port;
   public final int id;
+
   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 final void serve(Request request) {
-    System.out.println("Server ID "+id + "  processed request with value  "+request.value);
+    System.out.println("Server ID " + id + "  processed request with value  " + request.value);
   }
 }
diff --git a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
new file mode 100644
index 000000000..c5f1f7e92
--- /dev/null
+++ b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
@@ -0,0 +1,26 @@
+package com.iluwatar.monostate;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+public class AppTest {
+
+  @Test
+  public void testSameStateAmonstAllInstances() {
+    LoadBalancer balancer = new LoadBalancer();
+    LoadBalancer balancer2 = new LoadBalancer();
+    balancer.addServer(new Server("localhost", 8085, 6));
+    // Both should have the same number of servers.
+    Assert.assertTrue(balancer.getNoOfServers() == balancer2.getNoOfServers());
+    // Both Should have the same LastServedId
+    Assert.assertTrue(balancer.getLastServedId() == balancer2.getLastServedId());
+  }
+  
+  @Test
+  public void testMain() {
+    String[] args = {};
+    App.main(args);
+    Assert.assertTrue(LoadBalancer.getLastServedId() == 2);
+  }
+
+}

From 81b5bc99ce7b4819d5cccf9641842a8885030c2b Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Thu, 8 Oct 2015 09:43:19 +0530
Subject: [PATCH 274/687] Update Pom.xml

Fixed Reference to Parent POM
---
 monostate/pom.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/monostate/pom.xml b/monostate/pom.xml
index fb40432da..480a4967c 100644
--- a/monostate/pom.xml
+++ b/monostate/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.6.0
+    1.7.0
   
   monostate
   

From 9a824c7d21f3bd17ac660553457b6f1462e2296a Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Sun, 4 Oct 2015 03:12:51 +0530
Subject: [PATCH 275/687] MonoState #85

---
 pom.xml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/pom.xml b/pom.xml
index 317865275..f4979c05c 100644
--- a/pom.xml
+++ b/pom.xml
@@ -75,6 +75,9 @@
 		async-method-invocation
                 monostate
 		step-builder
+    	       business-delegate
+    	       half-sync-half-async
+	       step-builder
 		layers
 		message-channel
 		fluentinterface

From eb22febdfc5728cec62349753b20164cf2e626a5 Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Fri, 9 Oct 2015 21:28:57 +0530
Subject: [PATCH 276/687] Printing Server variables

---
 monostate/src/main/java/com/iluwatar/monostate/Server.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
index 15973c40d..ce4e0222d 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Server.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -26,6 +26,6 @@ public class Server {
   }
 
   public final void serve(Request request) {
-    System.out.println("Server ID " + id + "  processed request with value  " + request.value);
+    System.out.println("Server ID " + id + " associated to host : " + getHost() + " and Port " + getPort() +" Processed request with value  " + request.value);
   }
 }

From 9d0673af0aebb461188e61d690c83c576c9408f5 Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Fri, 9 Oct 2015 23:20:58 +0530
Subject: [PATCH 277/687] Made changes according to feedback issue #258

---
 monostate/index.md                                          | 2 +-
 monostate/src/main/java/com/iluwatar/monostate/Request.java | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/monostate/index.md b/monostate/index.md
index 369d24ff8..2b88f131e 100644
--- a/monostate/index.md
+++ b/monostate/index.md
@@ -14,7 +14,7 @@ tags: Java
 **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.
+* 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:**
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Request.java b/monostate/src/main/java/com/iluwatar/monostate/Request.java
index 037ab96aa..ee1f31d85 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Request.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Request.java
@@ -10,7 +10,6 @@ public class Request {
   public final String value;
 
   public Request(String value) {
-    super();
     this.value = value;
   }
 }

From 271ce09e26e009d7f5af365816be1dcc2cfe15fd Mon Sep 17 00:00:00 2001
From: amit2103 
Date: Fri, 9 Oct 2015 23:26:10 +0530
Subject: [PATCH 278/687] Fixed POMS

---
 pom.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/pom.xml b/pom.xml
index f4979c05c..262e86856 100644
--- a/pom.xml
+++ b/pom.xml
@@ -77,7 +77,6 @@
 		step-builder
     	       business-delegate
     	       half-sync-half-async
-	       step-builder
 		layers
 		message-channel
 		fluentinterface

From 6ba7f5ea048c4864e9ae52b19dedcb20bfc131f2 Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Sun, 11 Oct 2015 21:32:51 -0300
Subject: [PATCH 279/687] Add additional unit tests to show that singletons can
 be created in single thread environment and multithread environment. Also add
 a test to demonstrate a whole with Singleton when instantiating using
 reflection

---
 .../LazyLoadedSingletonThreadSafetyTest.java  | 158 +++++++++++-------
 1 file changed, 97 insertions(+), 61 deletions(-)

diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index ca88f4169..36d04f95f 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -2,73 +2,109 @@ package com.iluwatar.singleton;
 
 import org.junit.Test;
 
+import java.lang.reflect.Constructor;
+import java.lang.reflect.Field;
+import java.lang.reflect.InvocationTargetException;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.*;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNull;
+
 /**
- * 
- * This test case demonstrates thread safety issues of lazy loaded Singleton implementation.
- * 
    
- * Out of the box you should see the test output something like the following:
- * 
    
- * Thread=Thread-4 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e
- * Thread=Thread-2 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e
- * Thread=Thread-0 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e
- * Thread=Thread-0 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e
- * Thread=Thread-3 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e
- * Thread=Thread-1 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@60f330b0
- * Thread=Thread-2 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@6fde356e
- * 
    
- * By changing the method signature of LazyLoadedIvoryTower#getInstance from
- * 
    - * 	 public static LazyLoadedIvoryTower getInstance()
- * 
    
- * into
- * 
    - *   public synchronized static LazyLoadedIvoryTower getInstance()
- * 
    
- * you should see the test output change to something like the following:
- * 
    
- * Thread=Thread-4 creating instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490
- * Thread=Thread-4 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490
- * Thread=Thread-0 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490
- * Thread=Thread-3 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490
- * Thread=Thread-2 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490
- * Thread=Thread-1 got instance=com.iluwatar.singleton.LazyLoadedSingletonThreadSafetyTest$LazyLoadedIvoryTower@3c688490
+ * 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.
+ * The third proves that there is a hole if the singleton is created reflectively
  *
  */
 public class LazyLoadedSingletonThreadSafetyTest {
 
-	private static final int NUM_THREADS = 5;
-	
-	@Test
-	public void test() {
-		SingletonThread runnable = new SingletonThread();
-		for (int j=0; j threadObjects = new ArrayList<>();
 
-		@Override
-		public void run() {
-			LazyLoadedIvoryTower instance = LazyLoadedIvoryTower.getInstance();
-			System.out.println("Thread=" + Thread.currentThread().getName() + " got instance=" + instance);
-		}
-	}
-	
-	private static class LazyLoadedIvoryTower {
+    //NullObject class so Callable has to return something
+    private class NullObject{private NullObject(){}}
 
-		private static LazyLoadedIvoryTower instance = null;
-		
-		private LazyLoadedIvoryTower() {
-		}
+    @Test
+    public void test_MultipleCallsReturnTheSameObjectInSameThread() {
+        //Create several instances in the same calling thread
+        ThreadSafeLazyLoadedIvoryTower instance1 = ThreadSafeLazyLoadedIvoryTower.getInstance();
+        ThreadSafeLazyLoadedIvoryTower instance2 = ThreadSafeLazyLoadedIvoryTower.getInstance();
+        ThreadSafeLazyLoadedIvoryTower instance3 = ThreadSafeLazyLoadedIvoryTower.getInstance();
+        //now check they are equal
+        assertEquals(instance1, instance1);
+        assertEquals(instance1, instance2);
+        assertEquals(instance2, instance3);
+        assertEquals(instance1, instance3);
+    }
 
-		public static LazyLoadedIvoryTower getInstance() {
-			if (instance == null) {
-				instance = new LazyLoadedIvoryTower();
-				System.out.println("Thread=" + Thread.currentThread().getName() + " creating instance=" + instance);
-			}
-			return instance;
-		}
-	}
+    @Test
+    public void test_MultipleCallsReturnTheSameObjectInDifferentThreads() throws InterruptedException, ExecutionException {
+        {//create several threads and inside each callable instantiate the singleton class
+            ExecutorService executorService = Executors.newSingleThreadExecutor();
+
+            List> threadList = new ArrayList<>();
+            for (int i = 0; i < NUM_THREADS; i++) {
+                threadList.add(new SingletonCreatingThread());
+            }
+
+            ExecutorService service = Executors.newCachedThreadPool();
+            List> results = service.invokeAll(threadList);
+
+            //wait for all of the threads to complete
+            for (Future res : results) {
+                res.get();
+            }
+
+            //tidy up the executor
+            executorService.shutdown();
+        }
+        {//now check the contents that were added to threadObjects by each thread
+            assertEquals(NUM_THREADS, threadObjects.size());
+            assertEquals(threadObjects.get(0), threadObjects.get(1));
+            assertEquals(threadObjects.get(1), threadObjects.get(2));
+            assertEquals(threadObjects.get(2), threadObjects.get(3));
+            assertEquals(threadObjects.get(3), threadObjects.get(4));
+        }
+    }
+
+    @Test
+    @SuppressWarnings("unchecked")
+    public void test_HoleInSingletonCreationIfUsingReflection() throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
+        Field[] f = ThreadSafeLazyLoadedIvoryTower.class.getDeclaredFields();
+        assertEquals("One field only in ThreadSafeLazyLoadedIvoryTower", 1, f.length);
+        f[0].setAccessible(true);
+
+        {//reflectively create an object - the singleton field is null
+            Class lazyIvoryTowerClazz = Class.forName("com.iluwatar.singleton.ThreadSafeLazyLoadedIvoryTower");
+            Constructor constructor = lazyIvoryTowerClazz.getDeclaredConstructor();
+            constructor.setAccessible(true);
+            ThreadSafeLazyLoadedIvoryTower instance = constructor.newInstance();
+            assertNull(f[0].get(instance));
+        }
+
+        //instantiate the singleton but when we do the below code we are creating a new object where it is set to null still
+        IvoryTower.getInstance();
+
+        {//reflectively create an object - the singleton field is null as a new object is created
+            Class lazyIvoryTowerClazz = Class.forName("com.iluwatar.singleton.ThreadSafeLazyLoadedIvoryTower");
+            Constructor constructor = lazyIvoryTowerClazz.getDeclaredConstructor();
+            constructor.setAccessible(true);
+            ThreadSafeLazyLoadedIvoryTower instance = constructor.newInstance();
+            assertNull(f[0].get(instance));
+        }
+    }
+
+    private class SingletonCreatingThread implements Callable {
+        @Override
+        public NullObject call() {
+            //instantiate the thread safety class and add to list to test afterwards
+            ThreadSafeLazyLoadedIvoryTower instance = ThreadSafeLazyLoadedIvoryTower.getInstance();
+            threadObjects.add(instance);
+            return new NullObject();//return null object (cannot return Void)
+        }
+    }
 }

From 45b0ac386e1c492e92093552e40b100557dd9d4c Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Sun, 11 Oct 2015 21:54:45 -0300
Subject: [PATCH 280/687] Add additional unit tests to show that singletons can
 be created in single thread environment and multithread environment. Also add
 a test to demonstrate a whole with Singleton when instantiating using
 reflection

Add some logging. Tests pass locally but not on github?
---
 .../singleton/LazyLoadedSingletonThreadSafetyTest.java         | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index 36d04f95f..a19e641f6 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -75,6 +75,9 @@ public class LazyLoadedSingletonThreadSafetyTest {
     @SuppressWarnings("unchecked")
     public void test_HoleInSingletonCreationIfUsingReflection() throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
         Field[] f = ThreadSafeLazyLoadedIvoryTower.class.getDeclaredFields();
+        for (Field ff : f) {
+            System.out.println(ff.getDeclaringClass());
+        }
         assertEquals("One field only in ThreadSafeLazyLoadedIvoryTower", 1, f.length);
         f[0].setAccessible(true);
 

From 7cf5b320867e8eee5beb4018874ede3350e2387e Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Sun, 11 Oct 2015 21:58:13 -0300
Subject: [PATCH 281/687] Add additional unit tests to show how lazy loading is
 working with reflection

---
 .../lazy/loading/HolderThreadSafeTest.java    | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java

diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
new file mode 100644
index 000000000..90cf7c02c
--- /dev/null
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
@@ -0,0 +1,41 @@
+package com.iluwatar.lazy.loading;
+
+import org.junit.Test;
+
+import java.lang.reflect.Field;
+
+import static org.junit.Assert.assertEquals;
+import static org.junit.Assert.assertNotNull;
+import static org.junit.Assert.assertNull;
+
+/**
+ * Using reflection this test shows that the heavy field is not instantiated until the method getHeavy is called
+ *
+ * Created by jones on 11/10/2015.
+ */
+public class HolderThreadSafeTest {
+
+    @Test
+    public void test() throws IllegalAccessException {
+        HolderThreadSafe hts = new HolderThreadSafe();
+
+        {//first call is null
+            Field[] f = HolderThreadSafe.class.getDeclaredFields();
+            assertEquals("One field only in HolderThreadSafe", 1, f.length);
+            f[0].setAccessible(true);
+
+            assertNull(f[0].get(hts));
+        }
+
+        // now it is lazily loaded
+        hts.getHeavy();
+
+        {//now it is not null - call via reflection so that the test is the same before and after
+            Field[] f = HolderThreadSafe.class.getDeclaredFields();
+            assertEquals("One field only in HolderThreadSafe", 1, f.length);
+            f[0].setAccessible(true);
+
+            assertNotNull(f[0].get(hts));
+        }
+    }
+}

From 0107b24976175bc6757deb26a2d72d67e5f63b3e Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Sun, 11 Oct 2015 22:06:00 -0300
Subject: [PATCH 282/687] Fix unit test by makinig getField use the field name
 directly

---
 .../LazyLoadedSingletonThreadSafetyTest.java       | 14 +++++---------
 1 file changed, 5 insertions(+), 9 deletions(-)

diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index a19e641f6..9b78f446f 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -73,20 +73,16 @@ public class LazyLoadedSingletonThreadSafetyTest {
 
     @Test
     @SuppressWarnings("unchecked")
-    public void test_HoleInSingletonCreationIfUsingReflection() throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException {
-        Field[] f = ThreadSafeLazyLoadedIvoryTower.class.getDeclaredFields();
-        for (Field ff : f) {
-            System.out.println(ff.getDeclaringClass());
-        }
-        assertEquals("One field only in ThreadSafeLazyLoadedIvoryTower", 1, f.length);
-        f[0].setAccessible(true);
+    public void test_HoleInSingletonCreationIfUsingReflection() throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException, NoSuchFieldException {
+        Field f = ThreadSafeLazyLoadedIvoryTower.class.getDeclaredField("instance");
+        f.setAccessible(true);
 
         {//reflectively create an object - the singleton field is null
             Class lazyIvoryTowerClazz = Class.forName("com.iluwatar.singleton.ThreadSafeLazyLoadedIvoryTower");
             Constructor constructor = lazyIvoryTowerClazz.getDeclaredConstructor();
             constructor.setAccessible(true);
             ThreadSafeLazyLoadedIvoryTower instance = constructor.newInstance();
-            assertNull(f[0].get(instance));
+            assertNull(f.get(instance));
         }
 
         //instantiate the singleton but when we do the below code we are creating a new object where it is set to null still
@@ -97,7 +93,7 @@ public class LazyLoadedSingletonThreadSafetyTest {
             Constructor constructor = lazyIvoryTowerClazz.getDeclaredConstructor();
             constructor.setAccessible(true);
             ThreadSafeLazyLoadedIvoryTower instance = constructor.newInstance();
-            assertNull(f[0].get(instance));
+            assertNull(f.get(instance));
         }
     }
 

From 31e2940eb118520dab8a117bcbcbe7cd75ab6009 Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Sun, 11 Oct 2015 22:11:03 -0300
Subject: [PATCH 283/687] Remove error unit test so pull request can proceed.
 Will check this at at later date

---
 .../LazyLoadedSingletonThreadSafetyTest.java  | 30 -------------------
 1 file changed, 30 deletions(-)

diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index 9b78f446f..45dde2c6f 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -2,15 +2,11 @@ package com.iluwatar.singleton;
 
 import org.junit.Test;
 
-import java.lang.reflect.Constructor;
-import java.lang.reflect.Field;
-import java.lang.reflect.InvocationTargetException;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.concurrent.*;
 
 import static org.junit.Assert.assertEquals;
-import static org.junit.Assert.assertNull;
 
 /**
  * This class provides several test case that test singleton construction.
@@ -71,32 +67,6 @@ public class LazyLoadedSingletonThreadSafetyTest {
         }
     }
 
-    @Test
-    @SuppressWarnings("unchecked")
-    public void test_HoleInSingletonCreationIfUsingReflection() throws ClassNotFoundException, NoSuchMethodException, IllegalAccessException, InvocationTargetException, InstantiationException, NoSuchFieldException {
-        Field f = ThreadSafeLazyLoadedIvoryTower.class.getDeclaredField("instance");
-        f.setAccessible(true);
-
-        {//reflectively create an object - the singleton field is null
-            Class lazyIvoryTowerClazz = Class.forName("com.iluwatar.singleton.ThreadSafeLazyLoadedIvoryTower");
-            Constructor constructor = lazyIvoryTowerClazz.getDeclaredConstructor();
-            constructor.setAccessible(true);
-            ThreadSafeLazyLoadedIvoryTower instance = constructor.newInstance();
-            assertNull(f.get(instance));
-        }
-
-        //instantiate the singleton but when we do the below code we are creating a new object where it is set to null still
-        IvoryTower.getInstance();
-
-        {//reflectively create an object - the singleton field is null as a new object is created
-            Class lazyIvoryTowerClazz = Class.forName("com.iluwatar.singleton.ThreadSafeLazyLoadedIvoryTower");
-            Constructor constructor = lazyIvoryTowerClazz.getDeclaredConstructor();
-            constructor.setAccessible(true);
-            ThreadSafeLazyLoadedIvoryTower instance = constructor.newInstance();
-            assertNull(f.get(instance));
-        }
-    }
-
     private class SingletonCreatingThread implements Callable {
         @Override
         public NullObject call() {

From 64e3e1a9e89140f0f25fc3911a4677e1c3574ca0 Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Sun, 11 Oct 2015 22:16:51 -0300
Subject: [PATCH 284/687] For some reason it thinks there are two fields in the
 CI build. Making this more generic

---
 .../lazy/loading/HolderThreadSafeTest.java    | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
index 90cf7c02c..f27ffc6a9 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
@@ -4,7 +4,6 @@ import org.junit.Test;
 
 import java.lang.reflect.Field;
 
-import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertNotNull;
 import static org.junit.Assert.assertNull;
 
@@ -20,22 +19,24 @@ public class HolderThreadSafeTest {
         HolderThreadSafe hts = new HolderThreadSafe();
 
         {//first call is null
-            Field[] f = HolderThreadSafe.class.getDeclaredFields();
-            assertEquals("One field only in HolderThreadSafe", 1, f.length);
-            f[0].setAccessible(true);
+            Field[] ff = HolderThreadSafe.class.getDeclaredFields();
+            for (Field f: ff) {
+                f.setAccessible(true);
+            }
 
-            assertNull(f[0].get(hts));
+            assertNull(ff[0].get(hts));
         }
 
         // now it is lazily loaded
         hts.getHeavy();
 
         {//now it is not null - call via reflection so that the test is the same before and after
-            Field[] f = HolderThreadSafe.class.getDeclaredFields();
-            assertEquals("One field only in HolderThreadSafe", 1, f.length);
-            f[0].setAccessible(true);
+            Field[] ff = HolderThreadSafe.class.getDeclaredFields();
+            for (Field f: ff) {
+                f.setAccessible(true);
+            }
 
-            assertNotNull(f[0].get(hts));
+            assertNotNull(ff[0].get(hts));
         }
     }
 }

From 0d068a35d802731ac52f226ee6350251418059d4 Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Mon, 12 Oct 2015 05:21:33 -0300
Subject: [PATCH 285/687] Update comment

---
 .../iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java  | 1 -
 1 file changed, 1 deletion(-)

diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index 45dde2c6f..0968cefd3 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -13,7 +13,6 @@ import static org.junit.Assert.assertEquals;
  *
  * 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.
- * The third proves that there is a hole if the singleton is created reflectively
  *
  */
 public class LazyLoadedSingletonThreadSafetyTest {

From 5d970438bfdacae104146ba1399f4c2b453b60e4 Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Mon, 12 Oct 2015 05:22:09 -0300
Subject: [PATCH 286/687] Update comment

---
 .../com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java  | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
index f9b62e798..c50c99e65 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
@@ -4,6 +4,8 @@ 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 class ThreadSafeLazyLoadedIvoryTower {
 

From 7ab799c452a31584e52f1f33535aac80ed0c871e Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Tue, 13 Oct 2015 21:23:32 -0300
Subject: [PATCH 287/687] Synchronise the list as multiple threads are calling
 it

---
 .../singleton/LazyLoadedSingletonThreadSafetyTest.java         | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index 0968cefd3..07f99005e 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -3,6 +3,7 @@ package com.iluwatar.singleton;
 import org.junit.Test;
 
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
 import java.util.concurrent.*;
 
@@ -18,7 +19,7 @@ import static org.junit.Assert.assertEquals;
 public class LazyLoadedSingletonThreadSafetyTest {
 
     private static final int NUM_THREADS = 5;
-    private List threadObjects = new ArrayList<>();
+    private List threadObjects = Collections.synchronizedList(new ArrayList<>());
 
     //NullObject class so Callable has to return something
     private class NullObject{private NullObject(){}}

From e09dda60371d5c03e946b4f68759adef9926b4f2 Mon Sep 17 00:00:00 2001
From: Bernardo Sulzbach 
Date: Sat, 3 Oct 2015 13:02:46 -0300
Subject: [PATCH 288/687] A Warning for beginners in the Readme.

---
 README.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 255fca0f2..ac3aadd67 100644
--- a/README.md
+++ b/README.md
@@ -23,10 +23,16 @@ are familiar with the patterns.
 
 # Getting started
 
-Before you dive into the material, you should be familiar with various 
-[Programming/Software Design Principles](http://webpro.github.io/programming-principles/). 
+Before you dive into the material, you should be familiar with various
+[Programming/Software Design Principles](http://webpro.github.io/programming-principles/).
 
-Once you are familiar with these concepts you can start drilling down into patterns by any of the following approaches
+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.

From 07a77ba11dbdd2cef9c8aafcccb52659bf8c0cbe Mon Sep 17 00:00:00 2001
From: Mike Kobit 
Date: Tue, 13 Oct 2015 20:07:55 -0500
Subject: [PATCH 289/687] Fix - Shutdown the ExecutorService in App so that the
 resources are collected and the process can finish

I ran App.main(String[] args) in the 'double-checked-locking' module and the process does not terminate. This is because the executor service still has open threads. I'm not sure how the JUnit tests are run, but it seems they are handling the leftover resources themselves.

Also, minor modifications to Inventory for final fields are used since there is no state change around them, and added some more meaningful printing so the example is more clearly demonstrated
---
 .../iluwatar/doublechecked/locking/App.java   | 19 ++++++++++++-------
 .../doublechecked/locking/Inventory.java      | 13 ++++++++-----
 2 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
index 80806e9eb..b8d6a41a0 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
@@ -2,6 +2,7 @@ package com.iluwatar.doublechecked.locking;
 
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
+import java.util.concurrent.TimeUnit;
 
 /**
  * 
@@ -26,13 +27,17 @@ public class App {
 		final Inventory inventory = new Inventory(1000);
 		ExecutorService executorService = Executors.newFixedThreadPool(3);
 		for (int i = 0; i < 3; i++) {
-			executorService.execute(new Runnable() {
-				@Override
-				public void run() {
-					while (inventory.addItem(new Item()))
-						;
-				}
-			});
+			executorService.execute(() -> {
+                while (inventory.addItem(new Item()))
+                    ;
+            });
+		}
+
+		executorService.shutdown();
+		try {
+			executorService.awaitTermination(5, TimeUnit.SECONDS);
+		} catch (InterruptedException e) {
+			System.out.println("Error waiting for ExecutorService shutdown");
 		}
 	}
 }
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
index 9f663f272..a58926d9d 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
@@ -12,13 +12,14 @@ import java.util.concurrent.locks.ReentrantLock;
  */
 public class Inventory {
 
-	private int inventorySize;
-	private List items;
-	private Lock lock = new ReentrantLock();
+	private final int inventorySize;
+	private final List items;
+	private final Lock lock;
 
 	public Inventory(int inventorySize) {
 		this.inventorySize = inventorySize;
-		this.items = new ArrayList(inventorySize);
+		this.items = new ArrayList<>(inventorySize);
+		this.lock = new ReentrantLock();
 	}
 
 	public boolean addItem(Item item) {
@@ -27,7 +28,9 @@ public class Inventory {
 			try {
 				if (items.size() < inventorySize) {
 					items.add(item);
-					System.out.println(Thread.currentThread());
+					System.out.println(Thread.currentThread()
+							+ ": items.size()=" + items.size()
+							+ ", inventorySize=" + inventorySize);
 					return true;
 				}
 			} finally {

From b028f66b0892422faf00f66aa480e4d4e479ed1b Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Mon, 19 Oct 2015 21:01:41 +0300
Subject: [PATCH 290/687] Removed properties

---
 dao/pom.xml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/dao/pom.xml b/dao/pom.xml
index 41ed9315f..69191b94d 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -10,10 +10,6 @@
 	
 	dao
 	
-	
-		
-	
-	
 	
 		
 			junit

From 83c2fbdcd3d58bb600872d4460a776936daabd70 Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Mon, 19 Oct 2015 22:06:35 +0100
Subject: [PATCH 291/687] Add unit test to show that the callback method is
 called.

---
 .../java/com/iluwatar/callback/AppTest.java   | 30 +++++++++++++++----
 1 file changed, 25 insertions(+), 5 deletions(-)

diff --git a/callback/src/test/java/com/iluwatar/callback/AppTest.java b/callback/src/test/java/com/iluwatar/callback/AppTest.java
index aceac1c62..0f7a6f45e 100644
--- a/callback/src/test/java/com/iluwatar/callback/AppTest.java
+++ b/callback/src/test/java/com/iluwatar/callback/AppTest.java
@@ -2,18 +2,38 @@ package com.iluwatar.callback;
 
 import org.junit.Test;
 
-import com.iluwatar.callback.App;
+import static org.junit.Assert.assertEquals;
 
 /**
- * 
- * Application test
+ * 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 AppTest {
 
+    private Integer callingCount = 0;
+
 	@Test
 	public void test() {
-		String[] args = {};
-		App.main(args);
+        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);
+
 	}
 }

From 21a4d7b4c90b8420fbf37ec7d602c1f4975a332e Mon Sep 17 00:00:00 2001
From: Richard Jones 
Date: Mon, 19 Oct 2015 22:07:00 +0100
Subject: [PATCH 292/687] Add unit test to show that the callback method is
 called.

---
 callback/src/main/java/com/iluwatar/callback/SimpleTask.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
index 58f35709f..70b844ce3 100644
--- a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
+++ b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
@@ -9,7 +9,7 @@ public class SimpleTask extends Task {
 
 	@Override
 	public void execute() {
-		System.out.println("Perform some important activity.");
+		System.out.println("Perform some important activity and after call the callback method.");
 	}
 
 }

From ac5c1967df47053402e7201a320e50e6c220cd5c Mon Sep 17 00:00:00 2001
From: JaXt0r 
Date: Sun, 25 Oct 2015 07:11:34 +0100
Subject: [PATCH 293/687] #161 - Publish Subscribe Channel realisation.Heavily
 based on iluwatars Message Channel implementation (#143).

---
 pom.xml                                       |   1 +
 publish-subscribe/.gitignore                  |   1 +
 publish-subscribe/etc/publish-subscribe.png   | Bin 0 -> 27741 bytes
 publish-subscribe/etc/publish-subscribe.ucls  | 218 ++++++++++++++++++
 publish-subscribe/index.md                    |  17 ++
 publish-subscribe/pom.xml                     |  24 ++
 .../com/iluwatar/publish/subscribe/App.java   |  55 +++++
 .../iluwatar/publish/subscribe/AppTest.java   |  17 ++
 8 files changed, 333 insertions(+)
 create mode 100644 publish-subscribe/.gitignore
 create mode 100644 publish-subscribe/etc/publish-subscribe.png
 create mode 100644 publish-subscribe/etc/publish-subscribe.ucls
 create mode 100644 publish-subscribe/index.md
 create mode 100644 publish-subscribe/pom.xml
 create mode 100644 publish-subscribe/src/main/java/com/iluwatar/publish/subscribe/App.java
 create mode 100644 publish-subscribe/src/test/java/com/iluwatar/publish/subscribe/AppTest.java

diff --git a/pom.xml b/pom.xml
index 3064f3c0d..e01dc1001 100644
--- a/pom.xml
+++ b/pom.xml
@@ -80,6 +80,7 @@
 		message-channel
 		fluentinterface
 		reactor
+		publish-subscribe
 	
 
 	
diff --git a/publish-subscribe/.gitignore b/publish-subscribe/.gitignore
new file mode 100644
index 000000000..b83d22266
--- /dev/null
+++ b/publish-subscribe/.gitignore
@@ -0,0 +1 @@
+/target/
diff --git a/publish-subscribe/etc/publish-subscribe.png b/publish-subscribe/etc/publish-subscribe.png
new file mode 100644
index 0000000000000000000000000000000000000000..99867da66b548a6d484d67364d4eb3dbaed3e2f9
GIT binary patch
literal 27741
zcmce;by$>d*ETw$12QNr7=)AzjUpwfbV!G^N=kR<(4j~P($XQ_?GPd$APrJOcX#jm
zhUd}W^BwQ^9`E-Zd++~X?zyj6b*=MU>zY708L`{2`!EOua$7=NSOEgLJ_v!J-MWbe
ze3GP=dKUsQrIrwWuH+cMT4xbLE#`K}*B%Ua^0H-dcTRNS4r8=^5i~+edxVWg%0SrV
zO}ZdTj6qbe5z~ah_&tFAvt{da6aRJX2P7<9?PM5K1#ZQ4GAIX=6a2g|oY1#EL$n_U
zAEr@#>NJ-Ne<_#N;#9(NlD*WRJU-x&k?B&Md9owlw!W5~pTD${bNti6IOhR6ur3HB
zBuupD&gEZO#BeU~k8iJ@Bd@i$^!L|1kYj3Yc-K<_Jdea8BuUo1smm5JB%v%h-#`a}
zcw$_?E?6aq%#D__gg`ct-ym|#a+}LEgd`A%D=RDbO06>{6axYwzjX^ThXyUseu2CO
z`F8mlJQZQVQhLASY_-F7k$J%}1)uuQd%@~(N00KUJC%bb+(aJ`*CB#@uU|vp#JWnG
zUMKb^nEQsN-#f-d3r~gW)>dVx2^-1^6I?yI{!aCl5yt-!<)>dKvEO09d-JsvfjHqi
z`?2w8+C}7>L{clt3z_Wj-wFG|(cc0a_ft_22&?GbyO4H~dYCy@mP&D%!aAGo)S^tH
z*I|$uogQ=X?YBRXyw{*OSR!Hx@WMW3;TpDeA(2IQaLM1VfnxX}k8H|tYL>b9Wmq`w
zP~-3;NFn&Wip9$~Lr3Tk5q=EvtP|Wbi%pf;keh
zpEHV^)CBUozOQ;rY^;Ma$A2emO9=xaOV$L%8C?7mdN5j8wRUda+huBTP~-3HCe_xlk)?@Cf;f^~PVf&1cg}e&)
z2^ZHmiD`Cs$9YvW0#@hD(br^Dgs(w7t(!nCN|rKLR`do``&CHfRxsYH-P{}IedB9F
z-btV!zI{i&J@T)@CDTx8A^0$C2!tP$AQYxu=L2ZW69-&@7ebZg3m{#TH@M$q)PNLd
zVTYH>ggfs2&tCJPJ1pbmkm0r3$P0CtIFLK}WRXBP`c`(zT0%1X??Osp=cuSwU#D)q
zvm>_XZgmM$a@S3cBAw19zMk(c6YtMFC04jOi@N8WAv5+^+WxFM;W`q%
zv)pjL*}=j{0xa~MXpsJ>fAzRfI1jc`@j!yv?L1U@%}Nq$(#!3H#%DE*V_gdvbXnwi
zD5`#rf`i~cGM-Z0$8YDmt^M84YG})2ekIN@wGT
zZtNNGMXkn-)Umy2GCIh}LLX{;l7N)9DrNC-w`0
zvT92<-CZ8Xz2lT_tJ8F0tp%u2gW1u3VMP+s=Rc*91FGX^iGJVL$O&Vlk#(GNzSU9T
z=oV~&2n+^R9|T7C%8mJ%g#u1cyK-+p*T1cd#Nl@w?N|N4T=ygZadEh2!kKvTi+u9H
zkTUSS_kw_H-;g=?_GXdyg2nCOoT@j^roWN;;$i2Z-joRIrK{{J!ESXNy|gQTfr@>{
zT0|h<&)Z(J*??z986=8ayZ?LZkZ@xtJ7y=a@#j5xF3_BvF9QMe+Cwni2i_XCa_1fr4T!qYsN5l0&J&E&F0DiS6D$jTYDn+ekeB0c@k;t;VYS*@@lRG==r)@EJww
zQzl`zp!dcf6QA+)wa*aI*eaI|Xq1F#YCm`!qvHUpdvh`~?WHQFy7}YaK?R%w96#_<
zV(L)NpZDl0JQmiM#0>ZkJ9(NtHde15DNVl(Bk}qyjd+Xj=@rGt{xCvY3f!!Y=M9
zM$I&YY?lS`QGuJ?x*XmJy5T_TKuABLK5TzFFrY&t)Rc*8e5k(?6**3CY#C6)7NZ!1
zp<&1=yH*gY3tqrH3!}6OG&-}T#y{qXq$U
z#DAmN(-B=crsn;}U~s6aPdA=q5(bae7%Oyx$A<3dHH#f(?&SPgC0MA6<-Ia&bxtRIqr$5@ylp(f06#d~m_qB>qk7}=DkH1qYh`t3V)AK<*B
zaK~^q@Yuk;42R&uV+I?V9|uY
z-a|qSN~+4r(%s%UI5=FKpSifW%;e!gAcEI`eX;VdbN1BRPBr>gRaI@NfTP_7M0b~5
zLqns}K=Gt^s>z>|gX6mD=kH^515OP4~-`gi9ChFZzTm@>z8ayt#x@6>)(IAk!Y~b=9OrlLO
zVgTB(0~FzDHKXw`e(oC}dvjoUa**|ZJ!HQDJVdi3zG=t}YL)_2xM!K*;lu=4hZmr<
z+W?M8zMGMmxlz5s{OLNN(fbI%L>_lPiObUf&v)*zU?}M8-a)rl?J8}r1@fl@dJ-A{^?r~QqW^2@CbfLMy26_
z(O6DmaqOD)4JhsV7(i^Ek}np3!J-s4*L+oU%ahzbV~@{~$UZFs;X)Sm)u>|W=cY{z
zmU%JITu<#9rvW++epSoMP=;4#KdR=S8!N~#Ru@H^s^@udt30nydb;*XS$vbX(`+xkjBpR}Takj!HafSFG;f}{=m605)RF;F
z1FLkje!TbJp%3j|=i1tcD$p+_K?S6Z!OYVa|IZ;v@uj{Zl2KM|8t;U)nnu$GG(O$Z
zK6ExsENm?IB>mN`vYe&Dmw&4B|JF$0T<@Cy%IP^$g6a|ADaql#s;K~r&sxv#x{f56v&-aE%u
zP}9{@!v&gZjljL#Xyq%g)=A
zN&5<7o#Sf9y?iM{r5&thO*5>DkY9%W>q*AA4k)KCsTU`v2r(K);kln8-2r(zZ)@yrh69O9Rs7W8>p;Xvc@mEvP$pt8xEr!`2-{Gy51YODZG9Dx$
z$hDq1xgO0D6!6h#JFiq&I3ylMM)4o4o@TO)GxfGIC*nI1mJJ9?=wp!#CMvHsiYZzS
zNS=80#c;$6BU4w1Qc=jAXI@8(M=Qof$FJ(GDWx))S}Mw4rhj-Q^@H6>OR-K6dLNwd
z4me?$Uk(a`yw+@)K`dJPo-oqmbieFDx7%Xq#tB=TpnI^3!fLMjoK2Ym$TN2i1vrct)i@(G^5RGzVEY}FMLpIjrW%uJiTA8vY>jOc
zq8#jjF*k_qkSpfb}4$fj999!V0!GyI5K=V%o%|AdExlwI9|D$OwqON9g06LIL6`&554bCSnSg+?5_b>pn6v4a(S%!fJ(NkO5R>H)y2^+Cc7LRGFNxrkN;7kAjl@AkaZoKv!jO3iu
zgj(d)ecLgQTxto+oxiObp#9XXXC0NB%20Vuy2Ko5Am2z0%a@H6TD5_C=-qpg&a)cZ
z{2x)~wvA}}+GLf>aoA@Z_Z{r5NgkJj_8r-6i7I}nV)r(sHOroE#=l2JBVlcT55h18
z(Y@){5>%2J=6tPMNJN^NJOLJyD9qWwMqG?^#RvCbRL|&a_@Gd8Kd+c
z0;45KTvT&Ivyt8A^G~6rqwjxY3@Dc2o>loAk}dBU)GeTP)7Ju|rUZ0ztWTrm>s5-b
zQfzc^du>9<6RlQKU&(T!a#9bwJ=L~fn{<_|;v>#9`V~R|xmd%BCj|H78Jmw${V
z43UaTYm@!+|Nlucc(PxYdyN%snuz|G86D!e3fSI5w*CG6`T2RjXK8&)vr6}X)Vdc;
zRt*@Lm^!<=aqPss1BrmtM&Rx#-i-y0VzTHanS`J;%&cwtJjQ^72*DwK26Wq*x1I#ruhXJ1hOc=
z7yYDPpf1r^8MqWb0}BfaW8>xHy_HmAUoa=Uoa~F5x_WFPUNpJgsJH-9j-Oa+pr2p#S9~p!fmz4CG
zavbdMKVc;Jvu}wu-Wwng0bwPe47|9wI7LOp&%_`ndbKj)($TfDva+ASB0x|{21gg<
z<@WuDa+>>$%La#rcHsB^jQaR%US8SgTKpxodG*dMU|3*q?mK@447a}R_25#P_<%G6
zrZ=aW9z1w(6m^NdFQo$i^y$<5!om&%`JbWXSJ&3q<2n-(65`uI;`CpmSD`n8#(ydC
zJBBqw#(U*;7dW!{UYER}F<=^kWmcUvlV-LjO=Qa?PlO+8KBLEc1|=ta6P`vA=JewL
z3drCooD2BcPaY9m&G01(v?(fv%B&(~&lt_EvNsq
zp{4(sIU1DMqqM|LplN=JA3O@3WlQU)X$LyLy1b;
z7v~;g5u{OXMIzr2(cFMQVx$3A5J%vLl^gm<0caI4r@FejHys0fv8@C4G`1V`ynTug
z$m?D(a9{=@G}s#R%qS*14NCf!0xq=48P&K*c$3M1NC5gbHBx}(WQP3WP&bs%pzUCA
z@YC>>`S~*u|FIFF8PR&Cqw<)zxEjl;#zK)lVdeGB(rq)VhPFZ|NHSeT8oIu|zBPLu
z_#{zdmv1bN#w9a)88yO-tE%W2T^$@$PmCKTi3_m*@yzdGV`D{md2FYFDJJ0W+rNE_
z5y5BE1JcWYeB=y(E#Lic6H6AqH!&$mM_s*_jB-C%l`WeZpd~&78+~om$mj}i6+ApV
zJ*`2vIt}`6`_#ag_XEy~`~hA=2?F?gZ*tjYlRu7yscADA14g43l=cQl>0ASNg2)?8
zt_B7Mc6RLhg50>~bX*jm?cV`>DXrCT%CI|8OH)(YI{CrP3c`3?FkHca@kC#gZ#JBb
zHoP?IHGilHzj_DszmOo4sXFa~adTSUc9;*=)jXGE#VuSS_t_s|9;dAywOijG5Rkov
zHu@q6(0~A34H8rwH?cepY9`P8Jr4cba6Ts`5yNC|f)o@G?>;7GXFG60f`rDrL^uI5
zMEpAV+4tA%p+gdBDGF4`8F9dSeSW!JPs4!H-iZSbDNNt>2M_t+T-n1Qa+HSKPC}Ld
zgX0vGTr~3Y{s~EY(`fI)3
zh)mhD5kFNFP!D{?1>=_n*^Nhp)fS$+()9?Ov5HaILIGVi?R5^s9Qm@Dp#$ZY!#v-$
z*%Ml}zY{!CLt@~M6@KMxa~}!8xMuneEs(PFL(R$dVOPG-H-e=9q#_6|Ns_Bw5M-mu
zJ&kEJ80OYSE8!O9kKjQvmIIDdavJll6DgpLwA;ar1aQ
zXF^Fx`^mKl3I<6g4)r>AGctWc%KxZ=p0|OlOR>xvW9A^HwMCwUwmCGiZ7>;P_bkXDF~Pj+E{%n(yT#t^}kd;z*JlkPybeTL=c$KT#15=FkZ>@uflI-
zqrP9LahZ~-)>en*g#ER(HZhbz$@$
z|GuCO_1J8mX{=pHJU{*1VVFlv@313Lr6{0pb#g0~lIq7VL<|~cWv5%V3aJLuRbH|-zb)lqEGoIhh6C1-J
zoBh0P_NXDGC#m)Cj(}R~jLS}D;^}VtcZWPxo%4a?3LU52c9ulWT2#dwxR>SohrhR%
z`3v1B6*t|ui`FU+^y|*T>M;t*RFcl1k&Qc_5Ik+i!yj86h$m?8?S+{CmBb<8>0)o&
zOb2a};~L#ouSSDg%}#UXSL*ZlV^NLM16^X-s?m9hL1}b-KfhU<`P|03c%$5V_f;PW
zWFfa%#Uio84m5J^-x~8Lg&Erw{Fqh+b6Q|qSCn_9r9>;T)hNxv%lh^9|x&G?>UzCax7!SkK
z9p0QM7wx36nR={dd++UHnA5Nf4YpS(u7=Hw#0GJ5tm-S$8lFf7IATrtx>zm#Dy$Zm
zEkJL{qyJp6O#j*t>%=f9H~>s8J==W1koR7Y@boOWwM$c*kmbzaK!AVq#}-wvSs1fc
z&FNVu16y79cm41^f@=(>M>n$E1gR%^
zP%eOl)i5V;Z(E+|ZLB-&pR3k7@2M8J+uKbQk>5s4H;lS02yd*{nOM(DhEJ61#u2wL_lR)4H~w|M^gwQ`=H
zheva^-NuUw>}0dg*FA0*L@lpx-@uvF3;h+X)ET86_e`-It?8IRF^IWwo
zVc_}EqvM4bAdU!9>#x;cd*mhhT5EHM#eL=b$pT8!;t5W_;Jv*E}
z`fH+ymC9UtB|d(wZ)G>rM2gRsB+gZaUkdr&Hh88~(JKUY&#g5g<+!YKhiuOEH8oTO
z+_~@7%rAc&oOHW*oMCnlj|0z}D6eYOVTC|`0O{BgCVi#;)CQl!?%_5q|Mqwvd6lF3
zsj6u(Uyes>cH%nm``DK9D9Zw$X9P_ZIu%9--w2!b#S+vNy9+S}9ToEPq9(`7I=;Nh
z{J7u_XUX<5-pfj}px`Q^re6}8k0rMkV57
zl>ym`Ea}(Gea;Mt!Gle=N0`k1(}XELYj!Ln1?bD4W|?kP{irZM5?LB|>ajXtT;G$}
z?2fEJ)O`3#U?A4YH?%(&{L>T28-xL@nMNy(l-QH$YW?!fF!3k(BwHlHrB4Xm{Ohyg
z2j>%?8sw~QYhWWfjMzZzvjxfz$TN(?4R5?7!@j@WH@ZtV1Ft0MRzZv*o!}HS;E~h@
z07xLIi0ChU1dW|LJ3gXM&BVJiCg44q&}MeA_#_#%O|CwwVqeXH1A(~9S$ggQMU=OF
zS@N6asud6rfJ9jMSG120Du6b5v;C)9P0s*T|;J86A)n0;aLyrMI@*gP?
z6pHcBtOt<=K492+>u&TG?2r&h
zU>$(U6_77Z*1P4Yn7n)U&cq})`8)8A{ME+gH=n={_g02{&B*y(U&T0N_Ni%U-C@?Y
zodK`~9NYDQ=e+?7kx^087<#7?n+VJOq(;BM5M2(_(mjHeTBL2
zEe{;jF7SCAXL>kKHwP{)y(`KbF%5cuveDq7uMefefWT?N1ps1x-dw$5=JI8+{*m`R
z$ixRG17+?E47~<<$*?nJ+eiO)`Qb
z$vWubvJ|ky*Yeo3LJkyMd2dIxkA$@sbswgV=X;0{Y5_eG)!eL-Txtov_(wVGnp?{x
zcAqFxma3(eU6lfyPSTYugIii!RB~zl?nCh-ScPAc`-~+Mn;iKo4}i0t#m^gVeN0rK
z|4V2^#9k#e?)M(@0i!6q@7;veuerWh*(aEo8=dbzBkTmQRpXVP0PfaA@7Q2cQ&EHG
zU#3D0gsqQ{L5+i1nLT
zZ-b96OZdrL&7?82qGo9dmJfi$^&tkZrXS$|J@df4lH$$$LH$7;GBaBio*-jrWhGyG
zmcoz%AUX&f1Y&yM0Vljz3_Z^ZGqrC%KCb>zRa_iylm5MVaBy&>#PDEal0{Qf(?2CQ
z6^wI{AVF6AMpt(R(EWx}w+lY~Ay6D|i=fTS%-qQz<{B9tB_OBACgFNGF|@pF+%r)0
zF722*<2Jx2sAObJXrY8F?^7~6`dzq!lY9PpNs%BcaAsRGZcZ(?2`m|KOsqF%9C3ij
z9;sT6?Vh-8-4m*Dt_6hQZ5lDWaj~f&!WB@-Y#vxSgng`cx()C#Nu*Yp6n9CZWxB$g{GR?
zlI=5YW>R5yLIUYQH$Yjqo$M(xpka!^ePCRL+c{iDpU
z>VfaWsQ~g|J;ahq=FrC+-MfBWmfJ)szeEv;xsu_6$f2J!@9|ez@(_l~Mdx4nKaiCJ
zM3`rI$t9CF_l_EmA-=N13qvPo8Er}^tZ$VN=qnBvravs^cB8s0fIY$zmtUw5yuuU2?3E(ZnI&D@YtaRx{yZLs((XP+8{KFYc>kbG|+&<3e@y
zG}B+4dg&|et?i40TEvjv#$B40kQhsVp8P7-hcUc9LJ?rD^VkDd~Vp(`6Aa$2^uM=8fzuc}TLI}x1
z$D`PEAF{V_pbGJ_t*E}Po?6Lm)`(6!?rh^@1`^3MOkBH6LC^_EL45&!$vl6*o&BpeY-<1idtI43lWB`cv
z&}Cc6a#Cns2s_$Vv-P3T;~yjuw;>QjG75+WA<*X+jeVrJG|6>NZ^u!Gp&5(o4Vpc$JF6HxP8qo=i$i{E&~53&s~E2B=)1
zrwQBz!6ligF=tUYhyJs3d|&6j#2~`Z?m$anJFj1#ow&XJqi*VH#ne^5{nK57@R
z0168Fhy36P)Ngd>G`r#AGwX)UL2c>ow_Fwc(YK+)1q1C!o5y^`t{-2D7n8-N^4@k|
zwF7d$*RE+A)S6!s;5YbhT<#13W9B`HsJLj-#X0R@Bj#ig*pXrgG%FHY#d%eEP%Ck7
z{QBCC;%4pguZ<7t;)OQ=J62%LL0Fg@kX#llJn?`&VvV7Th5n)eF{0z{y@`({S{Fwi
z!F-dvL&OC^yv1)hb~(QKWZ5Whx-J*ayGF-ZfmMyP*GkZ&OV0F#!N6nSn1m<*fDj9(
z!G1k)ufV<_Xt%k-!+7qfZNSVVR2;{B%D*n%BnNh4;1-b3n|S`!z&)U>r0iG3>PUhF
zB~LDIo$zlK21mrRthrKWlXL5G;&|3-yU6=0K);We(sw78(IER3DL??p5PN%jpacZC
zVtETl%w})V9qJ@GPqC4oAQxmc%fq7<{JR_8ogIygkOxq24<9kvM4k2~@s`;=u2b9E
zhRAqLbO)U7GtxPllG@Hat?p3ZMwXb|cvkylU+Owt#l%oD7||u0PESvJdllyY%t8A*
z*TMa;ji7>euP81Fx2@ggXemj3VnKsbEh
zbD18@TsO)K(3`6|{mIf?o{n;u*q+6ew-kBxAknyEg3-j`SKisHM|{$RW5Lo4&#e?|
z+#+7-6{$d<R;JQw*X85d?IpH)o^D8gQ*K-8`
z^id}8*E_#EGR)EN?{4~#7(mHTx%R6F#w=D4(Fp}wn%QIcd=M_qOnhk0K-tE#xUiyP
z$dtpu-hLYn7RAKh%OX8?RwmB|FjV|KeQR!aH5b~VQ{ai!dg5YaUz9%#;zw#8Zs<`S?1v!A!|#H>B?~D*^cZg?_iP_KH$T5
z$*cS>OI)vSl){*MyR}aa8gx$E_)0D+Y*y8_CO2Glg;sm!sc(a|)w=|p1~w)p3=P|t
zy8}9z0nW~|?NLLS9OGp?xQs6|O9~-oeK5nS%Ut`g`~Jp~PME8U<;q
zD)Qb!V+qLk7r_YxYX59^*56~g0mBrCcKb@RI8n|t5?ca5S5~~Mg0kUdne$`p4H$pG
ztAjc-7Q*o%J=W`OqeUXO2{i++z#3Hb-(Zc}%b2r4lfY?|Nz;J{2n>%9SJ|EZVXZUp
z??d)2SUx<1DuW-#{zcCl*o1?Dg%R4se6F>iR$De9Ssv<%F)6}#(IiS3dEF2QldlzG
zE{iN1hA&Tott3&
zQh}{e)3TcI+DJGCk;
zDI!uX4J%CtPh?Bx5@#vu130T$oux%#%B$bL=KPMlE%#i>%KSGt@(>kE`{lCB8D#~o
zH+f9&-#cw13Klz7
z@0$BS<1GM^;(48{ot>)}g9vZI_#b1cd09WX>LplzwQdaYR4=NjsqwgQHzAuD98~EU
zpaXhW-{Kde&FL8$itVN?p-qhqKp{6#pN~wC4RsniF%TPwAov{E}#CZ
zp#4@Cpj$>viL??Z>C}-G#Om)y-07rN96Ei))v-oJIyhn2G_-p=%T>8RZq@`KKpYY-
z)HydF-}uHsaIOrpUjpgRGh|(1l~tit>y(OO#k;D=zX_cNH;i*t?z8
zEYr^IS)(1+QHOTtyggHMBjGaz66FYqYC$dsc8H+caDzv~DLfEws6W>BiRz}l&9Nw}
zJ4vw)ht`{P=5c*x#AUnfj)6@o;OzRQdxJmux~$y(8^FN&In7a<4;=gDD;*t+GWGg|
z1ewfoEFZ&6RJq(`9gH6u{mA`RBv=I7@giX{HQ5%1SH7FDm+9^}ld-6+XObR=iN}dK
z8Q#i^$@}dUU;RYUgX=l+P488@DMZ?+bsHi_01#O!s;X{0Cuic3-t%i
zYh
z$UcEOVB>rZNQt{39md1Yw7cEwdvxI@9do3{eXtCI~4i^d-wfPPRX$oHk?<=d1p
z6-X>uo8;34UR2I~_~8wj^&#gM!Ew#PCV7yjeBn_>T~6PW+2uAdCC3W(e26#$0|(Ww
z897rk^u+IY<{BrX2qG(WR{nFog=?wsSV3AJX-vxi&35Wsf?8
zAYJT)-dQL65!o~qQeRkA=4
zlRTz5Im`R+wgTtlF*KE_7@!`@8y=5-o{aIaF!62XL^YQWQ|)7D*x{Z`MT=y}(;JYQ
z*hy^L3v)PM6PM&Cdp-Uhi6QR08jYc~QKfF6Bz-TGlxcHrD?uwTpN2ooBU4FYP3DAW
z7ra7i7;BVwC)o&^8TN^0Q08jofe5Vb^VzkF&Ee}8+do@6JGxJMC4n1ScqhtOLviMB
zN8U@G<#Q;pDj7!SzlC$nihn129cuP_OM_>krl8uPGQyBGBWR6%F09CVQ<*hXU0pbm
zVOiKK!JguGLcM+Tuw@5WQzW+SrkQ;`*gRRiNW0#xWjvBJ$7^Sp2~~Hv(!iGCQ!I2@?F}DaatQeCpS)I
z&i6%_`_$A>*LcbKz`Al+;^Dq*9fp5|ZV#u)_AGxxahgZPz(HsVae+Yl^Q9
zWJenkuCHnfF$=#t+9ozU@3n=QdsGqG?+2_6-Oe^2uh&5e85<3yjh1QePO3Pi-2GK{B_Z-yUTis6$x?P(y
z&h4c)wri9|W0FQN7S90K>s>A6#c@AY($O#uzsGcO)K^{s*YlSv-Q8X1g4AKODI#F=
zV8cfFkP+q}+_4Z>V=n5vv4fl+Ph@4RfL3vn{UVt*3Rhjo<7KT(A@WRJ>b^)P^Z=)H
zzWgMDk*B0?d;{pk%zMoLG<1V;nRRtFkS8p=lry{_-XGp$AUB9et;TfOI0^cHzR1xotAYu1tTaTJitTD7n=+3cD^%63#c?o(M*hT^Sa&Zub2dP63gNEpDQorx}dF*`$lpC}Q
z*$^H0nPaXJmpH$TmY+?3QT-rZYqyJMroO7#Oh7g
zqTD+(=9RjrTdM|6t-bgb1WSApcY@r~%F)j68!vCLh~+oR^&Ifh6)*LOcSQDb8s7BJ
zH4e!~0Z2IMv}1w4$34SlwYROovAun#ahU~ZQ>N-&n#qm+G%g}f*kJoe2t)lHGi)8J
zv_?3fKy&pjp(Z~b44Wfj>KZkBxMFLLEAJCU)c?S8tg
z$aW)>JL(sL+}jIY6q(;y7xv9ihjrN5GWAgQGY0TT?rLeEfs5mebM%W=$$u5=x
zH4^zxvOSK!yA}LcO62jdJU+CUR;IK0#gbrAJniw}^Xkxh3W3(hM{P%Pw={%KM@o*k
zGoCF0iDeu*8LQX3tik1%gShzgCb{@HgZFH*t}*aQ1t29U=$Yue)b^<1pU{V2
z2hWv%narN8^wbEgh1;=(Ov52(rjBKA@Y~Sk$pSI-xH|HOevFb?KPk2fwuobJGP%qx
ztE=7{;L#)yi6!yPrT9>=3nQOj!-;8*tS`g9)BPb7u@Yq0(bt@F{YXrHb9Qe?<*N~R
zQawJL2ORu|BvRyf#N^`qAXuQvaR0*o10TcrNrHuG0H1F~JUw{sApo(piz3TxveTI?
zCMtPrgqUAgH2GD--{_rF5b|0(OPp%jzhmYC`j-^nZgyTBM-hwAhd4%75iw7IYq>#`
zSDkcbnkAG$Ut3_vkB$#73rj`hH0b5(p=l`^}0N2Fhh70EVFIKq@;e%reV@*}~4!j_FKJOgU?PVxVmCaALsjaCCSUE@7n&6SEuE5Xi_p5ao=jh-#xjQ^@{7(;XXKh
zFzK(+-#aJCw->gplvLB>msy>!4@G~wbc=uQIYncPbTUq0Z#Gkv
zquxZ{{YZ6X(tWOnp}|qx^kQ^#miYt1U=!w-OY>xFLY@6oUx&foZ(Z7mWx
z*e=a(%|*!8?nnMO8nl>P=iQ=Xa9bZalGUl!NDI~CrP<~>nn^`Xg=UhzKzjRfQDxaL
zmPr;m_>sg3Bi;PlLgU`6ZdP*UGx5rsh}6?Y`u*M&wJ@Qxuv^Nu#Qsf-q*1iYEe&|U
zwQ3t{C}pB9tU1aV9F!*%yU(R0M(x)9x~|~)6#VejRL*^Nh0W)2-Fq74V=GO7=>TFx
zVpzl-xA&y0qK8$HH@K~Rw;?~CIXRc6F0$G@^|v_w%_K&~Z@+n(Cv*O*3T5y5gUpT8
z!V+C~XCPop`)q$up#HmPLt0bnhdno*0(nap*D@`NEV_D&&(~#e_r90;ww9{Qx}-5ETtf|0C&<+AteM#~ko*p{0IrN~kze;S3vJ_}T<9J&t)SV^
zqijFC%76#_0k0IUs7#fjoosMi{W&KRw)4NeM*!IoYKNdG%eSC-82En-krJ@$*;ah<3r&%im;%;@*}$`n9BYclDNZL1aC4gx}AR
z#BtNK(^%j_!MN;l$+)?2d4PV$ePrm20!2y>kZr6E@-I>y_u4lDv;)Pp9;S8RzS#%f
zG5(R7lZ3j9JD&^Amj}A@nR)k9pC_+7xNO8Pj=Q;5*>u}1l&Kezno4rhSCSxMUDwQn
zv8U|YtYG|U!MA|BOO2`OD}Wbe_PyhXV_;x_P6~a5>GVBF&wFp18~PNFX0;qA$)A)D
zPejG?LbHI{OkhNFbBu?wKzdIYehA9AioUY4p{^h(&7Of1vQ(3{NcP;gVxn6SB#lhw
zy+d^l{@n?1opkF$j!#bf5V#_r_n~cczg~Ga2@3Vs1Jnbw(T#1kP*vz~?WK1tOrEZd
zuFGE>b$ReP?`;?`ClVEie(goQsyuBg#5?>(hf%ajG{qxlcndG-UDS7T93N{e*t`2w
z433VNTNbWH(28>k+^x2jp0mtpZp
zy5lacls6muW7K@A8X&$th71!qoVQqvJ5KhbhPsvR%o?t{Y?P*TLvWI&&+1(X3OIVI*p
z3~;HYrezPtT$Yslm|Q4hhT@QA}0AXL;0jeX*Hwsn=$4(|j5;*S^6UA5%eR_uLJbAP%`u2h)rPMp6Jdmyc
zDDN2aoju{3H4YJ~P!V=522LJ|QT0a^)zL4#yvO83
zvMDf2sC_@?D^;>Y)j?$`2P!0=L#QqRa~wD`aQr4hKCilXaToW
z_czA)&VKyFXmIjB+(@W%N#AIen32KD8^GUMT3WK25c!BG%n;Ma)wnv=<(oAv=Sr;q
zef#Gi)wuBQ?H?_gIzo*AmwY2=XanIc8m{Ozkr=(~e*$SJ0NfojBfiw&#%E8vVd^ud
zOrNG5%T=uCe19IT$X{cQ9bzD=zUlBOR@H7H2#B{Ozpw=1j^C&=rZiT{*$RNZ=16V{
zj=Pv3HosL5Lh$xtW=92bt#$N_-~n0ySrhQS#_uc4E1N7E9~}>9{|(-4P_J9twk{$=tQgv~{HE2mtHB#7)%~(BphL{FB7J
z*{C1**^uuq9N@}N4u^W8RR#~x>22gn|EmjlPe;~^pCv-Cm~{4Gm(l&h9PVIkWW=Xb
zH>|-d3uUg6d-qBhUZ}ui;z;v5vE`H3p8+aEQys_(MQp6EuTM6301W79bQPTSc@`OK
z!0|3Xw|^Y~=yqN4FQLWOHp~ugR*V-EGF^*maqX3hM3h6cmj4J|J|alnc1%r$3;oi3
z*+#Y}2C64}_j-l^pU6ZwWzXkpSrMyo@
z@2diimMw!-fb9U;?$AiE$^0;uZtjqnG|v~8E9Q_%SjM4ecZHm?Df5JFE5e
zNRF@9Yt*6~fG`R3Jkf(wVUq6e!Ah-=octdB&OagFOCtUGq`4kGQ|H&9|K|7jTBbi8
zNs2gF6}RXQ0F#T1`r?{w;Rq(62h
zvI1qtx+UqbgG};^@6k!s4G?jxdP0c(w;@n9x(G43%%*a38vJIM*UYUNjKP4Zskv#Goa*B>;qK-t8a
zzSrDPL)Lo4Z^yHJ&XAzk5I(R7fBdYGAC3PzzoGtSigj-IZ=)IL1qh|GH;twYy}*Wm
zRs#2pIA|1L!t0jyk9Wlv5S<#udb}N~dK{a4ro03oJa(EiaO-kM&(D;#ck|Ds-y~s*
z11s2w4}6b+w>fwH)r5qEu}M!*SA;50GNS1~%j0j!(*&J?7fJa$A{tTR
z<@c=A`liQcPJ}4Ki{m5WbkJ!AIp;Iq{V
zeiQqVyh_qoB3=oJirfFnQT7T-|^hBhF;Hs-0KzwDMwsx
    s(c{+6#Xc&>ImMwHl&y7=u7`
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
xk&%Jtkpd1f
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+          
+              
+              
+            
+              
+              
+          
+        
+        
+      
+    
+      
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/publish-subscribe/index.md b/publish-subscribe/index.md
new file mode 100644
index 000000000..efd40f021
--- /dev/null
+++ b/publish-subscribe/index.md
@@ -0,0 +1,17 @@
+---
+layout: pattern
+title: Publish Subscribe
+folder: publish-subscribe
+permalink: /patterns/publish-subscribe/
+categories: Integration
+tags: Java
+---
+
+**Intent:** When applications communicate using a messaging system they do it by using logical addresses
+of the system, so called Publish Subscribe Channel. The publisher broadcasts a message to all registered Subscriber.
+
+![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.
diff --git a/publish-subscribe/pom.xml b/publish-subscribe/pom.xml
new file mode 100644
index 000000000..04b76690a
--- /dev/null
+++ b/publish-subscribe/pom.xml
@@ -0,0 +1,24 @@
+
+	4.0.0
+	
+		com.iluwatar
+		java-design-patterns
+		1.7.0
+	
+	publish-subscribe
+	
+		
+			org.apache.camel
+			camel-core
+		
+		
+			org.apache.camel
+			camel-stream
+		
+		
+			junit
+			junit
+		
+	
+
\ No newline at end of file
diff --git a/publish-subscribe/src/main/java/com/iluwatar/publish/subscribe/App.java b/publish-subscribe/src/main/java/com/iluwatar/publish/subscribe/App.java
new file mode 100644
index 000000000..1f433f517
--- /dev/null
+++ b/publish-subscribe/src/main/java/com/iluwatar/publish/subscribe/App.java
@@ -0,0 +1,55 @@
+package com.iluwatar.publish.subscribe;
+
+import org.apache.camel.CamelContext;
+import org.apache.camel.builder.RouteBuilder;
+import org.apache.camel.impl.DefaultCamelContext;
+
+/**
+ * 
+ * When 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 (publisher) and consumers (subscriber).
+ * 
    
+ * The sending application doesn't necessarily know what particular applications
+ * 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 different Message Channels. The first
+ * one reads from standard input and delivers messages to Direct endpoints (Publish; Broadcast). The other Message  
+ * Channels are established from the Direct component to different Endpoints (Subscriber). No actual messages are sent, 
+ * only the established routes are printed to standard output.
+ * 
+ */
+public class App {
+
+	/**
+	 * Program entry point
+	 * 
+	 * @param args command line args
+	 * @throws Exception
+	 */
+	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")
+				.multicast()
+				.to("direct:greetings1", "direct:greetings2", "direct:greetings3");
+			}
+		});
+		
+		context.start();
+		context.getRoutes().stream().forEach((r) -> System.out.println(r));
+		context.stop();
+	}
+}
diff --git a/publish-subscribe/src/test/java/com/iluwatar/publish/subscribe/AppTest.java b/publish-subscribe/src/test/java/com/iluwatar/publish/subscribe/AppTest.java
new file mode 100644
index 000000000..743e4200d
--- /dev/null
+++ b/publish-subscribe/src/test/java/com/iluwatar/publish/subscribe/AppTest.java
@@ -0,0 +1,17 @@
+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);
+	}
+}
\ No newline at end of file

From 07faa2f6250e00da02d5927c6c6b198dd12ba44c Mon Sep 17 00:00:00 2001
From: hongsw 
Date: Wed, 28 Oct 2015 09:55:05 +0800
Subject: [PATCH 294/687] #271 implements producer-consumer

---
 pom.xml                                       |   1 +
 producer-consumer/etc/producer-consumer.png   | Bin 0 -> 27122 bytes
 producer-consumer/etc/producer-consumer.ucls  |  74 ++++++++++++++++++
 producer-consumer/index.md                    |  22 ++++++
 producer-consumer/pom.xml                     |  18 +++++
 .../com/iluwatar/producer/consumer/App.java   |  57 ++++++++++++++
 .../iluwatar/producer/consumer/Consumer.java  |  24 ++++++
 .../com/iluwatar/producer/consumer/Item.java  |  27 +++++++
 .../iluwatar/producer/consumer/ItemQueue.java |  27 +++++++
 .../iluwatar/producer/consumer/Producer.java  |  29 +++++++
 .../com/iluwatar/poison/pill/AppTest.java     |  20 +++++
 11 files changed, 299 insertions(+)
 create mode 100644 producer-consumer/etc/producer-consumer.png
 create mode 100644 producer-consumer/etc/producer-consumer.ucls
 create mode 100644 producer-consumer/index.md
 create mode 100644 producer-consumer/pom.xml
 create mode 100644 producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
 create mode 100644 producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
 create mode 100644 producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java
 create mode 100644 producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java
 create mode 100644 producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
 create mode 100644 producer-consumer/src/test/java/com/iluwatar/poison/pill/AppTest.java

diff --git a/pom.xml b/pom.xml
index 4cb30df3f..0222d7e37 100644
--- a/pom.xml
+++ b/pom.xml
@@ -56,6 +56,7 @@
 		execute-around
 		property
 		intercepting-filter
+		producer-consumer
 		poison-pill
 		lazy-loading
 		service-layer
diff --git a/producer-consumer/etc/producer-consumer.png b/producer-consumer/etc/producer-consumer.png
new file mode 100644
index 0000000000000000000000000000000000000000..e8bc573b388fe73e5a88d0f690d5c22cbbe8f700
GIT binary patch
literal 27122
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
Ux~Sk@72)4ykP6o_CGU9rA6j$#g8%>k

literal 0
HcmV?d00001

diff --git a/producer-consumer/etc/producer-consumer.ucls b/producer-consumer/etc/producer-consumer.ucls
new file mode 100644
index 000000000..aa1ee80c0
--- /dev/null
+++ b/producer-consumer/etc/producer-consumer.ucls
@@ -0,0 +1,74 @@
+
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/producer-consumer/index.md b/producer-consumer/index.md
new file mode 100644
index 000000000..58dc45e0d
--- /dev/null
+++ b/producer-consumer/index.md
@@ -0,0 +1,22 @@
+---
+layout: pattern
+title: Producer Consumer
+folder: producer-consumer
+permalink: /patterns/producer-consumer/
+categories: Other
+tags: Java
+---
+
+**Intent:** 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..
+
+
+
+![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
+
diff --git a/producer-consumer/pom.xml b/producer-consumer/pom.xml
new file mode 100644
index 000000000..475c7fb6c
--- /dev/null
+++ b/producer-consumer/pom.xml
@@ -0,0 +1,18 @@
+
+
+  4.0.0
+  
+    com.iluwatar
+    java-design-patterns
+    1.7.0
+  
+  producer-consumer
+  
+    
+      junit
+      junit
+      test
+    
+  
+
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
new file mode 100644
index 000000000..50d94d92f
--- /dev/null
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/App.java
@@ -0,0 +1,57 @@
+package com.iluwatar.producer.consumer;
+
+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 {
+
+  /**
+   * 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) {
+      System.out.println("Error waiting for ExecutorService shutdown");
+    }
+  }
+}
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
new file mode 100644
index 000000000..8bb3b75b6
--- /dev/null
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Consumer.java
@@ -0,0 +1,24 @@
+package com.iluwatar.producer.consumer;
+
+/**
+ * Class responsible for consume the {@link Item} produced by {@link Producer}
+ */
+public class Consumer {
+
+  private final ItemQueue queue;
+
+  private final String name;
+
+  public Consumer(String name, ItemQueue queue) {
+    this.name = name;
+    this.queue = queue;
+  }
+
+  public void consume() throws InterruptedException {
+
+    Item item = queue.take();
+    System.out.println(String.format("Consumer [%s] consume item [%s] produced by [%s]", name,
+        item.getId(), item.getProducer()));
+
+  }
+}
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java
new file mode 100644
index 000000000..8d5be69a1
--- /dev/null
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Item.java
@@ -0,0 +1,27 @@
+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;
+  }
+
+}
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java
new file mode 100644
index 000000000..8d41fb456
--- /dev/null
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/ItemQueue.java
@@ -0,0 +1,27 @@
+package com.iluwatar.producer.consumer;
+
+import java.util.concurrent.LinkedBlockingQueue;
+
+/**
+ * Class as a channel for {@link Producer}-{@link Consumer} exchange.
+ */
+public class ItemQueue {
+
+  private LinkedBlockingQueue 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();
+  }
+
+}
diff --git a/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
new file mode 100644
index 000000000..40e71c607
--- /dev/null
+++ b/producer-consumer/src/main/java/com/iluwatar/producer/consumer/Producer.java
@@ -0,0 +1,29 @@
+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 = 0;
+
+  public Producer(String name, ItemQueue queue) {
+    this.name = name;
+    this.queue = queue;
+  }
+
+  public void produce() throws InterruptedException {
+
+    Item item = new Item(name, itemId++);
+    queue.put(item);
+    Random random = new Random();
+    Thread.sleep(random.nextInt(2000));
+  }
+}
diff --git a/producer-consumer/src/test/java/com/iluwatar/poison/pill/AppTest.java b/producer-consumer/src/test/java/com/iluwatar/poison/pill/AppTest.java
new file mode 100644
index 000000000..26b38dec0
--- /dev/null
+++ b/producer-consumer/src/test/java/com/iluwatar/poison/pill/AppTest.java
@@ -0,0 +1,20 @@
+package com.iluwatar.poison.pill;
+
+import org.junit.Test;
+
+import com.iluwatar.producer.consumer.App;
+
+/**
+ * 
+ * Application test
+ *
+ */
+public class AppTest {
+
+  @Test
+  public void test() throws Exception {
+    String[] args = {};
+    App.main(args);
+
+  }
+}

From 9891c2e17b131ba16c168059c4881f9bfb3b2efc Mon Sep 17 00:00:00 2001
From: waisuan 
Date: Wed, 28 Oct 2015 23:55:47 +0800
Subject: [PATCH 295/687] Issue #273:Caching Patterns [new pattern]

---
 caching/.gitignore                            |   1 +
 caching/etc/caching.png                       | Bin 0 -> 51452 bytes
 caching/etc/caching.ucls                      | 106 +++++++++++++
 caching/index.md                              |  24 +++
 caching/pom.xml                               |  51 ++++++
 .../src/main/java/com/wssia/caching/App.java  | 100 ++++++++++++
 .../java/com/wssia/caching/AppManager.java    |  65 ++++++++
 .../java/com/wssia/caching/CacheStore.java    | 104 +++++++++++++
 .../java/com/wssia/caching/CachingPolicy.java |  20 +++
 .../java/com/wssia/caching/DBManager.java     |  92 +++++++++++
 .../main/java/com/wssia/caching/LRUCache.java | 146 ++++++++++++++++++
 .../java/com/wssia/caching/UserAccount.java   |  47 ++++++
 .../test/java/com/wssia/caching/AppTest.java  |  41 +++++
 pom.xml                                       |   1 +
 14 files changed, 798 insertions(+)
 create mode 100644 caching/.gitignore
 create mode 100644 caching/etc/caching.png
 create mode 100644 caching/etc/caching.ucls
 create mode 100644 caching/index.md
 create mode 100644 caching/pom.xml
 create mode 100644 caching/src/main/java/com/wssia/caching/App.java
 create mode 100644 caching/src/main/java/com/wssia/caching/AppManager.java
 create mode 100644 caching/src/main/java/com/wssia/caching/CacheStore.java
 create mode 100644 caching/src/main/java/com/wssia/caching/CachingPolicy.java
 create mode 100644 caching/src/main/java/com/wssia/caching/DBManager.java
 create mode 100644 caching/src/main/java/com/wssia/caching/LRUCache.java
 create mode 100644 caching/src/main/java/com/wssia/caching/UserAccount.java
 create mode 100644 caching/src/test/java/com/wssia/caching/AppTest.java

diff --git a/caching/.gitignore b/caching/.gitignore
new file mode 100644
index 000000000..b83d22266
--- /dev/null
+++ b/caching/.gitignore
@@ -0,0 +1 @@
+/target/
diff --git a/caching/etc/caching.png b/caching/etc/caching.png
new file mode 100644
index 0000000000000000000000000000000000000000..e69df17ea47351789cce03c927b20c2c0ab88be1
GIT binary patch
literal 51452
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
+  
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+        
+          
+            
+          
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+          
+            
+          
+        
+        
+      
+    
+      
+        
+      
+    
+  
+
\ No newline at end of file
diff --git a/caching/index.md b/caching/index.md
new file mode 100644
index 000000000..f79f13e42
--- /dev/null
+++ b/caching/index.md
@@ -0,0 +1,24 @@
+---
+layout: pattern
+title: Caching
+folder: caching
+permalink: /patterns/caching/
+categories: Other
+tags:
+ - Java
+---
+
+**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)
diff --git a/caching/pom.xml b/caching/pom.xml
new file mode 100644
index 000000000..180320eea
--- /dev/null
+++ b/caching/pom.xml
@@ -0,0 +1,51 @@
+
+
+  4.0.0
+  
+    com.iluwatar
+    java-design-patterns
+    1.7.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
+        
+          true
+        
+      
+    
+  
+
diff --git a/caching/src/main/java/com/wssia/caching/App.java b/caching/src/main/java/com/wssia/caching/App.java
new file mode 100644
index 000000000..afdbd7d58
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/App.java
@@ -0,0 +1,100 @@
+package main.java.com.wssia.caching;
+
+/**
+ *
+ * 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 three 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, and
+ * write-behind which writes data into the cache initially whilst the data is only
+ * written into the DB when the cache is full. The read-through strategy is also
+ * included in the mentioned three 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 three
+ * 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 {
+
+  /**
+   * Read-through and write-through
+   */
+  public void useReadAndWriteThroughStrategy() {
+    System.out.println("# CachingPolicy.THROUGH");
+    AppManager.initCachingPolicy(CachingPolicy.THROUGH);
+
+    UserAccount userAccount1 = new UserAccount("001", "John", "He is a boy.");
+
+    AppManager.save(userAccount1);
+    System.out.println(AppManager.printCacheContent());
+    userAccount1 = AppManager.find("001");
+    userAccount1 = AppManager.find("001");
+  }
+
+  /**
+   * Read-through and write-around
+   */
+  public void useReadThroughAndWriteAroundStrategy() {
+    System.out.println("# CachingPolicy.AROUND");
+    AppManager.initCachingPolicy(CachingPolicy.AROUND);
+
+    UserAccount userAccount2 = new UserAccount("002", "Jane", "She is a girl.");
+
+    AppManager.save(userAccount2);
+    System.out.println(AppManager.printCacheContent());
+    userAccount2 = AppManager.find("002");
+    System.out.println(AppManager.printCacheContent());
+    userAccount2 = AppManager.find("002");
+    userAccount2.setUserName("Jane G.");
+    AppManager.save(userAccount2);
+    System.out.println(AppManager.printCacheContent());
+    userAccount2 = AppManager.find("002");
+    System.out.println(AppManager.printCacheContent());
+    userAccount2 = AppManager.find("002");
+  }
+
+  /**
+   * Read-through and write-behind
+   */
+  public void useReadThroughAndWriteBehindStrategy() {
+    System.out.println("# 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);
+    System.out.println(AppManager.printCacheContent());
+    userAccount3 = AppManager.find("003");
+    System.out.println(AppManager.printCacheContent());
+    UserAccount userAccount6 = new UserAccount("006", "Yasha", "She is an only child.");
+    AppManager.save(userAccount6);
+    System.out.println(AppManager.printCacheContent());
+    userAccount4 = AppManager.find("004");
+    System.out.println(AppManager.printCacheContent());
+  }
+}
diff --git a/caching/src/main/java/com/wssia/caching/AppManager.java b/caching/src/main/java/com/wssia/caching/AppManager.java
new file mode 100644
index 000000000..96b5fbdc8
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/AppManager.java
@@ -0,0 +1,65 @@
+package main.java.com.wssia.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 class AppManager {
+
+  private static CachingPolicy cachingPolicy;
+
+  public static void init() {
+    try {
+      DBManager.connect();
+    } catch (ParseException e) {
+      e.printStackTrace();
+    }
+  }
+
+  public static void initCachingPolicy(CachingPolicy policy) {
+    cachingPolicy = policy;
+    if (cachingPolicy == CachingPolicy.BEHIND) {
+      Runtime.getRuntime().addShutdownHook(new Thread(new Runnable() {
+        @Override
+        public void run() {
+          CacheStore.flushCache();
+        }
+      }));
+    }
+    CacheStore.clearCache();
+  }
+
+  public static void initCacheCapacity(int capacity) {
+    CacheStore.initCapacity(capacity);
+  }
+
+  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);
+    }
+    return null;
+  }
+
+  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);
+    }
+  }
+
+  public static String printCacheContent() {
+    return CacheStore.print();
+  }
+}
diff --git a/caching/src/main/java/com/wssia/caching/CacheStore.java b/caching/src/main/java/com/wssia/caching/CacheStore.java
new file mode 100644
index 000000000..edb644bdb
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/CacheStore.java
@@ -0,0 +1,104 @@
+package main.java.com.wssia.caching;
+
+import java.util.ArrayList;
+
+/**
+ *
+ * The caching strategies are implemented in this class.
+ *
+ */
+public class CacheStore {
+
+  static LRUCache cache = null;
+
+  public static void initCapacity(int capacity) {
+    if (null == cache)
+      cache = new LRUCache(capacity);
+    else
+      cache.setCapacity(capacity);
+  }
+
+  public static UserAccount readThrough(String userID) {
+    if (cache.contains(userID)) {
+      System.out.println("# Cache Hit!");
+      return cache.get(userID);
+    }
+    System.out.println("# Cache Miss!");
+    UserAccount userAccount = DBManager.readFromDB(userID);
+    cache.set(userID, userAccount);
+    return userAccount;
+  }
+
+  public static void writeThrough(UserAccount userAccount) {
+    if (cache.contains(userAccount.getUserID())) {
+      DBManager.updateDB(userAccount);
+    } else {
+      DBManager.writeToDB(userAccount);
+    }
+    cache.set(userAccount.getUserID(), userAccount);
+  }
+
+  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);
+    }
+  }
+
+  public static UserAccount readThroughWithWriteBackPolicy(String userID) {
+    if (cache.contains(userID)) {
+      System.out.println("# Cache Hit!");
+      return cache.get(userID);
+    }
+    System.out.println("# Cache Miss!");
+    UserAccount userAccount = DBManager.readFromDB(userID);
+    if (cache.isFull()) {
+      System.out.println("# Cache is FULL! Writing LRU data to DB...");
+      UserAccount toBeWrittenToDB = cache.getLRUData();
+      DBManager.upsertDB(toBeWrittenToDB);
+    }
+    cache.set(userID, userAccount);
+    return userAccount;
+  }
+
+  public static void writeBehind(UserAccount userAccount) {
+    if (cache.isFull() && !cache.contains(userAccount.getUserID())) {
+      System.out.println("# Cache is FULL! Writing LRU data to DB...");
+      UserAccount toBeWrittenToDB = cache.getLRUData();
+      DBManager.upsertDB(toBeWrittenToDB);
+    }
+    cache.set(userAccount.getUserID(), userAccount);
+  }
+
+  public static void clearCache() {
+    if (null != cache)
+      cache.clear();
+  }
+
+  /**
+   * Writes remaining content in the cache into the DB.
+   */
+  public static void flushCache() {
+    System.out.println("# flushCache...");
+    if (null == cache)
+      return;
+    ArrayList listOfUserAccounts = cache.getCacheDataInListForm();
+    for (UserAccount userAccount : listOfUserAccounts) {
+      DBManager.upsertDB(userAccount);
+    }
+  }
+
+  public static String print() {
+    ArrayList 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();
+  }
+}
diff --git a/caching/src/main/java/com/wssia/caching/CachingPolicy.java b/caching/src/main/java/com/wssia/caching/CachingPolicy.java
new file mode 100644
index 000000000..ee51c0361
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/CachingPolicy.java
@@ -0,0 +1,20 @@
+package main.java.com.wssia.caching;
+
+/**
+ *
+ * Enum class containing the three caching strategies implemented in the pattern.
+ *
+ */
+public enum CachingPolicy {
+  THROUGH("through"), AROUND("around"), BEHIND("behind");
+
+  private String policy;
+
+  private CachingPolicy(String policy) {
+    this.policy = policy;
+  }
+
+  public String getPolicy() {
+    return policy;
+  }
+}
diff --git a/caching/src/main/java/com/wssia/caching/DBManager.java b/caching/src/main/java/com/wssia/caching/DBManager.java
new file mode 100644
index 000000000..20918b22f
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/DBManager.java
@@ -0,0 +1,92 @@
+package main.java.com.wssia.caching;
+
+import java.text.ParseException;
+
+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.
+ *
+ */
+public class DBManager {
+
+  private static MongoClient mongoClient;
+  private static MongoDatabase db;
+
+  public static void connect() throws ParseException {
+    mongoClient = new MongoClient();
+    db = mongoClient.getDatabase("test");
+  }
+
+  public static UserAccount readFromDB(String userID) {
+    if (null == db) {
+      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();
+    UserAccount userAccount =
+        new UserAccount(userID, doc.getString("userName"), doc.getString("additionalInfo"));
+    return userAccount;
+  }
+
+  public static void writeToDB(UserAccount userAccount) {
+    if (null == db) {
+      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()));
+  }
+
+  public static void updateDB(UserAccount userAccount) {
+    if (null == db) {
+      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 (null == db) {
+      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));
+  }
+}
diff --git a/caching/src/main/java/com/wssia/caching/LRUCache.java b/caching/src/main/java/com/wssia/caching/LRUCache.java
new file mode 100644
index 000000000..c69e7e3fd
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/LRUCache.java
@@ -0,0 +1,146 @@
+package main.java.com.wssia.caching;
+
+import java.util.ArrayList;
+import java.util.HashMap;
+
+/**
+ *
+ * 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 {
+
+  class Node {
+    String userID;
+    UserAccount userAccount;
+    Node previous;
+    Node next;
+
+    public Node(String userID, UserAccount userAccount) {
+      this.userID = userID;
+      this.userAccount = userAccount;
+    }
+  }
+
+  int capacity;
+  HashMap cache = new HashMap();
+  Node head = null;
+  Node end = null;
+
+  public LRUCache(int capacity) {
+    this.capacity = capacity;
+  }
+
+  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;
+  }
+
+  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) {
+        System.out.println("# Cache is FULL! Removing " + end.userID + " from cache...");
+        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);
+  }
+
+  public void invalidate(String userID) {
+    System.out.println("# " + userID + " has been updated! Removing older version from cache...");
+    Node toBeRemoved = cache.get(userID);
+    remove(toBeRemoved);
+    cache.remove(userID);
+  }
+
+  public boolean isFull() {
+    return cache.size() >= capacity;
+  }
+
+  public UserAccount getLRUData() {
+    return end.userAccount;
+  }
+
+  public void clear() {
+    head = null;
+    end = null;
+    cache.clear();
+  }
+
+  /**
+   *
+   * Returns cache data in list form.
+   */
+  public ArrayList getCacheDataInListForm() {
+    ArrayList listOfCacheData = new ArrayList();
+    Node temp = head;
+    while (temp != null) {
+      listOfCacheData.add(temp.userAccount);
+      temp = temp.next;
+    }
+    return listOfCacheData;
+  }
+
+  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;
+    }
+  }
+}
diff --git a/caching/src/main/java/com/wssia/caching/UserAccount.java b/caching/src/main/java/com/wssia/caching/UserAccount.java
new file mode 100644
index 000000000..a9fe36f7a
--- /dev/null
+++ b/caching/src/main/java/com/wssia/caching/UserAccount.java
@@ -0,0 +1,47 @@
+package main.java.com.wssia.caching;
+
+/**
+ *
+ * Entity class (stored in cache and DB) used in the application.
+ *
+ */
+public class UserAccount {
+  private String userID;
+  private String userName;
+  private String additionalInfo;
+
+  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;
+  }
+}
diff --git a/caching/src/test/java/com/wssia/caching/AppTest.java b/caching/src/test/java/com/wssia/caching/AppTest.java
new file mode 100644
index 000000000..3a93afecc
--- /dev/null
+++ b/caching/src/test/java/com/wssia/caching/AppTest.java
@@ -0,0 +1,41 @@
+package test.java.com.wssia.caching;
+
+import main.java.com.wssia.caching.App;
+import main.java.com.wssia.caching.AppManager;
+
+import org.junit.Before;
+import org.junit.Test;
+
+/**
+ *
+ * Application test
+ *
+ */
+public class AppTest {
+  App app;
+
+  /**
+   * Setup of application test includes: initializing DB connection and cache size/capacity.
+   */
+  @Before
+  public void setUp() {
+    AppManager.init();
+    AppManager.initCacheCapacity(3);
+    app = new App();
+  }
+
+  @Test
+  public void testReadAndWriteThroughStrategy() {
+    app.useReadAndWriteThroughStrategy();
+  }
+
+  @Test
+  public void testReadThroughAndWriteAroundStrategy() {
+    app.useReadThroughAndWriteAroundStrategy();
+  }
+
+  @Test
+  public void testReadThroughAndWriteBehindStrategy() {
+    app.useReadThroughAndWriteBehindStrategy();
+  }
+}
diff --git a/pom.xml b/pom.xml
index 4cb30df3f..36e43727b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -82,6 +82,7 @@
 		message-channel
 		fluentinterface
 		reactor
+		caching
 	
 
 	

From d0f50099968c685f05afab26bb771fad4ad831ee Mon Sep 17 00:00:00 2001
From: waisuan 
Date: Thu, 29 Oct 2015 00:57:41 +0800
Subject: [PATCH 296/687] Issue #273: Changed DB to internal Java data
 structure to avoid compilation errors + decrease in code coverage

---
 caching/etc/caching.png                       | Bin 51452 -> 56234 bytes
 caching/etc/caching.ucls                      |   2 +-
 caching/pom.xml                               |   6 ++--
 .../java/com/wssia/caching/AppManager.java    |  20 +++++++++---
 .../java/com/wssia/caching/CacheStore.java    |   2 +-
 .../java/com/wssia/caching/DBManager.java     |  30 ++++++++++++++++++
 .../main/java/com/wssia/caching/LRUCache.java |   2 +-
 .../test/java/com/wssia/caching/AppTest.java  |   5 ++-
 8 files changed, 55 insertions(+), 12 deletions(-)

diff --git a/caching/etc/caching.png b/caching/etc/caching.png
index e69df17ea47351789cce03c927b20c2c0ab88be1..6b3b2d0556c51b7c593028b2c9120a00c47716c1 100644
GIT binary patch
literal 56234
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

literal 51452
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  
       
-        
+        
           
             
diff --git a/caching/pom.xml b/caching/pom.xml
index 180320eea..d2284a5f1 100644
--- a/caching/pom.xml
+++ b/caching/pom.xml
@@ -33,8 +33,8 @@
   
   
     
@@ -43,7 +43,7 @@
         maven-surefire-plugin
         2.19
         
-          true
+          false
         
       
     
diff --git a/caching/src/main/java/com/wssia/caching/AppManager.java b/caching/src/main/java/com/wssia/caching/AppManager.java
index 96b5fbdc8..cc3c665c8 100644
--- a/caching/src/main/java/com/wssia/caching/AppManager.java
+++ b/caching/src/main/java/com/wssia/caching/AppManager.java
@@ -15,11 +15,21 @@ public class AppManager {
 
   private static CachingPolicy cachingPolicy;
 
-  public static void init() {
-    try {
-      DBManager.connect();
-    } catch (ParseException e) {
-      e.printStackTrace();
+  /**
+   *
+   * 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();
     }
   }
 
diff --git a/caching/src/main/java/com/wssia/caching/CacheStore.java b/caching/src/main/java/com/wssia/caching/CacheStore.java
index edb644bdb..5eb231cc5 100644
--- a/caching/src/main/java/com/wssia/caching/CacheStore.java
+++ b/caching/src/main/java/com/wssia/caching/CacheStore.java
@@ -42,7 +42,7 @@ public class CacheStore {
     if (cache.contains(userAccount.getUserID())) {
       DBManager.updateDB(userAccount);
       cache.invalidate(userAccount.getUserID()); // Cache data has been updated -- remove older
-      // version from cache.
+                                                 // version from cache.
     } else {
       DBManager.writeToDB(userAccount);
     }
diff --git a/caching/src/main/java/com/wssia/caching/DBManager.java b/caching/src/main/java/com/wssia/caching/DBManager.java
index 20918b22f..0222b5956 100644
--- a/caching/src/main/java/com/wssia/caching/DBManager.java
+++ b/caching/src/main/java/com/wssia/caching/DBManager.java
@@ -1,6 +1,7 @@
 package main.java.com.wssia.caching;
 
 import java.text.ParseException;
+import java.util.HashMap;
 
 import org.bson.Document;
 
@@ -15,18 +16,35 @@ import com.mongodb.client.model.UpdateOptions;
  * 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 class DBManager {
 
   private static MongoClient mongoClient;
   private static MongoDatabase db;
+  private static boolean useMongoDB;
+
+  private static HashMap virtualDB;
+
+  public static void createVirtualDB() {
+    useMongoDB = false;
+    virtualDB = new HashMap();
+  }
 
   public static void connect() throws ParseException {
+    useMongoDB = true;
     mongoClient = new MongoClient();
     db = mongoClient.getDatabase("test");
   }
 
   public static UserAccount readFromDB(String userID) {
+    if (!useMongoDB) {
+      if (virtualDB.containsKey(userID))
+        return virtualDB.get(userID);
+      return null;
+    }
     if (null == db) {
       try {
         connect();
@@ -45,6 +63,10 @@ public class DBManager {
   }
 
   public static void writeToDB(UserAccount userAccount) {
+    if (!useMongoDB) {
+      virtualDB.put(userAccount.getUserID(), userAccount);
+      return;
+    }
     if (null == db) {
       try {
         connect();
@@ -58,6 +80,10 @@ public class DBManager {
   }
 
   public static void updateDB(UserAccount userAccount) {
+    if (!useMongoDB) {
+      virtualDB.put(userAccount.getUserID(), userAccount);
+      return;
+    }
     if (null == db) {
       try {
         connect();
@@ -76,6 +102,10 @@ public class DBManager {
    * 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 (null == db) {
       try {
         connect();
diff --git a/caching/src/main/java/com/wssia/caching/LRUCache.java b/caching/src/main/java/com/wssia/caching/LRUCache.java
index c69e7e3fd..1389a9bca 100644
--- a/caching/src/main/java/com/wssia/caching/LRUCache.java
+++ b/caching/src/main/java/com/wssia/caching/LRUCache.java
@@ -138,7 +138,7 @@ public class LRUCache {
   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.
+               // just clear the cache.
     } else {
       this.capacity = newCapacity;
     }
diff --git a/caching/src/test/java/com/wssia/caching/AppTest.java b/caching/src/test/java/com/wssia/caching/AppTest.java
index 3a93afecc..c2d13ce03 100644
--- a/caching/src/test/java/com/wssia/caching/AppTest.java
+++ b/caching/src/test/java/com/wssia/caching/AppTest.java
@@ -19,7 +19,10 @@ public class AppTest {
    */
   @Before
   public void setUp() {
-    AppManager.init();
+    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();
   }

From 87baa98d2b6cdf937300ecef4f5466b8af68473e Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 02:05:54 -0500
Subject: [PATCH 297/687] Reformat Code According to Google Style Guide #224

---
 .../main/java/com/iluwatar/observer/App.java  | 63 +++++++++----------
 .../java/com/iluwatar/observer/Hobbits.java   | 39 ++++++------
 .../main/java/com/iluwatar/observer/Orcs.java | 39 ++++++------
 .../java/com/iluwatar/observer/Weather.java   | 50 +++++++--------
 .../iluwatar/observer/WeatherObserver.java    |  2 +-
 .../com/iluwatar/observer/WeatherType.java    | 11 ++--
 .../iluwatar/observer/generic/GHobbits.java   | 36 +++++------
 .../com/iluwatar/observer/generic/GOrcs.java  | 38 +++++------
 .../iluwatar/observer/generic/GWeather.java   | 20 +++---
 .../iluwatar/observer/generic/Observable.java | 24 +++----
 .../iluwatar/observer/generic/Observer.java   |  2 +-
 11 files changed, 160 insertions(+), 164 deletions(-)

diff --git a/observer/src/main/java/com/iluwatar/observer/App.java b/observer/src/main/java/com/iluwatar/observer/App.java
index bc4742a14..5f03a9e2b 100644
--- a/observer/src/main/java/com/iluwatar/observer/App.java
+++ b/observer/src/main/java/com/iluwatar/observer/App.java
@@ -6,45 +6,44 @@ import com.iluwatar.observer.generic.GWeather;
 
 /**
  * 
- * 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.
+ * 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.
+ * 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 {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
+  /**
+   * 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 weather = new Weather();
+    weather.addObserver(new Orcs());
+    weather.addObserver(new Hobbits());
 
-		weather.timePasses();
-		weather.timePasses();
-		weather.timePasses();
-		weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
+    weather.timePasses();
 
-		// Generic observer inspired by Java Generics and Collection by Naftalin & Wadler
-		System.out.println("\n--Running generic version--");
-		GWeather gWeather = new GWeather();
-		gWeather.addObserver(new GOrcs());
-		gWeather.addObserver(new GHobbits());
+    // Generic observer inspired by Java Generics and Collection by Naftalin & Wadler
+    System.out.println("\n--Running generic version--");
+    GWeather gWeather = new GWeather();
+    gWeather.addObserver(new GOrcs());
+    gWeather.addObserver(new GHobbits());
 
-		gWeather.timePasses();
-		gWeather.timePasses();
-		gWeather.timePasses();
-		gWeather.timePasses();
-	}
+    gWeather.timePasses();
+    gWeather.timePasses();
+    gWeather.timePasses();
+    gWeather.timePasses();
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/Hobbits.java b/observer/src/main/java/com/iluwatar/observer/Hobbits.java
index d15ce6109..02baaec83 100644
--- a/observer/src/main/java/com/iluwatar/observer/Hobbits.java
+++ b/observer/src/main/java/com/iluwatar/observer/Hobbits.java
@@ -7,24 +7,23 @@ package com.iluwatar.observer;
  */
 public class Hobbits implements WeatherObserver {
 
-	@Override
-	public void update(WeatherType currentWeather) {
-		switch (currentWeather) {
-		case COLD:
-			System.out.println("The hobbits are shivering in the cold weather.");
-			break;
-		case RAINY:
-			System.out.println("The hobbits look for cover from the rain.");
-			break;
-		case SUNNY:
-			System.out.println("The happy hobbits bade in the warm sun.");
-			break;
-		case WINDY:
-			System.out.println("The hobbits hold their hats tightly in the windy weather.");
-			break;
-		default:
-			break;
-		}
-	}
-
+  @Override
+  public void update(WeatherType currentWeather) {
+    switch (currentWeather) {
+      case COLD:
+        System.out.println("The hobbits are shivering in the cold weather.");
+        break;
+      case RAINY:
+        System.out.println("The hobbits look for cover from the rain.");
+        break;
+      case SUNNY:
+        System.out.println("The happy hobbits bade in the warm sun.");
+        break;
+      case WINDY:
+        System.out.println("The hobbits hold their hats tightly in the windy weather.");
+        break;
+      default:
+        break;
+    }
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/Orcs.java b/observer/src/main/java/com/iluwatar/observer/Orcs.java
index 26049bf4b..09ca65211 100644
--- a/observer/src/main/java/com/iluwatar/observer/Orcs.java
+++ b/observer/src/main/java/com/iluwatar/observer/Orcs.java
@@ -7,24 +7,23 @@ package com.iluwatar.observer;
  */
 public class Orcs implements WeatherObserver {
 
-	@Override
-	public void update(WeatherType currentWeather) {
-		switch (currentWeather) {
-		case COLD:
-			System.out.println("The orcs are freezing cold.");
-			break;
-		case RAINY:
-			System.out.println("The orcs are dripping wet.");
-			break;
-		case SUNNY:
-			System.out.println("The sun hurts the orcs' eyes.");
-			break;
-		case WINDY:
-			System.out.println("The orc smell almost vanishes in the wind.");
-			break;
-		default:
-			break;
-		}
-	}
-
+  @Override
+  public void update(WeatherType currentWeather) {
+    switch (currentWeather) {
+      case COLD:
+        System.out.println("The orcs are freezing cold.");
+        break;
+      case RAINY:
+        System.out.println("The orcs are dripping wet.");
+        break;
+      case SUNNY:
+        System.out.println("The sun hurts the orcs' eyes.");
+        break;
+      case WINDY:
+        System.out.println("The orc smell almost vanishes in the wind.");
+        break;
+      default:
+        break;
+    }
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/Weather.java b/observer/src/main/java/com/iluwatar/observer/Weather.java
index c5b03c7a3..634953945 100644
--- a/observer/src/main/java/com/iluwatar/observer/Weather.java
+++ b/observer/src/main/java/com/iluwatar/observer/Weather.java
@@ -5,38 +5,38 @@ import java.util.List;
 
 /**
  * 
- * Weather can be observed by implementing {@link WeatherObserver} interface and
- * registering as listener.
+ * Weather can be observed by implementing {@link WeatherObserver} interface and registering as
+ * listener.
  * 
  */
 public class Weather {
 
-	private WeatherType currentWeather;
-	private List observers;
+  private WeatherType currentWeather;
+  private List observers;
 
-	public Weather() {
-		observers = new ArrayList<>();
-		currentWeather = WeatherType.SUNNY;
-	}
+  public Weather() {
+    observers = new ArrayList<>();
+    currentWeather = WeatherType.SUNNY;
+  }
 
-	public void addObserver(WeatherObserver obs) {
-		observers.add(obs);
-	}
+  public void addObserver(WeatherObserver obs) {
+    observers.add(obs);
+  }
 
-	public void removeObserver(WeatherObserver obs) {
-		observers.remove(obs);
-	}
+  public void removeObserver(WeatherObserver obs) {
+    observers.remove(obs);
+  }
 
-	public void timePasses() {
-		WeatherType[] enumValues = WeatherType.values();
-		currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length];
-		System.out.println("The weather changed to " + currentWeather + ".");
-		notifyObservers();
-	}
+  public void timePasses() {
+    WeatherType[] enumValues = WeatherType.values();
+    currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length];
+    System.out.println("The weather changed to " + currentWeather + ".");
+    notifyObservers();
+  }
 
-	private void notifyObservers() {
-		for (WeatherObserver obs : observers) {
-			obs.update(currentWeather);
-		}
-	}
+  private void notifyObservers() {
+    for (WeatherObserver obs : observers) {
+      obs.update(currentWeather);
+    }
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java b/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java
index 5491da75e..1293214cd 100644
--- a/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java
+++ b/observer/src/main/java/com/iluwatar/observer/WeatherObserver.java
@@ -7,6 +7,6 @@ package com.iluwatar.observer;
  */
 public interface WeatherObserver {
 
-	void update(WeatherType currentWeather);
+  void update(WeatherType currentWeather);
 
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/WeatherType.java b/observer/src/main/java/com/iluwatar/observer/WeatherType.java
index 173a53205..c808368cf 100644
--- a/observer/src/main/java/com/iluwatar/observer/WeatherType.java
+++ b/observer/src/main/java/com/iluwatar/observer/WeatherType.java
@@ -7,11 +7,10 @@ package com.iluwatar.observer;
  */
 public enum WeatherType {
 
-	SUNNY, RAINY, WINDY, COLD;
-
-	@Override
-	public String toString() {
-		return this.name().toLowerCase();
-	}
+  SUNNY, RAINY, WINDY, COLD;
 
+  @Override
+  public String toString() {
+    return this.name().toLowerCase();
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
index ec19d68e1..5dca0e779 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GHobbits.java
@@ -8,23 +8,23 @@ import com.iluwatar.observer.WeatherType;
  *
  */
 public class GHobbits implements Race {
-    @Override
-    public void update(GWeather weather, WeatherType weatherType) {
-        switch (weatherType) {
-            case COLD:
-                System.out.println("The hobbits are shivering in the cold weather.");
-                break;
-            case RAINY:
-                System.out.println("The hobbits look for cover from the rain.");
-                break;
-            case SUNNY:
-                System.out.println("The happy hobbits bade in the warm sun.");
-                break;
-            case WINDY:
-                System.out.println("The hobbits hold their hats tightly in the windy weather.");
-                break;
-            default:
-                break;
-        }
+  @Override
+  public void update(GWeather weather, WeatherType weatherType) {
+    switch (weatherType) {
+      case COLD:
+        System.out.println("The hobbits are shivering in the cold weather.");
+        break;
+      case RAINY:
+        System.out.println("The hobbits look for cover from the rain.");
+        break;
+      case SUNNY:
+        System.out.println("The happy hobbits bade in the warm sun.");
+        break;
+      case WINDY:
+        System.out.println("The hobbits hold their hats tightly in the windy weather.");
+        break;
+      default:
+        break;
     }
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
index 037b88a1d..b279a78c1 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GOrcs.java
@@ -8,24 +8,24 @@ import com.iluwatar.observer.WeatherType;
  *
  */
 public class GOrcs implements Race {
-	
-    @Override
-    public void update(GWeather weather, WeatherType weatherType) {
-        switch (weatherType) {
-            case COLD:
-                System.out.println("The orcs are freezing cold.");
-                break;
-            case RAINY:
-                System.out.println("The orcs are dripping wet.");
-                break;
-            case SUNNY:
-                System.out.println("The sun hurts the orcs' eyes.");
-                break;
-            case WINDY:
-                System.out.println("The orc smell almost vanishes in the wind.");
-                break;
-            default:
-                break;
-        }
+
+  @Override
+  public void update(GWeather weather, WeatherType weatherType) {
+    switch (weatherType) {
+      case COLD:
+        System.out.println("The orcs are freezing cold.");
+        break;
+      case RAINY:
+        System.out.println("The orcs are dripping wet.");
+        break;
+      case SUNNY:
+        System.out.println("The sun hurts the orcs' eyes.");
+        break;
+      case WINDY:
+        System.out.println("The orc smell almost vanishes in the wind.");
+        break;
+      default:
+        break;
     }
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
index cea86bc82..9d1c6ed07 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/GWeather.java
@@ -9,16 +9,16 @@ import com.iluwatar.observer.WeatherType;
  */
 public class GWeather extends Observable {
 
-    private WeatherType currentWeather;
+  private WeatherType currentWeather;
 
-    public GWeather() {
-        currentWeather = WeatherType.SUNNY;
-    }
+  public GWeather() {
+    currentWeather = WeatherType.SUNNY;
+  }
 
-    public void timePasses() {
-        WeatherType[] enumValues = WeatherType.values();
-        currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length];
-        System.out.println("The weather changed to " + currentWeather + ".");
-        notifyObservers(currentWeather);
-    }
+  public void timePasses() {
+    WeatherType[] enumValues = WeatherType.values();
+    currentWeather = enumValues[(currentWeather.ordinal() + 1) % enumValues.length];
+    System.out.println("The weather changed to " + currentWeather + ".");
+    notifyObservers(currentWeather);
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Observable.java b/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
index eaedc7b6e..f1ad2dca6 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/Observable.java
@@ -12,20 +12,20 @@ import java.util.concurrent.CopyOnWriteArrayList;
  */
 public abstract class Observable, O extends Observer, A> {
 
-    protected List observers;
+  protected List observers;
 
-    public Observable() {
-        this.observers = new CopyOnWriteArrayList<>();
-    }
+  public Observable() {
+    this.observers = new CopyOnWriteArrayList<>();
+  }
 
-    public void addObserver(O observer) {
-        this.observers.add(observer);
-    }
+  public void addObserver(O observer) {
+    this.observers.add(observer);
+  }
 
-    @SuppressWarnings("unchecked")
-    public void notifyObservers(A argument) {
-        for (O observer : observers) {
-            observer.update((S) this, argument);
-        }
+  @SuppressWarnings("unchecked")
+  public void notifyObservers(A argument) {
+    for (O observer : observers) {
+      observer.update((S) this, argument);
     }
+  }
 }
diff --git a/observer/src/main/java/com/iluwatar/observer/generic/Observer.java b/observer/src/main/java/com/iluwatar/observer/generic/Observer.java
index 2338f9e98..b01955419 100644
--- a/observer/src/main/java/com/iluwatar/observer/generic/Observer.java
+++ b/observer/src/main/java/com/iluwatar/observer/generic/Observer.java
@@ -10,5 +10,5 @@ package com.iluwatar.observer.generic;
  */
 public interface Observer, O extends Observer, A> {
 
-    void update(S subject, A argument);
+  void update(S subject, A argument);
 }

From 44b7b94da697801ba6c433847fba488e7f7b3ec1 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 02:23:27 -0500
Subject: [PATCH 298/687] Reformatting test case as well

---
 .../src/test/java/com/iluwatar/observer/AppTest.java   | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/observer/src/test/java/com/iluwatar/observer/AppTest.java b/observer/src/test/java/com/iluwatar/observer/AppTest.java
index 38d5c0503..65976626d 100644
--- a/observer/src/test/java/com/iluwatar/observer/AppTest.java
+++ b/observer/src/test/java/com/iluwatar/observer/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.observer.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }

From 6418a6c2b608035c7c00a37308ea6f9da36c5d77 Mon Sep 17 00:00:00 2001
From: waisuan 
Date: Mon, 2 Nov 2015 01:40:38 +0800
Subject: [PATCH 299/687] Issue #273: Fixed issues based on review remarks

---
 .../com/{wssia => iluwatar}/caching/App.java  | 19 ++++++++++++++++++-
 .../caching/AppManager.java                   |  2 +-
 .../caching/CacheStore.java                   |  2 +-
 .../caching/CachingPolicy.java                |  2 +-
 .../caching/DBManager.java                    |  7 +++++--
 .../{wssia => iluwatar}/caching/LRUCache.java |  2 +-
 .../caching/UserAccount.java                  |  2 +-
 .../{wssia => iluwatar}/caching/AppTest.java  |  5 +----
 8 files changed, 29 insertions(+), 12 deletions(-)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/App.java (86%)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/AppManager.java (98%)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/CacheStore.java (98%)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/CachingPolicy.java (90%)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/DBManager.java (98%)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/LRUCache.java (98%)
 rename caching/src/main/java/com/{wssia => iluwatar}/caching/UserAccount.java (96%)
 rename caching/src/test/java/com/{wssia => iluwatar}/caching/AppTest.java (88%)

diff --git a/caching/src/main/java/com/wssia/caching/App.java b/caching/src/main/java/com/iluwatar/caching/App.java
similarity index 86%
rename from caching/src/main/java/com/wssia/caching/App.java
rename to caching/src/main/java/com/iluwatar/caching/App.java
index afdbd7d58..423e0ee80 100644
--- a/caching/src/main/java/com/wssia/caching/App.java
+++ b/caching/src/main/java/com/iluwatar/caching/App.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 /**
  *
@@ -37,6 +37,23 @@ package main.java.com.wssia.caching;
  */
 public class App {
 
+  /**
+   * 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();
+  }
+
   /**
    * Read-through and write-through
    */
diff --git a/caching/src/main/java/com/wssia/caching/AppManager.java b/caching/src/main/java/com/iluwatar/caching/AppManager.java
similarity index 98%
rename from caching/src/main/java/com/wssia/caching/AppManager.java
rename to caching/src/main/java/com/iluwatar/caching/AppManager.java
index cc3c665c8..08132e327 100644
--- a/caching/src/main/java/com/wssia/caching/AppManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/AppManager.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 import java.text.ParseException;
 
diff --git a/caching/src/main/java/com/wssia/caching/CacheStore.java b/caching/src/main/java/com/iluwatar/caching/CacheStore.java
similarity index 98%
rename from caching/src/main/java/com/wssia/caching/CacheStore.java
rename to caching/src/main/java/com/iluwatar/caching/CacheStore.java
index 5eb231cc5..2041ac14f 100644
--- a/caching/src/main/java/com/wssia/caching/CacheStore.java
+++ b/caching/src/main/java/com/iluwatar/caching/CacheStore.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 import java.util.ArrayList;
 
diff --git a/caching/src/main/java/com/wssia/caching/CachingPolicy.java b/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
similarity index 90%
rename from caching/src/main/java/com/wssia/caching/CachingPolicy.java
rename to caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
index ee51c0361..314cfaa36 100644
--- a/caching/src/main/java/com/wssia/caching/CachingPolicy.java
+++ b/caching/src/main/java/com/iluwatar/caching/CachingPolicy.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 /**
  *
diff --git a/caching/src/main/java/com/wssia/caching/DBManager.java b/caching/src/main/java/com/iluwatar/caching/DBManager.java
similarity index 98%
rename from caching/src/main/java/com/wssia/caching/DBManager.java
rename to caching/src/main/java/com/iluwatar/caching/DBManager.java
index 0222b5956..d30ad756b 100644
--- a/caching/src/main/java/com/wssia/caching/DBManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/DBManager.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 import java.text.ParseException;
 import java.util.HashMap;
@@ -12,13 +12,16 @@ 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 class DBManager {
 
diff --git a/caching/src/main/java/com/wssia/caching/LRUCache.java b/caching/src/main/java/com/iluwatar/caching/LRUCache.java
similarity index 98%
rename from caching/src/main/java/com/wssia/caching/LRUCache.java
rename to caching/src/main/java/com/iluwatar/caching/LRUCache.java
index 1389a9bca..872f97256 100644
--- a/caching/src/main/java/com/wssia/caching/LRUCache.java
+++ b/caching/src/main/java/com/iluwatar/caching/LRUCache.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 import java.util.ArrayList;
 import java.util.HashMap;
diff --git a/caching/src/main/java/com/wssia/caching/UserAccount.java b/caching/src/main/java/com/iluwatar/caching/UserAccount.java
similarity index 96%
rename from caching/src/main/java/com/wssia/caching/UserAccount.java
rename to caching/src/main/java/com/iluwatar/caching/UserAccount.java
index a9fe36f7a..eff0878ad 100644
--- a/caching/src/main/java/com/wssia/caching/UserAccount.java
+++ b/caching/src/main/java/com/iluwatar/caching/UserAccount.java
@@ -1,4 +1,4 @@
-package main.java.com.wssia.caching;
+package com.iluwatar.caching;
 
 /**
  *
diff --git a/caching/src/test/java/com/wssia/caching/AppTest.java b/caching/src/test/java/com/iluwatar/caching/AppTest.java
similarity index 88%
rename from caching/src/test/java/com/wssia/caching/AppTest.java
rename to caching/src/test/java/com/iluwatar/caching/AppTest.java
index c2d13ce03..ce5cddf08 100644
--- a/caching/src/test/java/com/wssia/caching/AppTest.java
+++ b/caching/src/test/java/com/iluwatar/caching/AppTest.java
@@ -1,7 +1,4 @@
-package test.java.com.wssia.caching;
-
-import main.java.com.wssia.caching.App;
-import main.java.com.wssia.caching.AppManager;
+package com.iluwatar.caching;
 
 import org.junit.Before;
 import org.junit.Test;

From 998ba7e6e039275a5e08dff5cb07d47eddf2e503 Mon Sep 17 00:00:00 2001
From: waisuan 
Date: Mon, 2 Nov 2015 02:11:58 +0800
Subject: [PATCH 300/687] Issue #273: Fixed HTML tags in comments

---
 .../src/main/java/com/iluwatar/caching/App.java    |  2 +-
 .../main/java/com/iluwatar/caching/DBManager.java  | 14 ++++++--------
 2 files changed, 7 insertions(+), 9 deletions(-)

diff --git a/caching/src/main/java/com/iluwatar/caching/App.java b/caching/src/main/java/com/iluwatar/caching/App.java
index 423e0ee80..c7f55db70 100644
--- a/caching/src/main/java/com/iluwatar/caching/App.java
+++ b/caching/src/main/java/com/iluwatar/caching/App.java
@@ -28,7 +28,7 @@ package com.iluwatar.caching;
  * (depending on the preferred caching policy/strategy).
  *
  * App --> AppManager --> CacheStore/LRUCache/CachingPolicy --> DBManager
- * 
    
+ * 
    
  *
  * @see CacheStore
  * @See LRUCache
diff --git a/caching/src/main/java/com/iluwatar/caching/DBManager.java b/caching/src/main/java/com/iluwatar/caching/DBManager.java
index d30ad756b..07a5daeac 100644
--- a/caching/src/main/java/com/iluwatar/caching/DBManager.java
+++ b/caching/src/main/java/com/iluwatar/caching/DBManager.java
@@ -12,16 +12,14 @@ import com.mongodb.client.model.UpdateOptions;
 
 /**
  *
- * 
    
- * DBManager handles the communication with the underlying data store i.e. Database. It contains the
+ * 
    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
+ * 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()).
- * 
    
+ * during runtime (createVirtualDB()).
    
+ * 
  */
 public class DBManager {
 

From c6ca80b25f0c3b0a3c24086b61563cee38a95413 Mon Sep 17 00:00:00 2001
From: Ilkka Seppala 
Date: Sun, 1 Nov 2015 22:22:31 +0200
Subject: [PATCH 301/687] Bump version number for the next development
 iteration

---
 abstract-factory/pom.xml                       | 2 +-
 adapter/pom.xml                                | 2 +-
 async-method-invocation/pom.xml                | 2 +-
 bridge/pom.xml                                 | 2 +-
 builder/pom.xml                                | 2 +-
 business-delegate/pom.xml                      | 2 +-
 caching/pom.xml                                | 2 +-
 callback/pom.xml                               | 2 +-
 chain/pom.xml                                  | 2 +-
 command/pom.xml                                | 2 +-
 composite/pom.xml                              | 2 +-
 dao/pom.xml                                    | 2 +-
 decorator/pom.xml                              | 2 +-
 dependency-injection/pom.xml                   | 2 +-
 double-checked-locking/pom.xml                 | 2 +-
 double-dispatch/pom.xml                        | 2 +-
 event-aggregator/pom.xml                       | 2 +-
 execute-around/pom.xml                         | 2 +-
 facade/pom.xml                                 | 2 +-
 factory-method/pom.xml                         | 2 +-
 fluentinterface/pom.xml                        | 2 +-
 flux/pom.xml                                   | 2 +-
 flyweight/pom.xml                              | 2 +-
 front-controller/pom.xml                       | 2 +-
 half-sync-half-async/pom.xml                   | 2 +-
 intercepting-filter/pom.xml                    | 2 +-
 interpreter/pom.xml                            | 2 +-
 iterator/pom.xml                               | 2 +-
 layers/pom.xml                                 | 2 +-
 lazy-loading/pom.xml                           | 2 +-
 mediator/pom.xml                               | 2 +-
 memento/pom.xml                                | 2 +-
 message-channel/pom.xml                        | 2 +-
 model-view-controller/pom.xml                  | 2 +-
 model-view-presenter/pom.xml                   | 2 +-
 monostate/pom.xml                              | 2 +-
 multiton/pom.xml                               | 2 +-
 naked-objects/dom/pom.xml                      | 2 +-
 naked-objects/fixture/pom.xml                  | 2 +-
 naked-objects/integtests/pom.xml               | 2 +-
 naked-objects/pom.xml                          | 8 ++++----
 naked-objects/webapp/pom.xml                   | 2 +-
 null-object/pom.xml                            | 2 +-
 object-pool/pom.xml                            | 2 +-
 observer/pom.xml                               | 2 +-
 poison-pill/pom.xml                            | 2 +-
 pom.xml                                        | 2 +-
 private-class-data/pom.xml                     | 2 +-
 producer-consumer/pom.xml                      | 2 +-
 property/pom.xml                               | 2 +-
 prototype/pom.xml                              | 2 +-
 proxy/pom.xml                                  | 2 +-
 reactor/pom.xml                                | 2 +-
 repository/pom.xml                             | 2 +-
 resource-acquisition-is-initialization/pom.xml | 2 +-
 servant/pom.xml                                | 2 +-
 service-layer/pom.xml                          | 2 +-
 service-locator/pom.xml                        | 2 +-
 singleton/pom.xml                              | 2 +-
 specification/pom.xml                          | 2 +-
 state/pom.xml                                  | 2 +-
 step-builder/pom.xml                           | 2 +-
 strategy/pom.xml                               | 2 +-
 template-method/pom.xml                        | 2 +-
 thread-pool/pom.xml                            | 2 +-
 tolerant-reader/pom.xml                        | 2 +-
 visitor/pom.xml                                | 2 +-
 67 files changed, 70 insertions(+), 70 deletions(-)

diff --git a/abstract-factory/pom.xml b/abstract-factory/pom.xml
index bb9df6bc9..f8c7fa106 100644
--- a/abstract-factory/pom.xml
+++ b/abstract-factory/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   abstract-factory
   
diff --git a/adapter/pom.xml b/adapter/pom.xml
index d07d26b94..2284c2974 100644
--- a/adapter/pom.xml
+++ b/adapter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   adapter
   
diff --git a/async-method-invocation/pom.xml b/async-method-invocation/pom.xml
index d5e0e2b3e..87dd343ac 100644
--- a/async-method-invocation/pom.xml
+++ b/async-method-invocation/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   async-method-invocation
   
diff --git a/bridge/pom.xml b/bridge/pom.xml
index 533074d72..c17b482a5 100644
--- a/bridge/pom.xml
+++ b/bridge/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   bridge
   
diff --git a/builder/pom.xml b/builder/pom.xml
index effc18f0c..f26494b2e 100644
--- a/builder/pom.xml
+++ b/builder/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   builder
   
diff --git a/business-delegate/pom.xml b/business-delegate/pom.xml
index 84ae64a17..cfd7d6e5d 100644
--- a/business-delegate/pom.xml
+++ b/business-delegate/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	business-delegate
 	
diff --git a/caching/pom.xml b/caching/pom.xml
index d2284a5f1..e61b8ab8c 100644
--- a/caching/pom.xml
+++ b/caching/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   caching
   
diff --git a/callback/pom.xml b/callback/pom.xml
index 7e66f6e2b..dc12efb66 100644
--- a/callback/pom.xml
+++ b/callback/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   callback
   
diff --git a/chain/pom.xml b/chain/pom.xml
index 80591a477..1c044f7e1 100644
--- a/chain/pom.xml
+++ b/chain/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   chain
   
diff --git a/command/pom.xml b/command/pom.xml
index 22f1c256b..08ff32d3b 100644
--- a/command/pom.xml
+++ b/command/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   command
   
diff --git a/composite/pom.xml b/composite/pom.xml
index 2b8298647..155108064 100644
--- a/composite/pom.xml
+++ b/composite/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   composite
   
diff --git a/dao/pom.xml b/dao/pom.xml
index 69191b94d..ccf990be5 100644
--- a/dao/pom.xml
+++ b/dao/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	dao
 	
diff --git a/decorator/pom.xml b/decorator/pom.xml
index 92142f184..044037688 100644
--- a/decorator/pom.xml
+++ b/decorator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   decorator
   
diff --git a/dependency-injection/pom.xml b/dependency-injection/pom.xml
index 9a28933f8..b05451afa 100644
--- a/dependency-injection/pom.xml
+++ b/dependency-injection/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   dependency-injection
   
diff --git a/double-checked-locking/pom.xml b/double-checked-locking/pom.xml
index 6f1fe93eb..a9c0f220b 100644
--- a/double-checked-locking/pom.xml
+++ b/double-checked-locking/pom.xml
@@ -3,7 +3,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   double-checked-locking
   
diff --git a/double-dispatch/pom.xml b/double-dispatch/pom.xml
index 057d75e8e..290ddb68b 100644
--- a/double-dispatch/pom.xml
+++ b/double-dispatch/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   double-dispatch
   
diff --git a/event-aggregator/pom.xml b/event-aggregator/pom.xml
index 4e7f1b55b..d5001f992 100644
--- a/event-aggregator/pom.xml
+++ b/event-aggregator/pom.xml
@@ -4,7 +4,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	event-aggregator
 	
diff --git a/execute-around/pom.xml b/execute-around/pom.xml
index c6a7785aa..dae6a4dad 100644
--- a/execute-around/pom.xml
+++ b/execute-around/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   execute-around
   
diff --git a/facade/pom.xml b/facade/pom.xml
index cea5bf0c3..4447cc03b 100644
--- a/facade/pom.xml
+++ b/facade/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   facade
   
diff --git a/factory-method/pom.xml b/factory-method/pom.xml
index 39e0b7b4e..0d1e435f9 100644
--- a/factory-method/pom.xml
+++ b/factory-method/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   factory-method
   
diff --git a/fluentinterface/pom.xml b/fluentinterface/pom.xml
index 16e237bd5..48ec08161 100644
--- a/fluentinterface/pom.xml
+++ b/fluentinterface/pom.xml
@@ -5,7 +5,7 @@
     
         java-design-patterns
         com.iluwatar
-        1.7.0
+        1.8.0-SNAPSHOT
     
     4.0.0
 
diff --git a/flux/pom.xml b/flux/pom.xml
index f706b49ed..28a634ceb 100644
--- a/flux/pom.xml
+++ b/flux/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   flux
   
diff --git a/flyweight/pom.xml b/flyweight/pom.xml
index 7c0f3e2b0..3aa89d15c 100644
--- a/flyweight/pom.xml
+++ b/flyweight/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   flyweight
   
diff --git a/front-controller/pom.xml b/front-controller/pom.xml
index c80121df2..5b0ef2155 100644
--- a/front-controller/pom.xml
+++ b/front-controller/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	front-controller
 	
diff --git a/half-sync-half-async/pom.xml b/half-sync-half-async/pom.xml
index e7436d29f..e7a27c321 100644
--- a/half-sync-half-async/pom.xml
+++ b/half-sync-half-async/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   half-sync-half-async
   
diff --git a/intercepting-filter/pom.xml b/intercepting-filter/pom.xml
index 230f76ca3..1f1d89e96 100644
--- a/intercepting-filter/pom.xml
+++ b/intercepting-filter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   intercepting-filter
   
diff --git a/interpreter/pom.xml b/interpreter/pom.xml
index 8a536748c..863a00199 100644
--- a/interpreter/pom.xml
+++ b/interpreter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   interpreter
   
diff --git a/iterator/pom.xml b/iterator/pom.xml
index 22e574ba5..258c1e3ee 100644
--- a/iterator/pom.xml
+++ b/iterator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   iterator
   
diff --git a/layers/pom.xml b/layers/pom.xml
index 5d3fd778c..e338a557f 100644
--- a/layers/pom.xml
+++ b/layers/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	com.iluwatar.layers
 	layers
diff --git a/lazy-loading/pom.xml b/lazy-loading/pom.xml
index 61da2f3b5..eafc0f559 100644
--- a/lazy-loading/pom.xml
+++ b/lazy-loading/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   lazy-loading
   
diff --git a/mediator/pom.xml b/mediator/pom.xml
index 1e325bb8f..60999c5aa 100644
--- a/mediator/pom.xml
+++ b/mediator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   mediator
   
diff --git a/memento/pom.xml b/memento/pom.xml
index 98d1d4a9f..08d5c3a02 100644
--- a/memento/pom.xml
+++ b/memento/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   memento
   
diff --git a/message-channel/pom.xml b/message-channel/pom.xml
index ee7d54c95..0c34678a6 100644
--- a/message-channel/pom.xml
+++ b/message-channel/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	message-channel
 	
diff --git a/model-view-controller/pom.xml b/model-view-controller/pom.xml
index 8c9c07809..0f4539747 100644
--- a/model-view-controller/pom.xml
+++ b/model-view-controller/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   model-view-controller
   
diff --git a/model-view-presenter/pom.xml b/model-view-presenter/pom.xml
index 4f2d320ba..09410afc6 100644
--- a/model-view-presenter/pom.xml
+++ b/model-view-presenter/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   model-view-presenter
   model-view-presenter
diff --git a/monostate/pom.xml b/monostate/pom.xml
index 480a4967c..7531263f0 100644
--- a/monostate/pom.xml
+++ b/monostate/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   monostate
   
diff --git a/multiton/pom.xml b/multiton/pom.xml
index 9735bc8ea..4cbb326e8 100644
--- a/multiton/pom.xml
+++ b/multiton/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   multiton
   
diff --git a/naked-objects/dom/pom.xml b/naked-objects/dom/pom.xml
index b0efdb435..bd71db272 100644
--- a/naked-objects/dom/pom.xml
+++ b/naked-objects/dom/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 
 	naked-objects-dom
diff --git a/naked-objects/fixture/pom.xml b/naked-objects/fixture/pom.xml
index bbed2fe1b..057bbb9ff 100644
--- a/naked-objects/fixture/pom.xml
+++ b/naked-objects/fixture/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 
 	naked-objects-fixture
diff --git a/naked-objects/integtests/pom.xml b/naked-objects/integtests/pom.xml
index 221b072e5..78819358a 100644
--- a/naked-objects/integtests/pom.xml
+++ b/naked-objects/integtests/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 
 	naked-objects-integtests
diff --git a/naked-objects/pom.xml b/naked-objects/pom.xml
index 067d4a5a8..aad8a360d 100644
--- a/naked-objects/pom.xml
+++ b/naked-objects/pom.xml
@@ -15,7 +15,7 @@
 	
 		java-design-patterns
 		com.iluwatar
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 
 	naked-objects
@@ -350,17 +350,17 @@
 			
 				${project.groupId}
 				naked-objects-dom
-				1.7.0
+				1.8.0-SNAPSHOT
 			
 			
 				${project.groupId}
 				naked-objects-fixture
-				1.7.0
+				1.8.0-SNAPSHOT
 			
 			
 				${project.groupId}
 				naked-objects-webapp
-				1.7.0
+				1.8.0-SNAPSHOT
 			
 
 		
diff --git a/naked-objects/webapp/pom.xml b/naked-objects/webapp/pom.xml
index bc7d7c299..4935bd3ef 100644
--- a/naked-objects/webapp/pom.xml
+++ b/naked-objects/webapp/pom.xml
@@ -16,7 +16,7 @@
 	
 		com.iluwatar
 		naked-objects
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 
 	naked-objects-webapp
diff --git a/null-object/pom.xml b/null-object/pom.xml
index a372851ed..597dad233 100644
--- a/null-object/pom.xml
+++ b/null-object/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   null-object
   
diff --git a/object-pool/pom.xml b/object-pool/pom.xml
index 528e3db16..75bc894e8 100644
--- a/object-pool/pom.xml
+++ b/object-pool/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   object-pool
   
diff --git a/observer/pom.xml b/observer/pom.xml
index 023d93bea..a3dd25d85 100644
--- a/observer/pom.xml
+++ b/observer/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   observer
   
diff --git a/poison-pill/pom.xml b/poison-pill/pom.xml
index 06d9f34de..340445414 100644
--- a/poison-pill/pom.xml
+++ b/poison-pill/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   poison-pill
   
diff --git a/pom.xml b/pom.xml
index 3462cc864..3c86ed57e 100644
--- a/pom.xml
+++ b/pom.xml
@@ -5,7 +5,7 @@
 
 	com.iluwatar
 	java-design-patterns
-	1.7.0
+	1.8.0-SNAPSHOT
 	pom
 
 	
diff --git a/private-class-data/pom.xml b/private-class-data/pom.xml
index 274739257..362e061f1 100644
--- a/private-class-data/pom.xml
+++ b/private-class-data/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   private-class-data
   
diff --git a/producer-consumer/pom.xml b/producer-consumer/pom.xml
index 475c7fb6c..571272102 100644
--- a/producer-consumer/pom.xml
+++ b/producer-consumer/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   producer-consumer
   
diff --git a/property/pom.xml b/property/pom.xml
index f32a4008e..b6d10bdb0 100644
--- a/property/pom.xml
+++ b/property/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   property
   
diff --git a/prototype/pom.xml b/prototype/pom.xml
index d5772da60..c08e79558 100644
--- a/prototype/pom.xml
+++ b/prototype/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   prototype
   
diff --git a/proxy/pom.xml b/proxy/pom.xml
index 750c12b84..0bb88bb79 100644
--- a/proxy/pom.xml
+++ b/proxy/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   proxy
   
diff --git a/reactor/pom.xml b/reactor/pom.xml
index 516a4b93c..c60e8cf98 100644
--- a/reactor/pom.xml
+++ b/reactor/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   reactor
   
diff --git a/repository/pom.xml b/repository/pom.xml
index 70f2ff6b2..60b51568e 100644
--- a/repository/pom.xml
+++ b/repository/pom.xml
@@ -6,7 +6,7 @@
 	
 		com.iluwatar
 		java-design-patterns
-		1.7.0
+		1.8.0-SNAPSHOT
 	
 	repository
 	
diff --git a/resource-acquisition-is-initialization/pom.xml b/resource-acquisition-is-initialization/pom.xml
index a16eae745..4b0b2cadb 100644
--- a/resource-acquisition-is-initialization/pom.xml
+++ b/resource-acquisition-is-initialization/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   resource-acquisition-is-initialization
   
diff --git a/servant/pom.xml b/servant/pom.xml
index 1928f83c9..348905d24 100644
--- a/servant/pom.xml
+++ b/servant/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   servant
   
diff --git a/service-layer/pom.xml b/service-layer/pom.xml
index a42d07c5e..b188ba1d7 100644
--- a/service-layer/pom.xml
+++ b/service-layer/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   service-layer
   
diff --git a/service-locator/pom.xml b/service-locator/pom.xml
index f210c74b6..f04f9199e 100644
--- a/service-locator/pom.xml
+++ b/service-locator/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   service-locator
   
diff --git a/singleton/pom.xml b/singleton/pom.xml
index ab118a1c3..de316c34c 100644
--- a/singleton/pom.xml
+++ b/singleton/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   singleton
   
diff --git a/specification/pom.xml b/specification/pom.xml
index 3c58aa29f..bf69e481e 100644
--- a/specification/pom.xml
+++ b/specification/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   specification
   
diff --git a/state/pom.xml b/state/pom.xml
index 2d87a796a..2bd9d9168 100644
--- a/state/pom.xml
+++ b/state/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   state
   
diff --git a/step-builder/pom.xml b/step-builder/pom.xml
index 7c7e8ac69..d31192323 100644
--- a/step-builder/pom.xml
+++ b/step-builder/pom.xml
@@ -6,7 +6,7 @@
   
     java-design-patterns
     com.iluwatar
-    1.7.0
+    1.8.0-SNAPSHOT
   
   step-builder
   
diff --git a/strategy/pom.xml b/strategy/pom.xml
index 0b71652ba..4b4448ffe 100644
--- a/strategy/pom.xml
+++ b/strategy/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   strategy
   
diff --git a/template-method/pom.xml b/template-method/pom.xml
index 4aa776591..ecc0c4efa 100644
--- a/template-method/pom.xml
+++ b/template-method/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   template-method
   
diff --git a/thread-pool/pom.xml b/thread-pool/pom.xml
index e335b06e5..f79388008 100644
--- a/thread-pool/pom.xml
+++ b/thread-pool/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   thread-pool
   
diff --git a/tolerant-reader/pom.xml b/tolerant-reader/pom.xml
index 086251772..d32006ed7 100644
--- a/tolerant-reader/pom.xml
+++ b/tolerant-reader/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   tolerant-reader
   
diff --git a/visitor/pom.xml b/visitor/pom.xml
index ca5f72be8..b33f9975b 100644
--- a/visitor/pom.xml
+++ b/visitor/pom.xml
@@ -5,7 +5,7 @@
   
     com.iluwatar
     java-design-patterns
-    1.7.0
+    1.8.0-SNAPSHOT
   
   visitor
   

From 25c1f87d465c18b7c74846fedae0c717075742ca Mon Sep 17 00:00:00 2001
From: Luigi Cortese 
Date: Sun, 1 Nov 2015 23:15:57 +0100
Subject: [PATCH 302/687] Corrected Freddy's second name

---
 dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
index 230314d80..245efb505 100644
--- a/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
+++ b/dao/src/test/java/com/iluwatar/dao/CustomerDaoImplTest.java
@@ -14,7 +14,7 @@ public class CustomerDaoImplTest {
 
   private CustomerDaoImpl impl;
   private List customers;
-  private static final Customer CUSTOMER = new Customer(1, "Freddy", "Kruger");
+  private static final Customer CUSTOMER = new Customer(1, "Freddy", "Krueger");
 
   @Before
   public void setUp() {

From c0c21ebd910bcacf214f23121dabcbf82463d127 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 17:18:39 -0500
Subject: [PATCH 303/687] Reformat Abstract Factory - Issue #224

---
 .../com/iluwatar/abstractfactory/App.java     | 138 +++++++++---------
 .../com/iluwatar/abstractfactory/Army.java    |   2 +-
 .../com/iluwatar/abstractfactory/Castle.java  |   2 +-
 .../com/iluwatar/abstractfactory/ElfArmy.java |  10 +-
 .../iluwatar/abstractfactory/ElfCastle.java   |  10 +-
 .../com/iluwatar/abstractfactory/ElfKing.java |  12 +-
 .../abstractfactory/ElfKingdomFactory.java    |  18 +--
 .../com/iluwatar/abstractfactory/King.java    |   2 +-
 .../abstractfactory/KingdomFactory.java       |   6 +-
 .../com/iluwatar/abstractfactory/OrcArmy.java |  10 +-
 .../iluwatar/abstractfactory/OrcCastle.java   |  10 +-
 .../com/iluwatar/abstractfactory/OrcKing.java |  12 +-
 .../abstractfactory/OrcKingdomFactory.java    |  19 ++-
 .../com/iluwatar/abstractfactory/AppTest.java | 135 ++++++++---------
 14 files changed, 192 insertions(+), 194 deletions(-)

diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
index 618b98c52..5b93f0e46 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java
@@ -3,80 +3,78 @@ package com.iluwatar.abstractfactory;
 
 /**
  * 
- * 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 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.
+ * 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 King king;
-	private Castle castle;
-	private Army army;
+  private King king;
+  private Castle castle;
+  private Army army;
 
-	/**
-	 * Creates kingdom
-	 * @param factory
-	 */
-	public void createKingdom(final KingdomFactory factory) {
-		setKing(factory.createKing());
-		setCastle(factory.createCastle());
-		setArmy(factory.createArmy());
-	}
-	
-	ElfKingdomFactory getElfKingdomFactory() {
-		return new ElfKingdomFactory();
-	}
-	
-	OrcKingdomFactory getOrcKingdomFactory() {
-		return new OrcKingdomFactory();
-	}
-	
-	King getKing(final KingdomFactory factory) {
-		return factory.createKing();
-	}
-	
-	Castle getCastle(final KingdomFactory factory) {
-		return factory.createCastle();
-	}
-	
-	Army getArmy(final KingdomFactory factory) {
-		return factory.createArmy();
-	}
-	
-	public King getKing() {
-		return king;
-	}
-	
-	private void setKing(final King king) {
-		this.king = king;
-	}
-	
-	public Castle getCastle() {
-		return castle;
-	}
-	
-	private void setCastle(final Castle castle) {
-		this.castle = castle;
-	}
-	
-	public Army getArmy() {
-		return army;
-	}
-	
-	private void setArmy(final Army army) {
-		this.army = army;
-	}
+  /**
+   * Creates kingdom
+   * 
+   * @param factory
+   */
+  public void createKingdom(final KingdomFactory factory) {
+    setKing(factory.createKing());
+    setCastle(factory.createCastle());
+    setArmy(factory.createArmy());
+  }
+
+  ElfKingdomFactory getElfKingdomFactory() {
+    return new ElfKingdomFactory();
+  }
+
+  OrcKingdomFactory getOrcKingdomFactory() {
+    return new OrcKingdomFactory();
+  }
+
+  King getKing(final KingdomFactory factory) {
+    return factory.createKing();
+  }
+
+  Castle getCastle(final KingdomFactory factory) {
+    return factory.createCastle();
+  }
+
+  Army getArmy(final KingdomFactory factory) {
+    return factory.createArmy();
+  }
+
+  public King getKing() {
+    return king;
+  }
+
+  private void setKing(final King king) {
+    this.king = king;
+  }
+
+  public Castle getCastle() {
+    return castle;
+  }
+
+  private void setCastle(final Castle castle) {
+    this.castle = castle;
+  }
+
+  public Army getArmy() {
+    return army;
+  }
+
+  private void setArmy(final Army army) {
+    this.army = army;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
index 333b5c2cd..8e97d3f4e 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Army.java
@@ -7,5 +7,5 @@ package com.iluwatar.abstractfactory;
  */
 public interface Army {
 
-	String getDescription();
+  String getDescription();
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
index 0290cb67c..3a36513bf 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/Castle.java
@@ -7,5 +7,5 @@ package com.iluwatar.abstractfactory;
  */
 public interface Castle {
 
-	String getDescription();
+  String getDescription();
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
index 410f46951..d7ae734d2 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfArmy.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfArmy implements Army {
 
-	static final String DESCRIPTION = "This is the Elven Army!";
+  static final String DESCRIPTION = "This is the Elven Army!";
 
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
index fe2e9a0e7..e53b198d7 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfCastle.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfCastle implements Castle {
 
-	static final String DESCRIPTION = "This is the Elven castle!";
+  static final String DESCRIPTION = "This is the Elven castle!";
 
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
index 66571ee01..36669f42f 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKing.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfKing implements King {
 
-	static final String DESCRIPTION = "This is the Elven king!";
-	
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  static final String DESCRIPTION = "This is the Elven king!";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java
index 0d62fa5f2..7c8435056 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/ElfKingdomFactory.java
@@ -7,16 +7,16 @@ package com.iluwatar.abstractfactory;
  */
 public class ElfKingdomFactory implements KingdomFactory {
 
-	public Castle createCastle() {
-		return new ElfCastle();
-	}
+  public Castle createCastle() {
+    return new ElfCastle();
+  }
 
-	public King createKing() {
-		return new ElfKing();
-	}
+  public King createKing() {
+    return new ElfKing();
+  }
 
-	public Army createArmy() {
-		return new ElfArmy();
-	}
+  public Army createArmy() {
+    return new ElfArmy();
+  }
 
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
index c7b9a867c..38e6b9f4d 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/King.java
@@ -7,5 +7,5 @@ package com.iluwatar.abstractfactory;
  */
 public interface King {
 
-	String getDescription();
+  String getDescription();
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java
index 00bcd1755..e303b32f4 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/KingdomFactory.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public interface KingdomFactory {
 
-	Castle createCastle();
+  Castle createCastle();
 
-	King createKing();
+  King createKing();
 
-	Army createArmy();
+  Army createArmy();
 
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
index 108700511..de16e5007 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcArmy.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcArmy implements Army {
 
-	static final String DESCRIPTION = "This is the Orc Army!";
+  static final String DESCRIPTION = "This is the Orc Army!";
 
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
index 5012f9200..b355744ce 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcCastle.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcCastle implements Castle {
 
-	static final String DESCRIPTION = "This is the Orc castle!";
+  static final String DESCRIPTION = "This is the Orc castle!";
 
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
index a5657d4e4..eac96913f 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKing.java
@@ -7,10 +7,10 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcKing implements King {
 
-static final String DESCRIPTION = "This is the Orc king!";
-	
-	@Override
-	public String getDescription() {
-		return DESCRIPTION;
-	}
+  static final String DESCRIPTION = "This is the Orc king!";
+
+  @Override
+  public String getDescription() {
+    return DESCRIPTION;
+  }
 }
diff --git a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java
index 4fdea6656..18301c955 100644
--- a/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java
+++ b/abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java
@@ -7,16 +7,15 @@ package com.iluwatar.abstractfactory;
  */
 public class OrcKingdomFactory implements KingdomFactory {
 
-	public Castle createCastle() {
-		return new OrcCastle();
-	}
+  public Castle createCastle() {
+    return new OrcCastle();
+  }
 
-	public King createKing() {
-		return new OrcKing();
-	}
-
-	public Army createArmy() {
-		return new OrcArmy();
-	}
+  public King createKing() {
+    return new OrcKing();
+  }
 
+  public Army createArmy() {
+    return new OrcArmy();
+  }
 }
diff --git a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
index 4d3659245..5e3869fc8 100644
--- a/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
+++ b/abstract-factory/src/test/java/com/iluwatar/abstractfactory/AppTest.java
@@ -1,4 +1,5 @@
 package com.iluwatar.abstractfactory;
+
 import static org.junit.Assert.assertEquals;
 import static org.junit.Assert.assertTrue;
 
@@ -7,71 +8,71 @@ import org.junit.Test;
 
 public class AppTest {
 
-	private App app = new App();
-	private KingdomFactory elfFactory;
-	private KingdomFactory orcFactory;
-	
-	@Before
-	public void setUp() {
-		elfFactory = app.getElfKingdomFactory();
-		orcFactory = app.getOrcKingdomFactory();
-	}
-	
-	@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());
-	}
+  private App app = new App();
+  private KingdomFactory elfFactory;
+  private KingdomFactory orcFactory;
+
+  @Before
+  public void setUp() {
+    elfFactory = app.getElfKingdomFactory();
+    orcFactory = app.getOrcKingdomFactory();
+  }
+
+  @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());
+  }
 }

From 95c16200e7590ef698212fc244da59b6c18be189 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 17:26:57 -0500
Subject: [PATCH 304/687] Reformat Adapter Pattern - Issue #224

---
 .../main/java/com/iluwatar/adapter/App.java   | 39 +++++++++----------
 .../java/com/iluwatar/adapter/Engineer.java   |  3 +-
 .../com/iluwatar/adapter/GnomeEngineer.java   | 25 ++++++------
 .../adapter/GnomeEngineeringManager.java      | 16 ++++----
 .../com/iluwatar/adapter/GoblinGlider.java    | 18 ++++-----
 .../java/com/iluwatar/adapter/AppTest.java    | 10 ++---
 6 files changed, 54 insertions(+), 57 deletions(-)

diff --git a/adapter/src/main/java/com/iluwatar/adapter/App.java b/adapter/src/main/java/com/iluwatar/adapter/App.java
index ed036b391..f912efb03 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/App.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/App.java
@@ -2,30 +2,29 @@ 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.
+ * 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.
+ * 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 GnomeEngineer}) converts the interface of the target class
- * ({@link GoblinGlider}) into a suitable one expected by the client
- * ({@link GnomeEngineeringManager}).
+ * The Adapter ({@link GnomeEngineer}) converts the interface of the target class (
+ * {@link GoblinGlider}) into a suitable one expected by the client ({@link GnomeEngineeringManager}
+ * ).
  * 
  */
 public class App {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
-		Engineer manager = new GnomeEngineeringManager();
-		manager.operateDevice();
-	}
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    Engineer manager = new GnomeEngineeringManager();
+    manager.operateDevice();
+  }
 }
diff --git a/adapter/src/main/java/com/iluwatar/adapter/Engineer.java b/adapter/src/main/java/com/iluwatar/adapter/Engineer.java
index 7478b5b69..a973cb530 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/Engineer.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/Engineer.java
@@ -7,6 +7,5 @@ package com.iluwatar.adapter;
  */
 public interface Engineer {
 
-	void operateDevice();
-
+  void operateDevice();
 }
diff --git a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java
index 35cbc9573..70e166ac3 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java
@@ -2,23 +2,22 @@ package com.iluwatar.adapter;
 
 /**
  * 
- * Adapter class. Adapts the interface of the device ({@link GoblinGlider}) into
- * {@link Engineer} interface expected by the client ({@link GnomeEngineeringManager}).
+ * Adapter class. Adapts the interface of the device ({@link GoblinGlider}) into {@link Engineer}
+ * interface expected by the client ({@link GnomeEngineeringManager}).
  * 
  */
 public class GnomeEngineer implements Engineer {
 
-	private GoblinGlider glider;
+  private GoblinGlider glider;
 
-	public GnomeEngineer() {
-		glider = new GoblinGlider();
-	}
-
-	@Override
-	public void operateDevice() {
-		glider.attachGlider();
-		glider.gainSpeed();
-		glider.takeOff();
-	}
+  public GnomeEngineer() {
+    glider = new GoblinGlider();
+  }
 
+  @Override
+  public void operateDevice() {
+    glider.attachGlider();
+    glider.gainSpeed();
+    glider.takeOff();
+  }
 }
diff --git a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java
index d95065b88..a2faf1e54 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java
@@ -7,14 +7,14 @@ package com.iluwatar.adapter;
  */
 public class GnomeEngineeringManager implements Engineer {
 
-	private Engineer engineer;
+  private Engineer engineer;
 
-	public GnomeEngineeringManager() {
-		engineer = new GnomeEngineer();
-	}
+  public GnomeEngineeringManager() {
+    engineer = new GnomeEngineer();
+  }
 
-	@Override
-	public void operateDevice() {
-		engineer.operateDevice();
-	}
+  @Override
+  public void operateDevice() {
+    engineer.operateDevice();
+  }
 }
diff --git a/adapter/src/main/java/com/iluwatar/adapter/GoblinGlider.java b/adapter/src/main/java/com/iluwatar/adapter/GoblinGlider.java
index ff1dbeb8d..79a9acef6 100644
--- a/adapter/src/main/java/com/iluwatar/adapter/GoblinGlider.java
+++ b/adapter/src/main/java/com/iluwatar/adapter/GoblinGlider.java
@@ -7,15 +7,15 @@ package com.iluwatar.adapter;
  */
 public class GoblinGlider {
 
-	public void attachGlider() {
-		System.out.println("Glider attached.");
-	}
+  public void attachGlider() {
+    System.out.println("Glider attached.");
+  }
 
-	public void gainSpeed() {
-		System.out.println("Gaining speed.");
-	}
+  public void gainSpeed() {
+    System.out.println("Gaining speed.");
+  }
 
-	public void takeOff() {
-		System.out.println("Lift-off!");
-	}
+  public void takeOff() {
+    System.out.println("Lift-off!");
+  }
 }
diff --git a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
index 3d877815a..a7462bd9a 100644
--- a/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
+++ b/adapter/src/test/java/com/iluwatar/adapter/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.adapter.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }

From 16a8c85af60ddc83a406332d6f051a60d8680fb4 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 17:33:25 -0500
Subject: [PATCH 305/687] Reformat Async Method Invocation - Issue #224

---
 .../iluwatar/async/method/invocation/App.java | 139 ++++++------
 .../method/invocation/AsyncCallback.java      |  15 +-
 .../method/invocation/AsyncExecutor.java      |  53 +++--
 .../async/method/invocation/AsyncResult.java  |  40 ++--
 .../invocation/ThreadAsyncExecutor.java       | 199 +++++++++---------
 .../async/method/invocation/AppTest.java      |  11 +-
 6 files changed, 229 insertions(+), 228 deletions(-)

diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
index 688d8482f..0b8ee3649 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/App.java
@@ -4,23 +4,24 @@ 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
+ * 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.
+ * 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.
+ * 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.
+ * 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
@@ -32,66 +33,68 @@ import java.util.concurrent.Callable;
  */
 public class App {
 
-	public static void main(String[] args) throws Exception {
-		// construct a new executor that will run async tasks
-		AsyncExecutor executor = new ThreadAsyncExecutor();
+  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"));
+    // 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");
+    // 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();
+    // 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);
-	}
+    // 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 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);
-			}
-		};
-	}
+  /**
+   * 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) {
-		System.out.println(String.format("[%1$-10s] - %2$s", Thread.currentThread().getName(), msg));
-	}
+  private static void log(String msg) {
+    System.out.println(String.format("[%1$-10s] - %2$s", Thread.currentThread().getName(), msg));
+  }
 }
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java
index 46556a48e..8e4d77443 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncCallback.java
@@ -11,12 +11,11 @@ import java.util.Optional;
  */
 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);
-
+  /**
+   * 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);
 }
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java
index 5c5098487..bd3c98339 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncExecutor.java
@@ -10,33 +10,32 @@ import java.util.concurrent.ExecutionException;
  */
 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.
+   *
+   * @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;
+  /**
+   * 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;
 }
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java
index 405bec251..6d77df8ec 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/AsyncResult.java
@@ -10,26 +10,26 @@ import java.util.concurrent.ExecutionException;
  */
 public interface AsyncResult {
 
-	/**
-	 * Status of the async task execution.
-	 *
-	 * @return true if execution is completed or failed
-	 */
-	boolean isCompleted();
+  /**
+   * 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;
+  /**
+   * 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;
+  /**
+   * Blocks the current thread until the async task is completed.
+   *
+   * @throws InterruptedException if the execution is interrupted
+   */
+  void await() throws InterruptedException;
 }
diff --git a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java
index a3ed51af3..300934562 100644
--- a/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java
+++ b/async-method-invocation/src/main/java/com/iluwatar/async/method/invocation/ThreadAsyncExecutor.java
@@ -12,116 +12,117 @@ import java.util.concurrent.atomic.AtomicInteger;
  */
 public class ThreadAsyncExecutor implements AsyncExecutor {
 
-	/** Index for thread naming */
-	private final AtomicInteger idx = new AtomicInteger(0);
+  /** 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) {
+    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  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()) {
-			return asyncResult.getValue();
-		} else {
-			asyncResult.await();
-			return asyncResult.getValue();
-		}
-	}
+  @Override
+  public  T endProcess(AsyncResult asyncResult) throws ExecutionException,
+      InterruptedException {
+    if (asyncResult.isCompleted()) {
+      return asyncResult.getValue();
+    } else {
+      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 {
+  /**
+   * 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;
+    static final int RUNNING = 1;
+    static final int FAILED = 2;
+    static final int COMPLETED = 3;
 
-		final Object lock;
-		final Optional> callback;
+    final Object lock;
+    final Optional> callback;
 
-		volatile int state = RUNNING;
-		T value;
-		Exception exception;
+    volatile int state = RUNNING;
+    T value;
+    Exception exception;
 
-		CompletableResult(AsyncCallback callback) {
-			this.lock = new Object();
-			this.callback = Optional.ofNullable(callback);
-		}
+    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 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();
-			}
-		}
+    /**
+     * 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 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 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();
-				}
-			}
-		}
-	}
+    @Override
+    public void await() throws InterruptedException {
+      synchronized (lock) {
+        if (!isCompleted()) {
+          lock.wait();
+        }
+      }
+    }
+  }
 }
diff --git a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
index 5faec5356..e077701c0 100644
--- a/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
+++ b/async-method-invocation/src/test/java/com/iluwatar/async/method/invocation/AppTest.java
@@ -9,10 +9,9 @@ import org.junit.Test;
  */
 public class AppTest {
 
-	@Test
-	public void test() throws Exception {
-		String[] args = {};
-		App.main(args);
-	}
-
+  @Test
+  public void test() throws Exception {
+    String[] args = {};
+    App.main(args);
+  }
 }

From e7b654213433a70d72b657ed9067d700744bf526 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 17:43:54 -0500
Subject: [PATCH 306/687] Reformat bridge design pattern - Issue #224

---
 .../main/java/com/iluwatar/bridge/App.java    | 57 +++++++++----------
 .../iluwatar/bridge/BlindingMagicWeapon.java  | 45 +++++++--------
 .../bridge/BlindingMagicWeaponImpl.java       |  2 +-
 .../java/com/iluwatar/bridge/Excalibur.java   | 34 ++++++-----
 .../iluwatar/bridge/FlyingMagicWeapon.java    | 42 +++++++-------
 .../bridge/FlyingMagicWeaponImpl.java         |  2 +-
 .../java/com/iluwatar/bridge/MagicWeapon.java | 21 ++++---
 .../com/iluwatar/bridge/MagicWeaponImpl.java  |  6 +-
 .../java/com/iluwatar/bridge/Mjollnir.java    | 34 ++++++-----
 .../bridge/SoulEatingMagicWeapon.java         | 44 +++++++-------
 .../bridge/SoulEatingMagicWeaponImpl.java     |  2 +-
 .../com/iluwatar/bridge/Stormbringer.java     | 33 ++++++-----
 .../java/com/iluwatar/bridge/AppTest.java     | 10 ++--
 13 files changed, 161 insertions(+), 171 deletions(-)

diff --git a/bridge/src/main/java/com/iluwatar/bridge/App.java b/bridge/src/main/java/com/iluwatar/bridge/App.java
index 972f49b2f..6d902fe21 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/App.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/App.java
@@ -2,41 +2,38 @@ 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.
+ * 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.
+ * 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();
+  /**
+   * 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();
+    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();
-
-	}
+    SoulEatingMagicWeapon soulEatingMagicWeapon = new SoulEatingMagicWeapon(new Stormbringer());
+    soulEatingMagicWeapon.wield();
+    soulEatingMagicWeapon.swing();
+    soulEatingMagicWeapon.eatSoul();
+    soulEatingMagicWeapon.unwield();
+  }
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java
index bf4bac8f9..572db251b 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeapon.java
@@ -7,32 +7,31 @@ package com.iluwatar.bridge;
  */
 public class BlindingMagicWeapon extends MagicWeapon {
 
-	public BlindingMagicWeapon(BlindingMagicWeaponImpl imp) {
-		super(imp);
-	}
+  public BlindingMagicWeapon(BlindingMagicWeaponImpl imp) {
+    super(imp);
+  }
 
-	@Override
-	public BlindingMagicWeaponImpl getImp() {
-		return (BlindingMagicWeaponImpl) imp;
-	}
+  @Override
+  public BlindingMagicWeaponImpl getImp() {
+    return (BlindingMagicWeaponImpl) imp;
+  }
 
-	@Override
-	public void wield() {
-		getImp().wieldImp();
-	}
+  @Override
+  public void wield() {
+    getImp().wieldImp();
+  }
 
-	@Override
-	public void swing() {
-		getImp().swingImp();
-	}
+  @Override
+  public void swing() {
+    getImp().swingImp();
+  }
 
-	@Override
-	public void unwield() {
-		getImp().unwieldImp();
-	}
-
-	public void blind() {
-		getImp().blindImp();
-	}
+  @Override
+  public void unwield() {
+    getImp().unwieldImp();
+  }
 
+  public void blind() {
+    getImp().blindImp();
+  }
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java
index 31dffb042..cf1b47e9a 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/BlindingMagicWeaponImpl.java
@@ -7,6 +7,6 @@ package com.iluwatar.bridge;
  */
 public abstract class BlindingMagicWeaponImpl extends MagicWeaponImpl {
 
-	public abstract void blindImp();
+  public abstract void blindImp();
 
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java b/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java
index 9f7078139..39365eaf8 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Excalibur.java
@@ -7,25 +7,23 @@ package com.iluwatar.bridge;
  */
 public class Excalibur extends BlindingMagicWeaponImpl {
 
-	@Override
-	public void wieldImp() {
-		System.out.println("wielding Excalibur");
-	}
+  @Override
+  public void wieldImp() {
+    System.out.println("wielding Excalibur");
+  }
 
-	@Override
-	public void swingImp() {
-		System.out.println("swinging Excalibur");
-	}
+  @Override
+  public void swingImp() {
+    System.out.println("swinging Excalibur");
+  }
 
-	@Override
-	public void unwieldImp() {
-		System.out.println("unwielding Excalibur");
-	}
-
-	@Override
-	public void blindImp() {
-		System.out
-				.println("bright light streams from Excalibur blinding the enemy");
-	}
+  @Override
+  public void unwieldImp() {
+    System.out.println("unwielding Excalibur");
+  }
 
+  @Override
+  public void blindImp() {
+    System.out.println("bright light streams from Excalibur blinding the enemy");
+  }
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java
index 542e7d97e..b4ae9a8f8 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeapon.java
@@ -7,31 +7,31 @@ package com.iluwatar.bridge;
  */
 public class FlyingMagicWeapon extends MagicWeapon {
 
-	public FlyingMagicWeapon(FlyingMagicWeaponImpl imp) {
-		super(imp);
-	}
+  public FlyingMagicWeapon(FlyingMagicWeaponImpl imp) {
+    super(imp);
+  }
 
-	public FlyingMagicWeaponImpl getImp() {
-		return (FlyingMagicWeaponImpl) imp;
-	}
+  public FlyingMagicWeaponImpl getImp() {
+    return (FlyingMagicWeaponImpl) imp;
+  }
 
-	@Override
-	public void wield() {
-		getImp().wieldImp();
-	}
+  @Override
+  public void wield() {
+    getImp().wieldImp();
+  }
 
-	@Override
-	public void swing() {
-		getImp().swingImp();
-	}
+  @Override
+  public void swing() {
+    getImp().swingImp();
+  }
 
-	@Override
-	public void unwield() {
-		getImp().unwieldImp();
-	}
+  @Override
+  public void unwield() {
+    getImp().unwieldImp();
+  }
 
-	public void fly() {
-		getImp().flyImp();
-	}
+  public void fly() {
+    getImp().flyImp();
+  }
 
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java
index 8b7a10f2f..022c06565 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/FlyingMagicWeaponImpl.java
@@ -7,6 +7,6 @@ package com.iluwatar.bridge;
  */
 public abstract class FlyingMagicWeaponImpl extends MagicWeaponImpl {
 
-	public abstract void flyImp();
+  public abstract void flyImp();
 
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java
index b2b82839c..5e17d2b40 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/MagicWeapon.java
@@ -7,20 +7,19 @@ package com.iluwatar.bridge;
  */
 public abstract class MagicWeapon {
 
-	protected MagicWeaponImpl imp;
+  protected MagicWeaponImpl imp;
 
-	public MagicWeapon(MagicWeaponImpl imp) {
-		this.imp = imp;
-	}
+  public MagicWeapon(MagicWeaponImpl imp) {
+    this.imp = imp;
+  }
 
-	public abstract void wield();
+  public abstract void wield();
 
-	public abstract void swing();
+  public abstract void swing();
 
-	public abstract void unwield();
-
-	public MagicWeaponImpl getImp() {
-		return imp;
-	}
+  public abstract void unwield();
 
+  public MagicWeaponImpl getImp() {
+    return imp;
+  }
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java
index bd2a3b8d7..bc672335e 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/MagicWeaponImpl.java
@@ -7,10 +7,10 @@ package com.iluwatar.bridge;
  */
 public abstract class MagicWeaponImpl {
 
-	public abstract void wieldImp();
+  public abstract void wieldImp();
 
-	public abstract void swingImp();
+  public abstract void swingImp();
 
-	public abstract void unwieldImp();
+  public abstract void unwieldImp();
 
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java b/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java
index 887173add..13641c335 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Mjollnir.java
@@ -7,25 +7,23 @@ package com.iluwatar.bridge;
  */
 public class Mjollnir extends FlyingMagicWeaponImpl {
 
-	@Override
-	public void wieldImp() {
-		System.out.println("wielding Mjollnir");
-	}
+  @Override
+  public void wieldImp() {
+    System.out.println("wielding Mjollnir");
+  }
 
-	@Override
-	public void swingImp() {
-		System.out.println("swinging Mjollnir");
-	}
+  @Override
+  public void swingImp() {
+    System.out.println("swinging Mjollnir");
+  }
 
-	@Override
-	public void unwieldImp() {
-		System.out.println("unwielding Mjollnir");
-	}
-
-	@Override
-	public void flyImp() {
-		System.out
-				.println("Mjollnir hits the enemy in the air and returns back to the owner's hand");
-	}
+  @Override
+  public void unwieldImp() {
+    System.out.println("unwielding Mjollnir");
+  }
 
+  @Override
+  public void flyImp() {
+    System.out.println("Mjollnir hits the enemy in the air and returns back to the owner's hand");
+  }
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java
index 3310b6488..991719c31 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeapon.java
@@ -7,32 +7,32 @@ package com.iluwatar.bridge;
  */
 public class SoulEatingMagicWeapon extends MagicWeapon {
 
-	public SoulEatingMagicWeapon(SoulEatingMagicWeaponImpl imp) {
-		super(imp);
-	}
+  public SoulEatingMagicWeapon(SoulEatingMagicWeaponImpl imp) {
+    super(imp);
+  }
 
-	@Override
-	public SoulEatingMagicWeaponImpl getImp() {
-		return (SoulEatingMagicWeaponImpl) imp;
-	}
+  @Override
+  public SoulEatingMagicWeaponImpl getImp() {
+    return (SoulEatingMagicWeaponImpl) imp;
+  }
 
-	@Override
-	public void wield() {
-		getImp().wieldImp();
-	}
+  @Override
+  public void wield() {
+    getImp().wieldImp();
+  }
 
-	@Override
-	public void swing() {
-		getImp().swingImp();
-	}
+  @Override
+  public void swing() {
+    getImp().swingImp();
+  }
 
-	@Override
-	public void unwield() {
-		getImp().unwieldImp();
-	}
+  @Override
+  public void unwield() {
+    getImp().unwieldImp();
+  }
 
-	public void eatSoul() {
-		getImp().eatSoulImp();
-	}
+  public void eatSoul() {
+    getImp().eatSoulImp();
+  }
 
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java
index 9ec112031..ec2c3a941 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/SoulEatingMagicWeaponImpl.java
@@ -7,6 +7,6 @@ package com.iluwatar.bridge;
  */
 public abstract class SoulEatingMagicWeaponImpl extends MagicWeaponImpl {
 
-	public abstract void eatSoulImp();
+  public abstract void eatSoulImp();
 
 }
diff --git a/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java b/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java
index 589156fe3..ebbe0c23f 100644
--- a/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java
+++ b/bridge/src/main/java/com/iluwatar/bridge/Stormbringer.java
@@ -7,24 +7,23 @@ package com.iluwatar.bridge;
  */
 public class Stormbringer extends SoulEatingMagicWeaponImpl {
 
-	@Override
-	public void wieldImp() {
-		System.out.println("wielding Stormbringer");
-	}
+  @Override
+  public void wieldImp() {
+    System.out.println("wielding Stormbringer");
+  }
 
-	@Override
-	public void swingImp() {
-		System.out.println("swinging Stormbringer");
-	}
+  @Override
+  public void swingImp() {
+    System.out.println("swinging Stormbringer");
+  }
 
-	@Override
-	public void unwieldImp() {
-		System.out.println("unwielding Stormbringer");
-	}
-
-	@Override
-	public void eatSoulImp() {
-		System.out.println("Stormbringer devours the enemy's soul");
-	}
+  @Override
+  public void unwieldImp() {
+    System.out.println("unwielding Stormbringer");
+  }
 
+  @Override
+  public void eatSoulImp() {
+    System.out.println("Stormbringer devours the enemy's soul");
+  }
 }
diff --git a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
index b53111c8e..99faad43e 100644
--- a/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
+++ b/bridge/src/test/java/com/iluwatar/bridge/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.bridge.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }

From 3af06a3a3afe85dd358ec99e958ad88a0400ff40 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 18:03:29 -0500
Subject: [PATCH 307/687] Reformat builder pattern - issue #224

---
 .../main/java/com/iluwatar/builder/App.java   |  76 +++----
 .../main/java/com/iluwatar/builder/Armor.java |  18 +-
 .../java/com/iluwatar/builder/HairColor.java  |  10 +-
 .../java/com/iluwatar/builder/HairType.java   |  19 +-
 .../main/java/com/iluwatar/builder/Hero.java  | 203 +++++++++---------
 .../java/com/iluwatar/builder/Profession.java |  11 +-
 .../java/com/iluwatar/builder/Weapon.java     |  11 +-
 .../java/com/iluwatar/builder/AppTest.java    |  12 +-
 8 files changed, 179 insertions(+), 181 deletions(-)

diff --git a/builder/src/main/java/com/iluwatar/builder/App.java b/builder/src/main/java/com/iluwatar/builder/App.java
index b6131c3ab..b5c8fd7a9 100644
--- a/builder/src/main/java/com/iluwatar/builder/App.java
+++ b/builder/src/main/java/com/iluwatar/builder/App.java
@@ -1,55 +1,55 @@
 package com.iluwatar.builder;
 
-import com.iluwatar. builder.Hero.HeroBuilder;
+import com.iluwatar.builder.Hero.HeroBuilder;
 
 /**
  * 
- * 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 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.
+ * 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.
+ * 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 HeroBuilder} class.
- * {@link HeroBuilder} 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 HeroBuilder} interface. When configuration is ready the
- * build method is called to receive the final {@link Hero} object.
+ * 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 HeroBuilder} class. {@link HeroBuilder}
+ * 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 HeroBuilder} interface. When configuration is ready the build method is called to receive
+ * the final {@link Hero} object.
  * 
  */
 public class App {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
 
-		Hero mage = new HeroBuilder(Profession.MAGE, "Riobard")
-				.withHairColor(HairColor.BLACK).withWeapon(Weapon.DAGGER)
-				.build();
-		System.out.println(mage);
+    Hero mage =
+        new HeroBuilder(Profession.MAGE, "Riobard").withHairColor(HairColor.BLACK)
+            .withWeapon(Weapon.DAGGER).build();
+    System.out.println(mage);
 
-		Hero warrior = new HeroBuilder(Profession.WARRIOR, "Amberjill")
-				.withHairColor(HairColor.BLOND)
-				.withHairType(HairType.LONG_CURLY).withArmor(Armor.CHAIN_MAIL)
-				.withWeapon(Weapon.SWORD).build();
-		System.out.println(warrior);
+    Hero warrior =
+        new HeroBuilder(Profession.WARRIOR, "Amberjill").withHairColor(HairColor.BLOND)
+            .withHairType(HairType.LONG_CURLY).withArmor(Armor.CHAIN_MAIL).withWeapon(Weapon.SWORD)
+            .build();
+    System.out.println(warrior);
 
-		Hero thief = new HeroBuilder(Profession.THIEF, "Desmond")
-				.withHairType(HairType.BALD).withWeapon(Weapon.BOW).build();
-		System.out.println(thief);
+    Hero thief =
+        new HeroBuilder(Profession.THIEF, "Desmond").withHairType(HairType.BALD)
+            .withWeapon(Weapon.BOW).build();
+    System.out.println(thief);
 
-	}
+  }
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/Armor.java b/builder/src/main/java/com/iluwatar/builder/Armor.java
index 95fcba43b..6b67b8f94 100644
--- a/builder/src/main/java/com/iluwatar/builder/Armor.java
+++ b/builder/src/main/java/com/iluwatar/builder/Armor.java
@@ -7,16 +7,16 @@ package com.iluwatar.builder;
  */
 public enum Armor {
 
-	CLOTHES("clothes"), LEATHER("leather"), CHAIN_MAIL("chain mail"), PLATE_MAIL("plate mail");
+  CLOTHES("clothes"), LEATHER("leather"), CHAIN_MAIL("chain mail"), PLATE_MAIL("plate mail");
 
-    private String title;
+  private String title;
 
-    Armor(String title) {
-        this.title = title;
-    }
+  Armor(String title) {
+    this.title = title;
+  }
 
-    @Override
-	public String toString() {
-		return title;
-	}
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/HairColor.java b/builder/src/main/java/com/iluwatar/builder/HairColor.java
index dd8ec2ecc..b99b3db63 100644
--- a/builder/src/main/java/com/iluwatar/builder/HairColor.java
+++ b/builder/src/main/java/com/iluwatar/builder/HairColor.java
@@ -7,11 +7,11 @@ package com.iluwatar.builder;
  */
 public enum HairColor {
 
-	WHITE, BLOND, RED, BROWN, BLACK;
+  WHITE, BLOND, RED, BROWN, BLACK;
 
-	@Override
-	public String toString() {
-		return name().toLowerCase();
-	}
+  @Override
+  public String toString() {
+    return name().toLowerCase();
+  }
 
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/HairType.java b/builder/src/main/java/com/iluwatar/builder/HairType.java
index ea49c0470..48eeac950 100644
--- a/builder/src/main/java/com/iluwatar/builder/HairType.java
+++ b/builder/src/main/java/com/iluwatar/builder/HairType.java
@@ -7,16 +7,17 @@ package com.iluwatar.builder;
  */
 public enum HairType {
 
-	BALD("bald"), SHORT("short"), CURLY("curly"), LONG_STRAIGHT("long straight"), LONG_CURLY("long curly");
+  BALD("bald"), SHORT("short"), CURLY("curly"), LONG_STRAIGHT("long straight"), LONG_CURLY(
+      "long curly");
 
-    private String title;
+  private String title;
 
-    HairType(String title) {
-        this.title = title;
-    }
+  HairType(String title) {
+    this.title = title;
+  }
 
-    @Override
-	public String toString() {
-		return title;
-	}
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/Hero.java b/builder/src/main/java/com/iluwatar/builder/Hero.java
index 05304bf09..54be11ea3 100644
--- a/builder/src/main/java/com/iluwatar/builder/Hero.java
+++ b/builder/src/main/java/com/iluwatar/builder/Hero.java
@@ -7,123 +7,122 @@ package com.iluwatar.builder;
  */
 public 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 final Profession profession;
+  private final String name;
+  private final HairType hairType;
+  private final HairColor hairColor;
+  private final Armor armor;
+  private final Weapon weapon;
 
-	public Profession getProfession() {
-		return profession;
-	}
+  public Profession getProfession() {
+    return profession;
+  }
 
-	public String getName() {
-		return name;
-	}
+  public String getName() {
+    return name;
+  }
 
-	public HairType getHairType() {
-		return hairType;
-	}
+  public HairType getHairType() {
+    return hairType;
+  }
 
-	public HairColor getHairColor() {
-		return hairColor;
-	}
+  public HairColor getHairColor() {
+    return hairColor;
+  }
 
-	public Armor getArmor() {
-		return armor;
-	}
+  public Armor getArmor() {
+    return armor;
+  }
 
-	public Weapon getWeapon() {
-		return weapon;
-	}
+  public Weapon getWeapon() {
+    return weapon;
+  }
 
-	@Override
-	public String toString() {
+  @Override
+  public String toString() {
 
-		StringBuilder sb = new StringBuilder();
-		sb.append("This is a ");
-		sb.append(profession);
-		sb.append(" named ");
-		sb.append(name);
-		if (hairColor != null || hairType != null) {
-			sb.append(" with ");
-			if (hairColor != null) {
-				sb.append(hairColor);
-				sb.append(" ");
-			}
-			if (hairType != null) {
-				sb.append(hairType);
-				sb.append(" ");
-			}
-			sb.append(hairType != HairType.BALD ? "hair" : "head");
-		}
-		if (armor != null) {
-			sb.append(" wearing ");
-			sb.append(armor);
-		}
-		if (weapon != null) {
-			sb.append(" and wielding a ");
-			sb.append(weapon);
-		}
-		sb.append(".");
-		return sb.toString();
-	}
+    StringBuilder sb = new StringBuilder();
+    sb.append("This is a ");
+    sb.append(profession);
+    sb.append(" named ");
+    sb.append(name);
+    if (hairColor != null || hairType != null) {
+      sb.append(" with ");
+      if (hairColor != null) {
+        sb.append(hairColor);
+        sb.append(" ");
+      }
+      if (hairType != null) {
+        sb.append(hairType);
+        sb.append(" ");
+      }
+      sb.append(hairType != HairType.BALD ? "hair" : "head");
+    }
+    if (armor != null) {
+      sb.append(" wearing ");
+      sb.append(armor);
+    }
+    if (weapon != null) {
+      sb.append(" and wielding a ");
+      sb.append(weapon);
+    }
+    sb.append(".");
+    return sb.toString();
+  }
 
-	private Hero(HeroBuilder 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;
-	}
+  private Hero(HeroBuilder 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;
+  }
 
-	/**
-	 * 
-	 * The builder class.
-	 * 
-	 */
-	public static class HeroBuilder {
+  /**
+   * 
+   * The builder class.
+   * 
+   */
+  public static class HeroBuilder {
 
-		private final Profession profession;
-		private final String name;
-		private HairType hairType;
-		private HairColor hairColor;
-		private Armor armor;
-		private Weapon weapon;
+    private final Profession profession;
+    private final String name;
+    private HairType hairType;
+    private HairColor hairColor;
+    private Armor armor;
+    private Weapon weapon;
 
-		public HeroBuilder(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 HeroBuilder(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 HeroBuilder withHairType(HairType hairType) {
-			this.hairType = hairType;
-			return this;
-		}
+    public HeroBuilder withHairType(HairType hairType) {
+      this.hairType = hairType;
+      return this;
+    }
 
-		public HeroBuilder withHairColor(HairColor hairColor) {
-			this.hairColor = hairColor;
-			return this;
-		}
+    public HeroBuilder withHairColor(HairColor hairColor) {
+      this.hairColor = hairColor;
+      return this;
+    }
 
-		public HeroBuilder withArmor(Armor armor) {
-			this.armor = armor;
-			return this;
-		}
+    public HeroBuilder withArmor(Armor armor) {
+      this.armor = armor;
+      return this;
+    }
 
-		public HeroBuilder withWeapon(Weapon weapon) {
-			this.weapon = weapon;
-			return this;
-		}
+    public HeroBuilder withWeapon(Weapon weapon) {
+      this.weapon = weapon;
+      return this;
+    }
 
-		public Hero build() {
-			return new Hero(this);
-		}
-	}
+    public Hero build() {
+      return new Hero(this);
+    }
+  }
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/Profession.java b/builder/src/main/java/com/iluwatar/builder/Profession.java
index c9a7cc4e9..a157366b4 100644
--- a/builder/src/main/java/com/iluwatar/builder/Profession.java
+++ b/builder/src/main/java/com/iluwatar/builder/Profession.java
@@ -7,11 +7,10 @@ package com.iluwatar.builder;
  */
 public enum Profession {
 
-	WARRIOR, THIEF, MAGE, PRIEST;
-
-	@Override
-	public String toString() {
-		return name().toLowerCase();
-	}
+  WARRIOR, THIEF, MAGE, PRIEST;
 
+  @Override
+  public String toString() {
+    return name().toLowerCase();
+  }
 }
diff --git a/builder/src/main/java/com/iluwatar/builder/Weapon.java b/builder/src/main/java/com/iluwatar/builder/Weapon.java
index af71c596d..08f55c65c 100644
--- a/builder/src/main/java/com/iluwatar/builder/Weapon.java
+++ b/builder/src/main/java/com/iluwatar/builder/Weapon.java
@@ -7,11 +7,10 @@ package com.iluwatar.builder;
  */
 public enum Weapon {
 
-	DAGGER, SWORD, AXE, WARHAMMER, BOW;
-
-	@Override
-	public String toString() {
-		return name().toLowerCase();
-	}
+  DAGGER, SWORD, AXE, WARHAMMER, BOW;
 
+  @Override
+  public String toString() {
+    return name().toLowerCase();
+  }
 }
diff --git a/builder/src/test/java/com/iluwatar/builder/AppTest.java b/builder/src/test/java/com/iluwatar/builder/AppTest.java
index acae1ca70..857f49dc9 100644
--- a/builder/src/test/java/com/iluwatar/builder/AppTest.java
+++ b/builder/src/test/java/com/iluwatar/builder/AppTest.java
@@ -2,7 +2,7 @@ package com.iluwatar.builder;
 
 import org.junit.Test;
 
-import com.iluwatar. builder.App;
+import com.iluwatar.builder.App;
 
 /**
  * 
@@ -11,9 +11,9 @@ import com.iluwatar. builder.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }

From 449340bd2b7307687f406fc8d0a1ca04d24f2161 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 18:48:43 -0500
Subject: [PATCH 308/687] Reformat business-delegate, callback, chain, command,
 composite, dao, decorator & dependency-injection patterns.

---
 .../com/iluwatar/business/delegate/App.java   | 48 ++++++-----
 .../business/delegate/BusinessDelegate.java   | 22 ++---
 .../business/delegate/BusinessLookup.java     | 14 +--
 .../business/delegate/BusinessService.java    |  2 +-
 .../iluwatar/business/delegate/Client.java    | 14 +--
 .../business/delegate/EjbService.java         |  8 +-
 .../business/delegate/JmsService.java         |  8 +-
 .../business/delegate/ServiceType.java        |  4 +-
 .../iluwatar/business/delegate/AppTest.java   | 12 +--
 .../main/java/com/iluwatar/callback/App.java  | 25 +++---
 .../java/com/iluwatar/callback/Callback.java  |  2 +-
 .../com/iluwatar/callback/SimpleTask.java     |  9 +-
 .../main/java/com/iluwatar/callback/Task.java | 14 +--
 .../java/com/iluwatar/callback/AppTest.java   | 36 ++++----
 .../src/main/java/com/iluwatar/chain/App.java | 39 ++++-----
 .../java/com/iluwatar/chain/OrcCommander.java | 30 +++----
 .../main/java/com/iluwatar/chain/OrcKing.java | 20 ++---
 .../java/com/iluwatar/chain/OrcOfficer.java   | 30 +++----
 .../java/com/iluwatar/chain/OrcSoldier.java   | 30 +++----
 .../main/java/com/iluwatar/chain/Request.java | 44 +++++-----
 .../com/iluwatar/chain/RequestHandler.java    | 28 +++---
 .../java/com/iluwatar/chain/RequestType.java  |  2 +-
 .../test/java/com/iluwatar/chain/AppTest.java | 10 +--
 .../main/java/com/iluwatar/command/App.java   | 70 +++++++--------
 .../java/com/iluwatar/command/Command.java    | 10 +--
 .../java/com/iluwatar/command/Goblin.java     | 16 ++--
 .../iluwatar/command/InvisibilitySpell.java   | 44 +++++-----
 .../com/iluwatar/command/ShrinkSpell.java     | 48 +++++------
 .../main/java/com/iluwatar/command/Size.java  | 20 ++---
 .../java/com/iluwatar/command/Target.java     | 42 ++++-----
 .../java/com/iluwatar/command/Visibility.java | 18 ++--
 .../java/com/iluwatar/command/Wizard.java     | 57 ++++++------
 .../java/com/iluwatar/command/AppTest.java    | 10 +--
 .../main/java/com/iluwatar/composite/App.java | 41 ++++-----
 .../java/com/iluwatar/composite/Letter.java   | 25 +++---
 .../iluwatar/composite/LetterComposite.java   | 32 +++----
 .../com/iluwatar/composite/Messenger.java     | 67 +++++++--------
 .../java/com/iluwatar/composite/Sentence.java | 27 +++---
 .../java/com/iluwatar/composite/Word.java     | 27 +++---
 .../java/com/iluwatar/composite/AppTest.java  | 10 +--
 dao/src/main/java/com/iluwatar/dao/App.java   | 86 ++++++++++---------
 .../main/java/com/iluwatar/decorator/App.java | 52 +++++------
 .../java/com/iluwatar/decorator/Hostile.java  |  6 +-
 .../com/iluwatar/decorator/SmartTroll.java    | 46 +++++-----
 .../java/com/iluwatar/decorator/Troll.java    | 21 +++--
 .../java/com/iluwatar/decorator/AppTest.java  | 10 +--
 .../dependency/injection/AdvancedWizard.java  | 23 +++--
 .../iluwatar/dependency/injection/App.java    | 65 +++++++-------
 .../dependency/injection/GuiceWizard.java     | 27 +++---
 .../dependency/injection/SimpleWizard.java    | 16 ++--
 .../dependency/injection/Tobacco.java         |  9 +-
 .../dependency/injection/TobaccoModule.java   |  8 +-
 .../iluwatar/dependency/injection/Wizard.java |  4 +-
 .../dependency/injection/AppTest.java         | 10 +--
 54 files changed, 698 insertions(+), 700 deletions(-)

diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
index eea7608eb..c900f7366 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/App.java
@@ -2,34 +2,36 @@ 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.
+ * 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.
+ * 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.
+ * 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();
-		businessDelegate.setServiceType(ServiceType.EJB);
 
-		Client client = new Client(businessDelegate);
-		client.doTask();
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
 
-		businessDelegate.setServiceType(ServiceType.JMS);
-		client.doTask();
-	}
+    BusinessDelegate businessDelegate = new BusinessDelegate();
+    businessDelegate.setServiceType(ServiceType.EJB);
+
+    Client client = new Client(businessDelegate);
+    client.doTask();
+
+    businessDelegate.setServiceType(ServiceType.JMS);
+    client.doTask();
+  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
index cf0809b97..b8a70aa0e 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessDelegate.java
@@ -6,17 +6,17 @@ package com.iluwatar.business.delegate;
  *
  */
 public class BusinessDelegate {
-	
-	private BusinessLookup lookupService = new BusinessLookup();
-	private BusinessService businessService;
-	private ServiceType serviceType;
 
-	public void setServiceType(ServiceType serviceType) {
-		this.serviceType = serviceType;
-	}
+  private BusinessLookup lookupService = new BusinessLookup();
+  private BusinessService businessService;
+  private ServiceType serviceType;
 
-	public void doTask() {
-		businessService = lookupService.getBusinessService(serviceType);
-		businessService.doProcessing();
-	}
+  public void setServiceType(ServiceType serviceType) {
+    this.serviceType = serviceType;
+  }
+
+  public void doTask() {
+    businessService = lookupService.getBusinessService(serviceType);
+    businessService.doProcessing();
+  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
index 6a5f2d504..7cea16580 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessLookup.java
@@ -7,11 +7,11 @@ package com.iluwatar.business.delegate;
  */
 public class BusinessLookup {
 
-	public BusinessService getBusinessService(ServiceType serviceType) {
-		if (serviceType.equals(ServiceType.EJB)) {
-			return new EjbService();
-		} else {
-			return new JmsService();
-		}
-	}
+  public BusinessService getBusinessService(ServiceType serviceType) {
+    if (serviceType.equals(ServiceType.EJB)) {
+      return new EjbService();
+    } else {
+      return new JmsService();
+    }
+  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
index 7e39745d5..dfeaf883a 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/BusinessService.java
@@ -7,5 +7,5 @@ package com.iluwatar.business.delegate;
  */
 public interface BusinessService {
 
-	void doProcessing();
+  void doProcessing();
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
index 2dc0cc662..eab295cf2 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/Client.java
@@ -7,13 +7,13 @@ package com.iluwatar.business.delegate;
  */
 public class Client {
 
-	private BusinessDelegate businessDelegate;
+  private BusinessDelegate businessDelegate;
 
-	public Client(BusinessDelegate businessDelegate) {
-		this.businessDelegate = businessDelegate;
-	}
+  public Client(BusinessDelegate businessDelegate) {
+    this.businessDelegate = businessDelegate;
+  }
 
-	public void doTask() {
-		businessDelegate.doTask();
-	}
+  public void doTask() {
+    businessDelegate.doTask();
+  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
index bd03db45d..f387449e2 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/EjbService.java
@@ -7,8 +7,8 @@ package com.iluwatar.business.delegate;
  */
 public class EjbService implements BusinessService {
 
-	@Override
-	public void doProcessing() {
-		System.out.println("EjbService is now processing");
-	}
+  @Override
+  public void doProcessing() {
+    System.out.println("EjbService is now processing");
+  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
index 37425755a..fd74cf3c2 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/JmsService.java
@@ -7,8 +7,8 @@ package com.iluwatar.business.delegate;
  */
 public class JmsService implements BusinessService {
 
-	@Override
-	public void doProcessing() {
-		System.out.println("JmsService is now processing");
-	}
+  @Override
+  public void doProcessing() {
+    System.out.println("JmsService is now processing");
+  }
 }
diff --git a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
index e26d71ae6..ac42d3b6c 100644
--- a/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
+++ b/business-delegate/src/main/java/com/iluwatar/business/delegate/ServiceType.java
@@ -6,6 +6,6 @@ package com.iluwatar.business.delegate;
  *
  */
 public enum ServiceType {
-	
-	EJB, JMS;
+
+  EJB, JMS;
 }
diff --git a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
index 7ce63c2b4..5ff7e6784 100644
--- a/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
+++ b/business-delegate/src/test/java/com/iluwatar/business/delegate/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.business.delegate.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/callback/src/main/java/com/iluwatar/callback/App.java b/callback/src/main/java/com/iluwatar/callback/App.java
index 513a32415..81cb16f73 100644
--- a/callback/src/main/java/com/iluwatar/callback/App.java
+++ b/callback/src/main/java/com/iluwatar/callback/App.java
@@ -2,20 +2,21 @@ package com.iluwatar.callback;
 
 /**
  * 
- * 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.
+ * 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 {
 
-	public static void main(String[] args) {
-		Task task = new SimpleTask();
-		Callback callback = new Callback() {
-			@Override
-			public void call() {
-				System.out.println("I'm done now.");
-			}
-		};
-		task.executeWith(callback);
-	}
+  public static void main(String[] args) {
+    Task task = new SimpleTask();
+    Callback callback = new Callback() {
+      @Override
+      public void call() {
+        System.out.println("I'm done now.");
+      }
+    };
+    task.executeWith(callback);
+  }
 }
diff --git a/callback/src/main/java/com/iluwatar/callback/Callback.java b/callback/src/main/java/com/iluwatar/callback/Callback.java
index 81a421c0d..08939298b 100644
--- a/callback/src/main/java/com/iluwatar/callback/Callback.java
+++ b/callback/src/main/java/com/iluwatar/callback/Callback.java
@@ -7,5 +7,5 @@ package com.iluwatar.callback;
  */
 public interface Callback {
 
-	public void call();
+  public void call();
 }
diff --git a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
index 70b844ce3..a651ed7b6 100644
--- a/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
+++ b/callback/src/main/java/com/iluwatar/callback/SimpleTask.java
@@ -7,9 +7,8 @@ package com.iluwatar.callback;
  */
 public class SimpleTask extends Task {
 
-	@Override
-	public void execute() {
-		System.out.println("Perform some important activity and after call the callback method.");
-	}
-
+  @Override
+  public void execute() {
+    System.out.println("Perform some important activity and after call the callback method.");
+  }
 }
diff --git a/callback/src/main/java/com/iluwatar/callback/Task.java b/callback/src/main/java/com/iluwatar/callback/Task.java
index db4b66dc5..d3be6c7a0 100644
--- a/callback/src/main/java/com/iluwatar/callback/Task.java
+++ b/callback/src/main/java/com/iluwatar/callback/Task.java
@@ -7,12 +7,12 @@ package com.iluwatar.callback;
  */
 public abstract class Task {
 
-	public final void executeWith(Callback callback) {
-		execute();
-		if (callback != null) {
-			callback.call();
-		}
-	}
+  public final void executeWith(Callback callback) {
+    execute();
+    if (callback != null) {
+      callback.call();
+    }
+  }
 
-	public abstract void execute();
+  public abstract void execute();
 }
diff --git a/callback/src/test/java/com/iluwatar/callback/AppTest.java b/callback/src/test/java/com/iluwatar/callback/AppTest.java
index 0f7a6f45e..67046a175 100644
--- a/callback/src/test/java/com/iluwatar/callback/AppTest.java
+++ b/callback/src/test/java/com/iluwatar/callback/AppTest.java
@@ -5,35 +5,35 @@ 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.
+ * 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 AppTest {
 
-    private Integer callingCount = 0;
+  private Integer callingCount = 0;
 
-	@Test
-	public void test() {
-        Callback callback = new Callback() {
-            @Override
-            public void call() {
-                callingCount++;
-            }
-        };
+  @Test
+  public void test() {
+    Callback callback = new Callback() {
+      @Override
+      public void call() {
+        callingCount++;
+      }
+    };
 
-        Task task = new SimpleTask();
+    Task task = new SimpleTask();
 
-        assertEquals("Initial calling count of 0", new Integer(0), callingCount);
+    assertEquals("Initial calling count of 0", new Integer(0), callingCount);
 
-        task.executeWith(callback);
+    task.executeWith(callback);
 
-        assertEquals("Callback called once", new Integer(1), callingCount);
+    assertEquals("Callback called once", new Integer(1), callingCount);
 
-        task.executeWith(callback);
+    task.executeWith(callback);
 
-        assertEquals("Callback called twice", new Integer(2), callingCount);
+    assertEquals("Callback called twice", new Integer(2), callingCount);
 
-	}
+  }
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/App.java b/chain/src/main/java/com/iluwatar/chain/App.java
index 4d3ca69db..ae8c74143 100644
--- a/chain/src/main/java/com/iluwatar/chain/App.java
+++ b/chain/src/main/java/com/iluwatar/chain/App.java
@@ -2,31 +2,30 @@ 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.
+ * 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.
+ * 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) {
+  /**
+   * 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"));
+    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"));
 
-	}
+  }
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcCommander.java b/chain/src/main/java/com/iluwatar/chain/OrcCommander.java
index fb5134e01..73de1b8b2 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcCommander.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcCommander.java
@@ -7,21 +7,21 @@ package com.iluwatar.chain;
  */
 public class OrcCommander extends RequestHandler {
 
-	public OrcCommander(RequestHandler handler) {
-		super(handler);
-	}
+  public OrcCommander(RequestHandler handler) {
+    super(handler);
+  }
 
-	@Override
-	public void handleRequest(Request req) {
-		if (req.getRequestType().equals(RequestType.DEFEND_CASTLE)) {
-			printHandling(req);
-		} else {
-			super.handleRequest(req);
-		}
-	}
+  @Override
+  public void handleRequest(Request req) {
+    if (req.getRequestType().equals(RequestType.DEFEND_CASTLE)) {
+      printHandling(req);
+    } else {
+      super.handleRequest(req);
+    }
+  }
 
-	@Override
-	public String toString() {
-		return "Orc commander";
-	}
+  @Override
+  public String toString() {
+    return "Orc commander";
+  }
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcKing.java b/chain/src/main/java/com/iluwatar/chain/OrcKing.java
index b39959935..640b190b2 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcKing.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcKing.java
@@ -7,18 +7,18 @@ package com.iluwatar.chain;
  */
 public class OrcKing {
 
-	RequestHandler chain;
+  RequestHandler chain;
 
-	public OrcKing() {
-		buildChain();
-	}
+  public OrcKing() {
+    buildChain();
+  }
 
-	private void buildChain() {
-		chain = new OrcCommander(new OrcOfficer(new OrcSoldier(null)));
-	}
+  private void buildChain() {
+    chain = new OrcCommander(new OrcOfficer(new OrcSoldier(null)));
+  }
 
-	public void makeRequest(Request req) {
-		chain.handleRequest(req);
-	}
+  public void makeRequest(Request req) {
+    chain.handleRequest(req);
+  }
 
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java b/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java
index 131cb1101..68df3ec6f 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcOfficer.java
@@ -7,22 +7,22 @@ package com.iluwatar.chain;
  */
 public class OrcOfficer extends RequestHandler {
 
-	public OrcOfficer(RequestHandler handler) {
-		super(handler);
-	}
+  public OrcOfficer(RequestHandler handler) {
+    super(handler);
+  }
 
-	@Override
-	public void handleRequest(Request req) {
-		if (req.getRequestType().equals(RequestType.TORTURE_PRISONER)) {
-			printHandling(req);
-		} else {
-			super.handleRequest(req);
-		}
-	}
+  @Override
+  public void handleRequest(Request req) {
+    if (req.getRequestType().equals(RequestType.TORTURE_PRISONER)) {
+      printHandling(req);
+    } else {
+      super.handleRequest(req);
+    }
+  }
 
-	@Override
-	public String toString() {
-		return "Orc officer";
-	}
+  @Override
+  public String toString() {
+    return "Orc officer";
+  }
 
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java b/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java
index a681dfb77..d96f51702 100644
--- a/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java
+++ b/chain/src/main/java/com/iluwatar/chain/OrcSoldier.java
@@ -7,21 +7,21 @@ package com.iluwatar.chain;
  */
 public class OrcSoldier extends RequestHandler {
 
-	public OrcSoldier(RequestHandler handler) {
-		super(handler);
-	}
+  public OrcSoldier(RequestHandler handler) {
+    super(handler);
+  }
 
-	@Override
-	public void handleRequest(Request req) {
-		if (req.getRequestType().equals(RequestType.COLLECT_TAX)) {
-			printHandling(req);
-		} else {
-			super.handleRequest(req);
-		}
-	}
+  @Override
+  public void handleRequest(Request req) {
+    if (req.getRequestType().equals(RequestType.COLLECT_TAX)) {
+      printHandling(req);
+    } else {
+      super.handleRequest(req);
+    }
+  }
 
-	@Override
-	public String toString() {
-		return "Orc soldier";
-	}
+  @Override
+  public String toString() {
+    return "Orc soldier";
+  }
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/Request.java b/chain/src/main/java/com/iluwatar/chain/Request.java
index 558ee65d1..0c62cfd43 100644
--- a/chain/src/main/java/com/iluwatar/chain/Request.java
+++ b/chain/src/main/java/com/iluwatar/chain/Request.java
@@ -7,32 +7,32 @@ package com.iluwatar.chain;
  */
 public class Request {
 
-	private String requestDescription;
-	private RequestType requestType;
+  private String requestDescription;
+  private RequestType requestType;
 
-	public Request(RequestType requestType, String requestDescription) {
-		this.setRequestType(requestType);
-		this.setRequestDescription(requestDescription);
-	}
+  public Request(RequestType requestType, String requestDescription) {
+    this.setRequestType(requestType);
+    this.setRequestDescription(requestDescription);
+  }
 
-	public String getRequestDescription() {
-		return requestDescription;
-	}
+  public String getRequestDescription() {
+    return requestDescription;
+  }
 
-	public void setRequestDescription(String requestDescription) {
-		this.requestDescription = requestDescription;
-	}
+  public void setRequestDescription(String requestDescription) {
+    this.requestDescription = requestDescription;
+  }
 
-	public RequestType getRequestType() {
-		return requestType;
-	}
+  public RequestType getRequestType() {
+    return requestType;
+  }
 
-	public void setRequestType(RequestType requestType) {
-		this.requestType = requestType;
-	}
+  public void setRequestType(RequestType requestType) {
+    this.requestType = requestType;
+  }
 
-	@Override
-	public String toString() {
-		return getRequestDescription();
-	}
+  @Override
+  public String toString() {
+    return getRequestDescription();
+  }
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
index 5570c20ce..fd58b9ea8 100644
--- a/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
+++ b/chain/src/main/java/com/iluwatar/chain/RequestHandler.java
@@ -7,22 +7,22 @@ package com.iluwatar.chain;
  */
 public abstract class RequestHandler {
 
-	private RequestHandler next;
+  private RequestHandler next;
 
-	public RequestHandler(RequestHandler next) {
-		this.next = next;
-	}
+  public RequestHandler(RequestHandler next) {
+    this.next = next;
+  }
 
-	public void handleRequest(Request req) {
-		if (next != null) {
-			next.handleRequest(req);
-		}
-	}
+  public void handleRequest(Request req) {
+    if (next != null) {
+      next.handleRequest(req);
+    }
+  }
 
-	protected void printHandling(Request req) {
-		System.out.println(this + " handling request \"" + req + "\"");
-	}
+  protected void printHandling(Request req) {
+    System.out.println(this + " handling request \"" + req + "\"");
+  }
 
-	@Override
-	public abstract String toString();
+  @Override
+  public abstract String toString();
 }
diff --git a/chain/src/main/java/com/iluwatar/chain/RequestType.java b/chain/src/main/java/com/iluwatar/chain/RequestType.java
index 9ad975d2f..443d6dced 100644
--- a/chain/src/main/java/com/iluwatar/chain/RequestType.java
+++ b/chain/src/main/java/com/iluwatar/chain/RequestType.java
@@ -7,6 +7,6 @@ package com.iluwatar.chain;
  */
 public enum RequestType {
 
-	DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX
+  DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX
 
 }
diff --git a/chain/src/test/java/com/iluwatar/chain/AppTest.java b/chain/src/test/java/com/iluwatar/chain/AppTest.java
index aa52e60e2..bd28b007a 100644
--- a/chain/src/test/java/com/iluwatar/chain/AppTest.java
+++ b/chain/src/test/java/com/iluwatar/chain/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.chain.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/App.java b/command/src/main/java/com/iluwatar/command/App.java
index b421b683b..423ce6075 100644
--- a/command/src/main/java/com/iluwatar/command/App.java
+++ b/command/src/main/java/com/iluwatar/command/App.java
@@ -2,52 +2,54 @@ 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.
+ * 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.
+ * 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.
+ * 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();
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    Wizard wizard = new Wizard();
+    Goblin goblin = new Goblin();
 
-		goblin.printStatus();
+    goblin.printStatus();
 
-		wizard.castSpell(new ShrinkSpell(), goblin);
-		goblin.printStatus();
+    wizard.castSpell(new ShrinkSpell(), goblin);
+    goblin.printStatus();
 
-		wizard.castSpell(new InvisibilitySpell(), goblin);
-		goblin.printStatus();
+    wizard.castSpell(new InvisibilitySpell(), goblin);
+    goblin.printStatus();
 
-		wizard.undoLastSpell();
-		goblin.printStatus();
+    wizard.undoLastSpell();
+    goblin.printStatus();
 
-		wizard.undoLastSpell();
-		goblin.printStatus();
+    wizard.undoLastSpell();
+    goblin.printStatus();
 
-		wizard.redoLastSpell();
-		goblin.printStatus();
+    wizard.redoLastSpell();
+    goblin.printStatus();
 
-		wizard.redoLastSpell();
-		goblin.printStatus();
-	}
+    wizard.redoLastSpell();
+    goblin.printStatus();
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/Command.java b/command/src/main/java/com/iluwatar/command/Command.java
index 9ffeed24d..4b5127263 100644
--- a/command/src/main/java/com/iluwatar/command/Command.java
+++ b/command/src/main/java/com/iluwatar/command/Command.java
@@ -7,13 +7,13 @@ package com.iluwatar.command;
  */
 public abstract class Command {
 
-	public abstract void execute(Target target);
+  public abstract void execute(Target target);
 
-	public abstract void undo();
+  public abstract void undo();
 
-	public abstract void redo();
+  public abstract void redo();
 
-	@Override
-	public abstract String toString();
+  @Override
+  public abstract String toString();
 
 }
diff --git a/command/src/main/java/com/iluwatar/command/Goblin.java b/command/src/main/java/com/iluwatar/command/Goblin.java
index 7d0804b0c..d5fcb7078 100644
--- a/command/src/main/java/com/iluwatar/command/Goblin.java
+++ b/command/src/main/java/com/iluwatar/command/Goblin.java
@@ -7,14 +7,14 @@ package com.iluwatar.command;
  */
 public class Goblin extends Target {
 
-	public Goblin() {
-		setSize(Size.NORMAL);
-		setVisibility(Visibility.VISIBLE);
-	}
+  public Goblin() {
+    setSize(Size.NORMAL);
+    setVisibility(Visibility.VISIBLE);
+  }
 
-	@Override
-	public String toString() {
-		return "Goblin";
-	}
+  @Override
+  public String toString() {
+    return "Goblin";
+  }
 
 }
diff --git a/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java b/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java
index b72c34cc2..02f1b1cc1 100644
--- a/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java
+++ b/command/src/main/java/com/iluwatar/command/InvisibilitySpell.java
@@ -7,30 +7,30 @@ package com.iluwatar.command;
  */
 public class InvisibilitySpell extends Command {
 
-	private Target target;
+  private Target target;
 
-	@Override
-	public void execute(Target target) {
-		target.setVisibility(Visibility.INVISIBLE);
-		this.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 undo() {
+    if (target != null) {
+      target.setVisibility(Visibility.VISIBLE);
+    }
+  }
 
-	@Override
-	public void redo() {
-		if (target != null) {
-			target.setVisibility(Visibility.INVISIBLE);
-		}
-	}
+  @Override
+  public void redo() {
+    if (target != null) {
+      target.setVisibility(Visibility.INVISIBLE);
+    }
+  }
 
-	@Override
-	public String toString() {
-		return "Invisibility spell";
-	}
+  @Override
+  public String toString() {
+    return "Invisibility spell";
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/ShrinkSpell.java b/command/src/main/java/com/iluwatar/command/ShrinkSpell.java
index f36438082..46448bf6c 100644
--- a/command/src/main/java/com/iluwatar/command/ShrinkSpell.java
+++ b/command/src/main/java/com/iluwatar/command/ShrinkSpell.java
@@ -7,32 +7,32 @@ package com.iluwatar.command;
  */
 public class ShrinkSpell extends Command {
 
-	private Size oldSize;
-	private Target target;
+  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 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 undo() {
+    if (oldSize != null && target != null) {
+      Size temp = target.getSize();
+      target.setSize(oldSize);
+      oldSize = temp;
+    }
+  }
 
-	@Override
-	public void redo() {
-		undo();
-	}
+  @Override
+  public void redo() {
+    undo();
+  }
 
-	@Override
-	public String toString() {
-		return "Shrink spell";
-	}
+  @Override
+  public String toString() {
+    return "Shrink spell";
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/Size.java b/command/src/main/java/com/iluwatar/command/Size.java
index a9c20bd59..2a443b449 100644
--- a/command/src/main/java/com/iluwatar/command/Size.java
+++ b/command/src/main/java/com/iluwatar/command/Size.java
@@ -7,16 +7,16 @@ package com.iluwatar.command;
  */
 public enum Size {
 
-    SMALL("small"), NORMAL("normal"), LARGE("large"), UNDEFINED("");
-    
-    private String title;
+  SMALL("small"), NORMAL("normal"), LARGE("large"), UNDEFINED("");
 
-    Size(String title) {
-        this.title = title;
-    }
+  private String title;
 
-    @Override
-	public String toString() {
-        return title;
-	}
+  Size(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/Target.java b/command/src/main/java/com/iluwatar/command/Target.java
index 6ea2681d3..e12f758ff 100644
--- a/command/src/main/java/com/iluwatar/command/Target.java
+++ b/command/src/main/java/com/iluwatar/command/Target.java
@@ -7,32 +7,32 @@ package com.iluwatar.command;
  */
 public abstract class Target {
 
-	private Size size;
+  private Size size;
 
-	private Visibility visibility;
+  private Visibility visibility;
 
-	public Size getSize() {
-		return size;
-	}
+  public Size getSize() {
+    return size;
+  }
 
-	public void setSize(Size size) {
-		this.size = size;
-	}
+  public void setSize(Size size) {
+    this.size = size;
+  }
 
-	public Visibility getVisibility() {
-		return visibility;
-	}
+  public Visibility getVisibility() {
+    return visibility;
+  }
 
-	public void setVisibility(Visibility visibility) {
-		this.visibility = visibility;
-	}
+  public void setVisibility(Visibility visibility) {
+    this.visibility = visibility;
+  }
 
-	@Override
-	public abstract String toString();
+  @Override
+  public abstract String toString();
 
-	public void printStatus() {
-		System.out.println(String.format("%s, [size=%s] [visibility=%s]", this,
-				getSize(), getVisibility()));
-		System.out.println();
-	}
+  public void printStatus() {
+    System.out.println(String.format("%s, [size=%s] [visibility=%s]", this, getSize(),
+        getVisibility()));
+    System.out.println();
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/Visibility.java b/command/src/main/java/com/iluwatar/command/Visibility.java
index 3316ac9e3..ebf8a306c 100644
--- a/command/src/main/java/com/iluwatar/command/Visibility.java
+++ b/command/src/main/java/com/iluwatar/command/Visibility.java
@@ -7,16 +7,16 @@ package com.iluwatar.command;
  */
 public enum Visibility {
 
-	VISIBLE("visible"), INVISIBLE("invisible"), UNDEFINED("");
+  VISIBLE("visible"), INVISIBLE("invisible"), UNDEFINED("");
 
-    private String title;
+  private String title;
 
-    Visibility(String title) {
-        this.title = title;
-    }
+  Visibility(String title) {
+    this.title = title;
+  }
 
-    @Override
-	public String toString() {
-		return title;
-	}
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/command/src/main/java/com/iluwatar/command/Wizard.java b/command/src/main/java/com/iluwatar/command/Wizard.java
index 995b4441a..edef8d3a9 100644
--- a/command/src/main/java/com/iluwatar/command/Wizard.java
+++ b/command/src/main/java/com/iluwatar/command/Wizard.java
@@ -10,38 +10,37 @@ import java.util.LinkedList;
  */
 public class Wizard {
 
-	private Deque undoStack = new LinkedList<>();
-	private Deque redoStack = new LinkedList<>();
+  private Deque undoStack = new LinkedList<>();
+  private Deque redoStack = new LinkedList<>();
 
-	public Wizard() {
-	}
+  public Wizard() {}
 
-	public void castSpell(Command command, Target target) {
-		System.out.println(this + " casts " + command + " at " + target);
-		command.execute(target);
-		undoStack.offerLast(command);
-	}
+  public void castSpell(Command command, Target target) {
+    System.out.println(this + " casts " + command + " at " + target);
+    command.execute(target);
+    undoStack.offerLast(command);
+  }
 
-	public void undoLastSpell() {
-		if (!undoStack.isEmpty()) {
-			Command previousSpell = undoStack.pollLast();
-			redoStack.offerLast(previousSpell);
-			System.out.println(this + " undoes " + previousSpell);
-			previousSpell.undo();
-		}
-	}
+  public void undoLastSpell() {
+    if (!undoStack.isEmpty()) {
+      Command previousSpell = undoStack.pollLast();
+      redoStack.offerLast(previousSpell);
+      System.out.println(this + " undoes " + previousSpell);
+      previousSpell.undo();
+    }
+  }
 
-	public void redoLastSpell() {
-		if (!redoStack.isEmpty()) {
-			Command previousSpell = redoStack.pollLast();
-			undoStack.offerLast(previousSpell);
-			System.out.println(this + " redoes " + previousSpell);
-			previousSpell.redo();
-		}
-	}
+  public void redoLastSpell() {
+    if (!redoStack.isEmpty()) {
+      Command previousSpell = redoStack.pollLast();
+      undoStack.offerLast(previousSpell);
+      System.out.println(this + " redoes " + previousSpell);
+      previousSpell.redo();
+    }
+  }
 
-	@Override
-	public String toString() {
-		return "Wizard";
-	}
+  @Override
+  public String toString() {
+    return "Wizard";
+  }
 }
diff --git a/command/src/test/java/com/iluwatar/command/AppTest.java b/command/src/test/java/com/iluwatar/command/AppTest.java
index 2fd5c16b4..aa0af3571 100644
--- a/command/src/test/java/com/iluwatar/command/AppTest.java
+++ b/command/src/test/java/com/iluwatar/command/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.command.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/composite/src/main/java/com/iluwatar/composite/App.java b/composite/src/main/java/com/iluwatar/composite/App.java
index 7bd0e4d01..57207cb8f 100644
--- a/composite/src/main/java/com/iluwatar/composite/App.java
+++ b/composite/src/main/java/com/iluwatar/composite/App.java
@@ -1,33 +1,34 @@
 package com.iluwatar.composite;
 
 /**
- * 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.
+ * 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}).
+ * 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 {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
-		System.out.println("Message from the orcs: ");
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    System.out.println("Message from the orcs: ");
 
-		LetterComposite orcMessage = new Messenger().messageFromOrcs();
-		orcMessage.print();
+    LetterComposite orcMessage = new Messenger().messageFromOrcs();
+    orcMessage.print();
 
-		System.out.println("\n");
+    System.out.println("\n");
 
-		System.out.println("Message from the elves: ");
+    System.out.println("Message from the elves: ");
 
-		LetterComposite elfMessage = new Messenger().messageFromElves();
-		elfMessage.print();
-	}
+    LetterComposite elfMessage = new Messenger().messageFromElves();
+    elfMessage.print();
+  }
 }
diff --git a/composite/src/main/java/com/iluwatar/composite/Letter.java b/composite/src/main/java/com/iluwatar/composite/Letter.java
index 8304ea801..4071eecda 100644
--- a/composite/src/main/java/com/iluwatar/composite/Letter.java
+++ b/composite/src/main/java/com/iluwatar/composite/Letter.java
@@ -7,20 +7,19 @@ package com.iluwatar.composite;
  */
 public class Letter extends LetterComposite {
 
-	private char c;
+  private char c;
 
-	public Letter(char c) {
-		this.c = c;
-	}
+  public Letter(char c) {
+    this.c = c;
+  }
 
-	@Override
-	protected void printThisBefore() {
-		System.out.print(c);
-	}
-
-	@Override
-	protected void printThisAfter() {
-		// nop
-	}
+  @Override
+  protected void printThisBefore() {
+    System.out.print(c);
+  }
 
+  @Override
+  protected void printThisAfter() {
+    // nop
+  }
 }
diff --git a/composite/src/main/java/com/iluwatar/composite/LetterComposite.java b/composite/src/main/java/com/iluwatar/composite/LetterComposite.java
index e58d51b25..1fdf4fdb6 100644
--- a/composite/src/main/java/com/iluwatar/composite/LetterComposite.java
+++ b/composite/src/main/java/com/iluwatar/composite/LetterComposite.java
@@ -10,25 +10,25 @@ import java.util.List;
  */
 public abstract class LetterComposite {
 
-	private List children = new ArrayList();
+  private List children = new ArrayList();
 
-	public void add(LetterComposite letter) {
-		children.add(letter);
-	}
+  public void add(LetterComposite letter) {
+    children.add(letter);
+  }
 
-	public int count() {
-		return children.size();
-	}
+  public int count() {
+    return children.size();
+  }
 
-	protected abstract void printThisBefore();
+  protected abstract void printThisBefore();
 
-	protected abstract void printThisAfter();
+  protected abstract void printThisAfter();
 
-	public void print() {
-		printThisBefore();
-		for (LetterComposite letter : children) {
-			letter.print();
-		}
-		printThisAfter();
-	}
+  public void print() {
+    printThisBefore();
+    for (LetterComposite letter : children) {
+      letter.print();
+    }
+    printThisAfter();
+  }
 }
diff --git a/composite/src/main/java/com/iluwatar/composite/Messenger.java b/composite/src/main/java/com/iluwatar/composite/Messenger.java
index aa0560d4d..37fa84bc2 100644
--- a/composite/src/main/java/com/iluwatar/composite/Messenger.java
+++ b/composite/src/main/java/com/iluwatar/composite/Messenger.java
@@ -11,48 +11,47 @@ import java.util.List;
  */
 public class Messenger {
 
-	LetterComposite messageFromOrcs() {
+  LetterComposite messageFromOrcs() {
 
-		List words = new ArrayList();
+    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'))));
+    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);
+    return new Sentence(words);
 
-	}
+  }
 
-	LetterComposite messageFromElves() {
+  LetterComposite messageFromElves() {
 
-		List words = new ArrayList();
+    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'))));
+    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);
+    return new Sentence(words);
 
-	}
+  }
 
 }
diff --git a/composite/src/main/java/com/iluwatar/composite/Sentence.java b/composite/src/main/java/com/iluwatar/composite/Sentence.java
index 2fc13701b..e6c626ea2 100644
--- a/composite/src/main/java/com/iluwatar/composite/Sentence.java
+++ b/composite/src/main/java/com/iluwatar/composite/Sentence.java
@@ -9,20 +9,19 @@ import java.util.List;
  */
 public class Sentence extends LetterComposite {
 
-	public Sentence(List words) {
-		for (Word w : words) {
-			this.add(w);
-		}
-	}
+  public Sentence(List words) {
+    for (Word w : words) {
+      this.add(w);
+    }
+  }
 
-	@Override
-	protected void printThisBefore() {
-		// nop
-	}
-
-	@Override
-	protected void printThisAfter() {
-		System.out.print(".");
-	}
+  @Override
+  protected void printThisBefore() {
+    // nop
+  }
 
+  @Override
+  protected void printThisAfter() {
+    System.out.print(".");
+  }
 }
diff --git a/composite/src/main/java/com/iluwatar/composite/Word.java b/composite/src/main/java/com/iluwatar/composite/Word.java
index e715ed28a..3060b0a1b 100644
--- a/composite/src/main/java/com/iluwatar/composite/Word.java
+++ b/composite/src/main/java/com/iluwatar/composite/Word.java
@@ -9,20 +9,19 @@ import java.util.List;
  */
 public class Word extends LetterComposite {
 
-	public Word(List letters) {
-		for (Letter l : letters) {
-			this.add(l);
-		}
-	}
+  public Word(List letters) {
+    for (Letter l : letters) {
+      this.add(l);
+    }
+  }
 
-	@Override
-	protected void printThisBefore() {
-		System.out.print(" ");
-	}
-
-	@Override
-	protected void printThisAfter() {
-		// nop
-	}
+  @Override
+  protected void printThisBefore() {
+    System.out.print(" ");
+  }
 
+  @Override
+  protected void printThisAfter() {
+    // nop
+  }
 }
diff --git a/composite/src/test/java/com/iluwatar/composite/AppTest.java b/composite/src/test/java/com/iluwatar/composite/AppTest.java
index 872ccea78..574e8def4 100644
--- a/composite/src/test/java/com/iluwatar/composite/AppTest.java
+++ b/composite/src/test/java/com/iluwatar/composite/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.composite.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/dao/src/main/java/com/iluwatar/dao/App.java b/dao/src/main/java/com/iluwatar/dao/App.java
index 95cf93e5b..2e115d8ce 100644
--- a/dao/src/main/java/com/iluwatar/dao/App.java
+++ b/dao/src/main/java/com/iluwatar/dao/App.java
@@ -7,53 +7,55 @@ import org.apache.log4j.Logger;
 
 /**
  * 
- * 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.
+ * 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.
  * 
    
- * With the DAO pattern, we can use various method calls to retrieve/add/delete/update data without directly
- * interacting with the data. The below example demonstrates basic CRUD operations: select, add, update, and delete.
+ * With the DAO pattern, we can use various method calls to retrieve/add/delete/update data without
+ * directly interacting with the data. The below example demonstrates basic CRUD operations: select,
+ * add, update, and delete.
  * 
  */
 public class App {
 
-	private static Logger LOGGER = Logger.getLogger(App.class);
+  private static Logger LOGGER = Logger.getLogger(App.class);
 
-	/**
-	 * Program entry point.
-	 * 
-	 * @param args command line args.
-	 */
-	public static void main(final String[] args) {
-		final CustomerDaoImpl customerDao = new CustomerDaoImpl(generateSampleCustomers());
-		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-		LOGGER.info("customerDao.getCusterById(2): " + customerDao.getCustomerById(2));
-		final Customer customer = new Customer(4, "Dan", "Danson");
-		customerDao.addCustomer(customer);
-		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-		customer.setFirstName("Daniel");
-		customer.setLastName("Danielson");
-		customerDao.updateCustomer(customer);
-		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-		customerDao.deleteCustomer(customer);
-		LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
-	}
+  /**
+   * Program entry point.
+   * 
+   * @param args command line args.
+   */
+  public static void main(final String[] args) {
+    final CustomerDaoImpl customerDao = new CustomerDaoImpl(generateSampleCustomers());
+    LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
+    LOGGER.info("customerDao.getCusterById(2): " + customerDao.getCustomerById(2));
+    final Customer customer = new Customer(4, "Dan", "Danson");
+    customerDao.addCustomer(customer);
+    LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
+    customer.setFirstName("Daniel");
+    customer.setLastName("Danielson");
+    customerDao.updateCustomer(customer);
+    LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
+    customerDao.deleteCustomer(customer);
+    LOGGER.info("customerDao.getAllCustomers(): " + customerDao.getAllCustomers());
+  }
 
-	/**
-	 * 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;
-	}
+  /**
+   * 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;
+  }
 }
diff --git a/decorator/src/main/java/com/iluwatar/decorator/App.java b/decorator/src/main/java/com/iluwatar/decorator/App.java
index bd697d4a4..d58d3b61a 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/App.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/App.java
@@ -2,37 +2,37 @@ package com.iluwatar.decorator;
 
 /**
  * 
- * The Decorator pattern is a more flexible alternative to subclassing. The Decorator
- * class implements the same interface as the target and uses composition to
- * "decorate" calls to the target. Using the Decorator pattern it is possible to 
- * change the behavior of the class during runtime.
+ * The Decorator pattern is a more flexible alternative to subclassing. The Decorator class
+ * implements the same interface as the target and uses composition 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 Troll} first attacks and then
- * flees the battle. Then we decorate the {@link Troll} with a {@link SmartTroll}
- * and perform the attack again. You can see how the behavior changes after the
- * decoration.
+ * In this example we show how the simple {@link Troll} first attacks and then flees the battle.
+ * Then we decorate the {@link Troll} with a {@link SmartTroll} and perform the attack again. You
+ * can see how the behavior changes after the decoration.
  * 
  */
 public class App {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
 
-		// simple troll
-		System.out.println("A simple looking troll approaches.");
-		Hostile troll = new Troll();
-		troll.attack();
-		troll.fleeBattle();
-		System.out.printf("Simple troll power %d.\n", troll.getAttackPower());
+    // simple troll
+    System.out.println("A simple looking troll approaches.");
+    Hostile troll = new Troll();
+    troll.attack();
+    troll.fleeBattle();
+    System.out.printf("Simple troll power %d.\n", troll.getAttackPower());
 
-		// change the behavior of the simple troll by adding a decorator
-		System.out.println("\nA smart looking troll surprises you.");
-		Hostile smart = new SmartTroll(troll);
-		smart.attack();
-		smart.fleeBattle();
-		System.out.printf("Smart troll power %d.\n", smart.getAttackPower());
-	}
+    // change the behavior of the simple troll by adding a decorator
+    System.out.println("\nA smart looking troll surprises you.");
+    Hostile smart = new SmartTroll(troll);
+    smart.attack();
+    smart.fleeBattle();
+    System.out.printf("Smart troll power %d.\n", smart.getAttackPower());
+  }
 }
diff --git a/decorator/src/main/java/com/iluwatar/decorator/Hostile.java b/decorator/src/main/java/com/iluwatar/decorator/Hostile.java
index 709072501..8b8f0c255 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/Hostile.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/Hostile.java
@@ -7,10 +7,10 @@ package com.iluwatar.decorator;
  */
 public interface Hostile {
 
-	void attack();
+  void attack();
 
-	int getAttackPower();
+  int getAttackPower();
 
-	void fleeBattle();
+  void fleeBattle();
 
 }
diff --git a/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java b/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java
index 909f94c95..93927237d 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/SmartTroll.java
@@ -1,36 +1,34 @@
 package com.iluwatar.decorator;
 
 /**
- * SmartTroll is a decorator for {@link Hostile} objects.
- * The calls to the {@link Hostile} interface are intercepted
- * and decorated. Finally the calls are delegated
- * to the decorated {@link Hostile} object.
+ * SmartTroll is a decorator for {@link Hostile} objects. The calls to the {@link Hostile} interface
+ * are intercepted and decorated. Finally the calls are delegated to the decorated {@link Hostile}
+ * object.
  *
  */
 public class SmartTroll implements Hostile {
 
-	private Hostile decorated;
+  private Hostile decorated;
 
-	public SmartTroll(Hostile decorated) {
-		this.decorated = decorated;
-	}
+  public SmartTroll(Hostile decorated) {
+    this.decorated = decorated;
+  }
 
-	@Override
-	public void attack() {
-		System.out.println("The troll throws a rock at you!");
-		decorated.attack();
-	}
+  @Override
+  public void attack() {
+    System.out.println("The troll throws a rock at you!");
+    decorated.attack();
+  }
 
-	@Override
-	public int getAttackPower() {
-		// decorated troll power + 20 because it is smart
-		return decorated.getAttackPower() + 20;
-	}
-
-	@Override
-	public void fleeBattle() {
-		System.out.println("The troll calls for help!");
-		decorated.fleeBattle();
-	}
+  @Override
+  public int getAttackPower() {
+    // decorated troll power + 20 because it is smart
+    return decorated.getAttackPower() + 20;
+  }
 
+  @Override
+  public void fleeBattle() {
+    System.out.println("The troll calls for help!");
+    decorated.fleeBattle();
+  }
 }
diff --git a/decorator/src/main/java/com/iluwatar/decorator/Troll.java b/decorator/src/main/java/com/iluwatar/decorator/Troll.java
index 85d873dbe..a10f76f79 100644
--- a/decorator/src/main/java/com/iluwatar/decorator/Troll.java
+++ b/decorator/src/main/java/com/iluwatar/decorator/Troll.java
@@ -7,17 +7,16 @@ package com.iluwatar.decorator;
  */
 public class Troll implements Hostile {
 
-	public void attack() {
-		System.out.println("The troll swings at you with a club!");
-	}
+  public void attack() {
+    System.out.println("The troll swings at you with a club!");
+  }
 
-	@Override
-	public int getAttackPower() {
-		return 10;
-	}
-
-	public void fleeBattle() {
-		System.out.println("The troll shrieks in horror and runs away!");
-	}
+  @Override
+  public int getAttackPower() {
+    return 10;
+  }
 
+  public void fleeBattle() {
+    System.out.println("The troll shrieks in horror and runs away!");
+  }
 }
diff --git a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
index b74bd3a06..f6fa96092 100644
--- a/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
+++ b/decorator/src/test/java/com/iluwatar/decorator/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.decorator.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
index 8202cc58e..810957858 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/AdvancedWizard.java
@@ -2,21 +2,20 @@ package com.iluwatar.dependency.injection;
 
 /**
  * 
- * AdvancedWizard implements inversion of control.
- * It depends on abstraction that can be injected through
- * its constructor.
+ * 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;
-	}
+  private Tobacco tobacco;
 
-	@Override
-	public void smoke() {
-		tobacco.smoke(this);
-	}
+  public AdvancedWizard(Tobacco tobacco) {
+    this.tobacco = tobacco;
+  }
+
+  @Override
+  public void smoke() {
+    tobacco.smoke(this);
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java
index a882863b7..0205724b5 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/App.java
@@ -5,40 +5,41 @@ import com.google.inject.Injector;
 
 /**
  * 
- * Dependency Injection pattern deals with how objects handle their dependencies. The pattern 
+ * 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 wizard ({@link AdvancedWizard}) is more flexible. It does not depend on any concrete implementation 
- *  but abstraction. It utilizes Dependency Injection pattern allowing its {@link Tobacco} dependency to be
- *  injected through its constructor. This way, handling the dependency is no longer the wizard's
- *  responsibility. It is resolved outside the wizard class.
- *  
    
- *  The third 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.
+ * - 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 wizard ({@link AdvancedWizard}) is more flexible. It does not depend on any concrete
+ * implementation but abstraction. It utilizes Dependency Injection pattern allowing its
+ * {@link Tobacco} dependency to be injected through its constructor. This way, handling the
+ * dependency is no longer the wizard's responsibility. It is resolved outside the wizard class.
+ * 
    
+ * The third 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();
-    	
-    	Injector injector = Guice.createInjector(new TobaccoModule());
-    	GuiceWizard guiceWizard = injector.getInstance(GuiceWizard.class);
-    	guiceWizard.smoke();
-    }
+
+  /**
+   * 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();
+
+    Injector injector = Guice.createInjector(new TobaccoModule());
+    GuiceWizard guiceWizard = injector.getInstance(GuiceWizard.class);
+    guiceWizard.smoke();
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java
index 9393377f1..e5c77ba18 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/GuiceWizard.java
@@ -4,22 +4,21 @@ import javax.inject.Inject;
 
 /**
  * 
- * GuiceWizard implements inversion of control.
- * Its dependencies are injected through its constructor
- * by Guice framework.
+ * 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);
-	}
+  private Tobacco tobacco;
+
+  @Inject
+  public GuiceWizard(Tobacco tobacco) {
+    this.tobacco = tobacco;
+  }
+
+  @Override
+  public void smoke() {
+    tobacco.smoke(this);
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java
index 5bc2c8377..976616e74 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/SimpleWizard.java
@@ -2,15 +2,15 @@ package com.iluwatar.dependency.injection;
 
 /**
  * 
- * Naive Wizard implementation violating the inversion of control principle.
- * It should depend on abstraction instead.
+ * 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);
-	}
+
+  private OldTobyTobacco tobacco = new OldTobyTobacco();
+
+  public void smoke() {
+    tobacco.smoke(this);
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
index 7ee97404d..48e4cd8de 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Tobacco.java
@@ -6,8 +6,9 @@ package com.iluwatar.dependency.injection;
  *
  */
 public abstract class Tobacco {
-	
-	public void smoke(Wizard wizard) {
-		System.out.println(String.format("%s smoking %s", wizard.getClass().getSimpleName(), this.getClass().getSimpleName()));
-	}
+
+  public void smoke(Wizard wizard) {
+    System.out.println(String.format("%s smoking %s", wizard.getClass().getSimpleName(), this
+        .getClass().getSimpleName()));
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java
index d2dd1072e..8187bae9f 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/TobaccoModule.java
@@ -9,8 +9,8 @@ import com.google.inject.AbstractModule;
  */
 public class TobaccoModule extends AbstractModule {
 
-	@Override
-	protected void configure() {
-		bind(Tobacco.class).to(RivendellTobacco.class);
-	}
+  @Override
+  protected void configure() {
+    bind(Tobacco.class).to(RivendellTobacco.class);
+  }
 }
diff --git a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java
index 8ac9f9fcb..0376fcc2e 100644
--- a/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java
+++ b/dependency-injection/src/main/java/com/iluwatar/dependency/injection/Wizard.java
@@ -6,7 +6,7 @@ package com.iluwatar.dependency.injection;
  *
  */
 public interface Wizard {
-	
-	void smoke();
+
+  void smoke();
 
 }
diff --git a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
index 5315fe1db..8d6411028 100644
--- a/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
+++ b/dependency-injection/src/test/java/com/iluwatar/dependency/injection/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.dependency.injection.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}	
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }

From 306b1f3d31751448d1904657d065bd0241e9dec2 Mon Sep 17 00:00:00 2001
From: Ankur Kaushal 
Date: Sun, 1 Nov 2015 21:29:13 -0500
Subject: [PATCH 309/687] Reformat rest of the design patterns - Issue #224

---
 .../iluwatar/doublechecked/locking/App.java   |  55 ++--
 .../doublechecked/locking/Inventory.java      |  50 ++-
 .../iluwatar/doublechecked/locking/Item.java  |   6 +-
 .../doublechecked/locking/AppTest.java        |  10 +-
 .../java/com/iluwatar/doubledispatch/App.java |  68 ++--
 .../doubledispatch/FlamingAsteroid.java       |  16 +-
 .../iluwatar/doubledispatch/GameObject.java   |  75 +++--
 .../iluwatar/doubledispatch/Meteoroid.java    |  50 +--
 .../iluwatar/doubledispatch/Rectangle.java    |  71 ++--
 .../doubledispatch/SpaceStationIss.java       |  14 +-
 .../doubledispatch/SpaceStationMir.java       |  69 ++--
 .../com/iluwatar/doubledispatch/AppTest.java  |  12 +-
 .../doubledispatch/RectangleTest.java         |  14 +-
 .../com/iluwatar/event/aggregator/App.java    |  55 ++--
 .../com/iluwatar/event/aggregator/Event.java  |  23 +-
 .../event/aggregator/EventEmitter.java        |  40 +--
 .../event/aggregator/EventObserver.java       |   4 +-
 .../event/aggregator/KingJoffrey.java         |   8 +-
 .../iluwatar/event/aggregator/KingsHand.java  |  33 +-
 .../event/aggregator/LordBaelish.java         |  28 +-
 .../iluwatar/event/aggregator/LordVarys.java  |  28 +-
 .../com/iluwatar/event/aggregator/Scout.java  |  28 +-
 .../iluwatar/event/aggregator/Weekday.java    |  23 +-
 .../iluwatar/event/aggregator/AppTest.java    |  11 +-
 .../java/com/iluwatar/execute/around/App.java |  45 +--
 .../execute/around/FileWriterAction.java      |   4 +-
 .../execute/around/SimpleFileWriter.java      |  21 +-
 .../com/iluwatar/execute/around/AppTest.java  |  26 +-
 .../main/java/com/iluwatar/facade/App.java    |  37 +--
 .../iluwatar/facade/DwarvenCartOperator.java  |  17 +-
 .../iluwatar/facade/DwarvenGoldDigger.java    |  17 +-
 .../facade/DwarvenGoldmineFacade.java         |  49 ++-
 .../iluwatar/facade/DwarvenMineWorker.java    |  84 ++---
 .../iluwatar/facade/DwarvenTunnelDigger.java  |  17 +-
 .../java/com/iluwatar/facade/AppTest.java     |  10 +-
 .../java/com/iluwatar/factory/method/App.java |  54 ++--
 .../iluwatar/factory/method/Blacksmith.java   |   2 +-
 .../factory/method/ElfBlacksmith.java         |   6 +-
 .../iluwatar/factory/method/ElfWeapon.java    |  17 +-
 .../factory/method/OrcBlacksmith.java         |   7 +-
 .../iluwatar/factory/method/OrcWeapon.java    |  17 +-
 .../iluwatar/factory/method/WeaponType.java   |  18 +-
 .../com/iluwatar/factory/method/AppTest.java  |  10 +-
 .../com/iluwatar/fluentinterface/app/App.java |  20 +-
 .../java/com/iluwatar/flux/action/Action.java |  18 +-
 .../com/iluwatar/flux/action/ActionType.java  |   4 +-
 .../com/iluwatar/flux/action/Content.java     |  25 +-
 .../iluwatar/flux/action/ContentAction.java   |  18 +-
 .../com/iluwatar/flux/action/MenuAction.java  |  18 +-
 .../com/iluwatar/flux/action/MenuItem.java    |  24 +-
 .../main/java/com/iluwatar/flux/app/App.java  |  68 ++--
 .../iluwatar/flux/dispatcher/Dispatcher.java  |  63 ++--
 .../com/iluwatar/flux/store/ContentStore.java |  26 +-
 .../com/iluwatar/flux/store/MenuStore.java    |  28 +-
 .../java/com/iluwatar/flux/store/Store.java   |  22 +-
 .../com/iluwatar/flux/view/ContentView.java   |  22 +-
 .../java/com/iluwatar/flux/view/MenuView.java |  44 +--
 .../java/com/iluwatar/flux/view/View.java     |   4 +-
 .../java/com/iluwatar/flux/app/AppTest.java   |  12 +-
 .../com/iluwatar/flyweight/AlchemistShop.java |  69 ++--
 .../main/java/com/iluwatar/flyweight/App.java |  33 +-
 .../com/iluwatar/flyweight/HealingPotion.java |  10 +-
 .../iluwatar/flyweight/HolyWaterPotion.java   |  10 +-
 .../flyweight/InvisibilityPotion.java         |  10 +-
 .../com/iluwatar/flyweight/PoisonPotion.java  |  10 +-
 .../java/com/iluwatar/flyweight/Potion.java   |   2 +-
 .../com/iluwatar/flyweight/PotionFactory.java |  75 +++--
 .../com/iluwatar/flyweight/PotionType.java    |   2 +-
 .../iluwatar/flyweight/StrengthPotion.java    |   9 +-
 .../java/com/iluwatar/flyweight/AppTest.java  |  10 +-
 .../com/iluwatar/halfsynchalfasync/App.java   | 204 ++++++------
 .../iluwatar/halfsynchalfasync/AsyncTask.java |  68 ++--
 .../AsynchronousService.java                  | 116 +++----
 .../iluwatar/halfsynchalfasync/AppTest.java   |   8 +-
 .../intercepting/filter/AbstractFilter.java   |  70 ++--
 .../intercepting/filter/AddressFilter.java    |  23 +-
 .../com/iluwatar/intercepting/filter/App.java |  70 ++--
 .../iluwatar/intercepting/filter/Client.java  | 148 ++++-----
 .../intercepting/filter/ContactFilter.java    |  32 +-
 .../intercepting/filter/DepositFilter.java    |  24 +-
 .../iluwatar/intercepting/filter/Filter.java  |  59 ++--
 .../intercepting/filter/FilterChain.java      |  48 +--
 .../intercepting/filter/FilterManager.java    |  22 +-
 .../intercepting/filter/NameFilter.java       |  25 +-
 .../iluwatar/intercepting/filter/Order.java   |  91 +++---
 .../intercepting/filter/OrderFilter.java      |  20 +-
 .../iluwatar/intercepting/filter/Target.java  |  92 +++---
 .../iluwatar/intercepting/filter/AppTest.java |  10 +-
 .../java/com/iluwatar/interpreter/App.java    | 117 ++++---
 .../com/iluwatar/interpreter/Expression.java  |   6 +-
 .../iluwatar/interpreter/MinusExpression.java |  28 +-
 .../interpreter/MultiplyExpression.java       |  29 +-
 .../interpreter/NumberExpression.java         |  31 +-
 .../iluwatar/interpreter/PlusExpression.java  |  29 +-
 .../com/iluwatar/interpreter/AppTest.java     |  10 +-
 .../main/java/com/iluwatar/iterator/App.java  |  64 ++--
 .../main/java/com/iluwatar/iterator/Item.java |  32 +-
 .../com/iluwatar/iterator/ItemIterator.java   |   4 +-
 .../java/com/iluwatar/iterator/ItemType.java  |   2 +-
 .../com/iluwatar/iterator/TreasureChest.java  |  44 +--
 .../iterator/TreasureChestItemIterator.java   |  73 +++--
 .../java/com/iluwatar/iterator/AppTest.java   |  10 +-
 .../main/java/com/iluwatar/layers/App.java    | 136 ++++----
 .../main/java/com/iluwatar/layers/Cake.java   |  78 ++---
 .../iluwatar/layers/CakeBakingException.java  |  13 +-
 .../iluwatar/layers/CakeBakingService.java    |  76 +++--
 .../layers/CakeBakingServiceImpl.java         | 240 +++++++-------
 .../java/com/iluwatar/layers/CakeInfo.java    |  52 +--
 .../java/com/iluwatar/layers/CakeLayer.java   |  85 +++--
 .../com/iluwatar/layers/CakeLayerInfo.java    |  38 +--
 .../java/com/iluwatar/layers/CakeTopping.java |  93 +++---
 .../com/iluwatar/layers/CakeToppingInfo.java  |  38 +--
 .../com/iluwatar/layers/CakeViewImpl.java     |  16 +-
 .../main/java/com/iluwatar/layers/View.java   |   4 +-
 .../java/com/iluwatar/layers/AppTest.java     |  10 +-
 .../java/com/iluwatar/lazy/loading/App.java   |  49 ++-
 .../java/com/iluwatar/lazy/loading/Heavy.java |  18 +-
 .../iluwatar/lazy/loading/HolderNaive.java    |  27 +-
 .../lazy/loading/HolderThreadSafe.java        |  29 +-
 .../iluwatar/lazy/loading/Java8Holder.java    |  49 +--
 .../com/iluwatar/lazy/loading/AppTest.java    |  10 +-
 .../lazy/loading/HolderThreadSafeTest.java    |  49 +--
 .../java/com/iluwatar/mediator/Action.java    |  32 +-
 .../main/java/com/iluwatar/mediator/App.java  |  81 +++--
 .../java/com/iluwatar/mediator/Hobbit.java    |   8 +-
 .../java/com/iluwatar/mediator/Hunter.java    |   9 +-
 .../java/com/iluwatar/mediator/Party.java     |   4 +-
 .../java/com/iluwatar/mediator/PartyImpl.java |  34 +-
 .../com/iluwatar/mediator/PartyMember.java    |   6 +-
 .../iluwatar/mediator/PartyMemberBase.java    |  38 +--
 .../java/com/iluwatar/mediator/Rogue.java     |   8 +-
 .../java/com/iluwatar/mediator/Wizard.java    |   8 +-
 .../java/com/iluwatar/mediator/AppTest.java   |  10 +-
 .../main/java/com/iluwatar/memento/App.java   |  69 ++--
 .../main/java/com/iluwatar/memento/Star.java  | 157 +++++----
 .../java/com/iluwatar/memento/StarType.java   |  19 +-
 .../java/com/iluwatar/memento/AppTest.java    |  10 +-
 .../com/iluwatar/message/channel/App.java     |  74 ++---
 .../com/iluwatar/message/channel/AppTest.java |  12 +-
 .../iluwatar/model/view/controller/App.java   |  55 ++--
 .../model/view/controller/Fatigue.java        |  22 +-
 .../view/controller/GiantController.java      |  58 ++--
 .../model/view/controller/GiantModel.java     |  64 ++--
 .../model/view/controller/GiantView.java      |   6 +-
 .../model/view/controller/Health.java         |  24 +-
 .../model/view/controller/Nourishment.java    |  22 +-
 .../model/view/controller/AppTest.java        |  12 +-
 .../iluwatar/model/view/presenter/App.java    |  41 +--
 .../model/view/presenter/FileLoader.java      | 112 +++----
 .../view/presenter/FileSelectorJFrame.java    | 302 +++++++++---------
 .../view/presenter/FileSelectorPresenter.java | 117 +++----
 .../view/presenter/FileSelectorStub.java      | 168 +++++-----
 .../view/presenter/FileSelectorView.java      |  88 ++---
 .../presenter/FileSelectorPresenterTest.java  | 181 ++++++-----
 .../com/iluwatar/monostate/LoadBalancer.java  |   2 +-
 .../java/com/iluwatar/monostate/Request.java  |   2 +-
 .../java/com/iluwatar/monostate/Server.java   |   7 +-
 .../java/com/iluwatar/monostate/AppTest.java  |   2 +-
 .../main/java/com/iluwatar/multiton/App.java  |  46 +--
 .../java/com/iluwatar/multiton/Nazgul.java    |  55 ++--
 .../com/iluwatar/multiton/NazgulName.java     |   4 +-
 .../java/com/iluwatar/multiton/AppTest.java   |  12 +-
 .../dom/app/homepage/HomePageService.java     |  56 ++--
 .../dom/app/homepage/HomePageViewModel.java   |  60 ++--
 .../dom/modules/simple/SimpleObject.java      | 186 +++++------
 .../dom/modules/simple/SimpleObjects.java     | 134 ++++----
 .../dom/modules/simple/SimpleObjectTest.java  |  62 ++--
 .../dom/modules/simple/SimpleObjectsTest.java | 118 ++++---
 .../fixture/DomainAppFixturesProvider.java    |  46 ++-
 .../modules/simple/SimpleObjectCreate.java    |  96 +++---
 .../modules/simple/SimpleObjectsTearDown.java |  40 ++-
 .../scenarios/RecreateSimpleObjects.java      | 133 ++++----
 .../bootstrap/SimpleAppSystemInitializer.java |  73 ++---
 .../specglue/BootstrappingGlue.java           |  46 ++-
 .../specglue/CatalogOfFixturesGlue.java       |  31 +-
 .../modules/simple/SimpleObjectGlue.java      |  54 ++--
 .../domainapp/integtests/specs/RunSpecs.java  |  37 +--
 .../domainapp/webapp/SimpleApplication.java   | 178 ++++++-----
 .../java/com/iluwatar/nullobject/App.java     |  46 ++-
 .../java/com/iluwatar/nullobject/Node.java    |  14 +-
 .../com/iluwatar/nullobject/NodeImpl.java     |  72 ++---
 .../com/iluwatar/nullobject/NullNode.java     |  54 ++--
 .../java/com/iluwatar/nullobject/AppTest.java |  10 +-
 .../java/com/iluwatar/object/pool/App.java    |  81 ++---
 .../com/iluwatar/object/pool/ObjectPool.java  |  48 +--
 .../com/iluwatar/object/pool/Oliphaunt.java   |  44 +--
 .../iluwatar/object/pool/OliphauntPool.java   |   8 +-
 .../com/iluwatar/object/pool/AppTest.java     |  12 +-
 .../java/com/iluwatar/poison/pill/App.java    |  64 ++--
 .../com/iluwatar/poison/pill/Consumer.java    |  51 +--
 .../iluwatar/poison/pill/MQPublishPoint.java  |   2 +-
 .../poison/pill/MQSubscribePoint.java         |   2 +-
 .../com/iluwatar/poison/pill/Message.java     |  74 +++--
 .../com/iluwatar/poison/pill/Producer.java    |  68 ++--
 .../iluwatar/poison/pill/SimpleMessage.java   |  44 +--
 .../poison/pill/SimpleMessageQueue.java       |  25 +-
 .../com/iluwatar/poison/pill/AppTest.java     |  10 +-
 .../com/iluwatar/privateclassdata/App.java    |  55 ++--
 .../privateclassdata/ImmutableStew.java       |  21 +-
 .../com/iluwatar/privateclassdata/Stew.java   |  67 ++--
 .../iluwatar/privateclassdata/StewData.java   |  46 +--
 .../iluwatar/privateclassdata/AppTest.java    |  10 +-
 .../main/java/com/iluwatar/property/App.java  |  74 ++---
 .../java/com/iluwatar/property/Character.java | 172 +++++-----
 .../java/com/iluwatar/property/Prototype.java |  11 +-
 .../java/com/iluwatar/property/Stats.java     |   2 +-
 .../java/com/iluwatar/property/AppTest.java   |  10 +-
 .../main/java/com/iluwatar/prototype/App.java |  65 ++--
 .../java/com/iluwatar/prototype/Beast.java    |   4 +-
 .../java/com/iluwatar/prototype/ElfBeast.java |  22 +-
 .../java/com/iluwatar/prototype/ElfMage.java  |  22 +-
 .../com/iluwatar/prototype/ElfWarlord.java    |  22 +-
 .../com/iluwatar/prototype/HeroFactory.java   |   6 +-
 .../iluwatar/prototype/HeroFactoryImpl.java   |  58 ++--
 .../java/com/iluwatar/prototype/Mage.java     |   4 +-
 .../java/com/iluwatar/prototype/OrcBeast.java |  22 +-
 .../java/com/iluwatar/prototype/OrcMage.java  |  22 +-
 .../com/iluwatar/prototype/OrcWarlord.java    |  22 +-
 .../com/iluwatar/prototype/Prototype.java     |   4 +-
 .../java/com/iluwatar/prototype/Warlord.java  |   4 +-
 .../java/com/iluwatar/prototype/AppTest.java  |  10 +-
 .../src/main/java/com/iluwatar/proxy/App.java |  34 +-
 .../main/java/com/iluwatar/proxy/Wizard.java  |  16 +-
 .../java/com/iluwatar/proxy/WizardTower.java  |   6 +-
 .../com/iluwatar/proxy/WizardTowerProxy.java  |  22 +-
 .../test/java/com/iluwatar/proxy/AppTest.java |  10 +-
 .../java/com/iluwatar/reactor/app/App.java    |  11 +-
 .../com/iluwatar/reactor/app/AppClient.java   |   3 +-
 .../reactor/framework/AbstractNioChannel.java |   3 +-
 .../framework/NioServerSocketChannel.java     |   3 +-
 .../com/iluwatar/reactor/app/AppTest.java     |   2 +-
 .../java/com/iluwatar/repository/App.java     |  82 ++---
 .../java/com/iluwatar/repository/Person.java  |  66 ++--
 .../iluwatar/repository/PersonRepository.java |   4 +-
 .../java/com/iluwatar/repository/AppTest.java |  10 +-
 .../acquisition/is/initialization/App.java    |  57 ++--
 .../is/initialization/SlidingDoor.java        |  16 +-
 .../is/initialization/TreasureChest.java      |  16 +-
 .../is/initialization/AppTest.java            |  10 +-
 .../main/java/com/iluwatar/servant/App.java   |  81 ++---
 .../main/java/com/iluwatar/servant/King.java  |  52 +--
 .../main/java/com/iluwatar/servant/Queen.java |  57 ++--
 .../java/com/iluwatar/servant/Royalty.java    |  10 +-
 .../java/com/iluwatar/servant/Servant.java    |  51 +--
 .../java/com/iluwatar/servant/AppTest.java    |  10 +-
 .../com/iluwatar/servicelayer/app/App.java    | 300 ++++++++---------
 .../servicelayer/common/BaseEntity.java       |   8 +-
 .../com/iluwatar/servicelayer/common/Dao.java |  18 +-
 .../servicelayer/common/DaoBaseImpl.java      | 205 ++++++------
 .../servicelayer/hibernate/HibernateUtil.java |  40 ++-
 .../servicelayer/magic/MagicService.java      |  12 +-
 .../servicelayer/magic/MagicServiceImpl.java  |  64 ++--
 .../iluwatar/servicelayer/spell/Spell.java    |  85 +++--
 .../iluwatar/servicelayer/spell/SpellDao.java |   4 +-
 .../servicelayer/spell/SpellDaoImpl.java      |  43 ++-
 .../servicelayer/spellbook/Spellbook.java     | 110 +++----
 .../servicelayer/spellbook/SpellbookDao.java  |   4 +-
 .../spellbook/SpellbookDaoImpl.java           |  45 ++-
 .../iluwatar/servicelayer/wizard/Wizard.java  |  92 +++---
 .../servicelayer/wizard/WizardDao.java        |   4 +-
 .../servicelayer/wizard/WizardDaoImpl.java    |  47 ++-
 .../iluwatar/servicelayer/app/AppTest.java    |  12 +-
 .../java/com/iluwatar/servicelocator/App.java |  44 +--
 .../iluwatar/servicelocator/InitContext.java  |  38 +--
 .../com/iluwatar/servicelocator/Service.java  |  37 +--
 .../iluwatar/servicelocator/ServiceCache.java |  63 ++--
 .../iluwatar/servicelocator/ServiceImpl.java  |  46 +--
 .../servicelocator/ServiceLocator.java        |  50 +--
 .../com/iluwatar/servicelocator/AppTest.java  |  10 +-
 .../main/java/com/iluwatar/singleton/App.java |  65 ++--
 .../iluwatar/singleton/EnumIvoryTower.java    |   3 +-
 .../InitializingOnDemandHolderIdiom.java      |  16 +-
 .../com/iluwatar/singleton/IvoryTower.java    |  10 +-
 .../ThreadSafeDoubleCheckLocking.java         |   6 +-
 .../ThreadSafeLazyLoadedIvoryTower.java       |  12 +-
 .../java/com/iluwatar/singleton/AppTest.java  |  10 +-
 .../LazyLoadedSingletonThreadSafetyTest.java  | 113 +++----
 .../com/iluwatar/specification/app/App.java   |  54 ++--
 .../creature/AbstractCreature.java            |  70 ++--
 .../specification/creature/Creature.java      |  14 +-
 .../specification/creature/Dragon.java        |   6 +-
 .../specification/creature/Goblin.java        |   6 +-
 .../specification/creature/KillerBee.java     |   6 +-
 .../specification/creature/Octopus.java       |   6 +-
 .../specification/creature/Shark.java         |   6 +-
 .../specification/creature/Troll.java         |   8 +-
 .../specification/property/Color.java         |  20 +-
 .../specification/property/Movement.java      |  20 +-
 .../iluwatar/specification/property/Size.java |  20 +-
 .../specification/selector/ColorSelector.java |  18 +-
 .../selector/MovementSelector.java            |  18 +-
 .../specification/selector/SizeSelector.java  |  18 +-
 .../iluwatar/specification/app/AppTest.java   |  10 +-
 .../java/com/iluwatar/state/AngryState.java   |  24 +-
 .../src/main/java/com/iluwatar/state/App.java |  26 +-
 .../main/java/com/iluwatar/state/Mammoth.java |  44 +--
 .../com/iluwatar/state/PeacefulState.java     |  24 +-
 .../main/java/com/iluwatar/state/State.java   |   4 +-
 .../test/java/com/iluwatar/state/AppTest.java |  10 +-
 .../java/com/iluwatar/stepbuilder/App.java    |  92 +++---
 .../com/iluwatar/stepbuilder/Character.java   | 116 +++----
 .../stepbuilder/CharacterStepBuilder.java     | 260 ++++++++-------
 .../com/iluwatar/stepbuilder/AppTest.java     |  10 +-
 .../main/java/com/iluwatar/strategy/App.java  |  39 +--
 .../com/iluwatar/strategy/DragonSlayer.java   |  20 +-
 .../strategy/DragonSlayingStrategy.java       |   2 +-
 .../com/iluwatar/strategy/MeleeStrategy.java  |   9 +-
 .../iluwatar/strategy/ProjectileStrategy.java |  11 +-
 .../com/iluwatar/strategy/SpellStrategy.java  |  10 +-
 .../java/com/iluwatar/strategy/AppTest.java   |  10 +-
 .../java/com/iluwatar/templatemethod/App.java |  29 +-
 .../templatemethod/HalflingThief.java         |  20 +-
 .../templatemethod/HitAndRunMethod.java       |  25 +-
 .../templatemethod/StealingMethod.java        |  18 +-
 .../iluwatar/templatemethod/SubtleMethod.java |  27 +-
 .../com/iluwatar/templatemethod/AppTest.java  |  10 +-
 .../java/com/iluwatar/threadpool/App.java     | 113 +++----
 .../iluwatar/threadpool/CoffeeMakingTask.java |  18 +-
 .../threadpool/PotatoPeelingTask.java         |  20 +-
 .../java/com/iluwatar/threadpool/Task.java    |  44 +--
 .../java/com/iluwatar/threadpool/Worker.java  |  31 +-
 .../java/com/iluwatar/threadpool/AppTest.java |  13 +-
 .../java/com/iluwatar/tolerantreader/App.java |  66 ++--
 .../iluwatar/tolerantreader/RainbowFish.java  |  52 +--
 .../tolerantreader/RainbowFishSerializer.java | 126 ++++----
 .../tolerantreader/RainbowFishV2.java         |  55 ++--
 .../com/iluwatar/tolerantreader/AppTest.java  |  30 +-
 .../main/java/com/iluwatar/visitor/App.java   |  37 ++-
 .../java/com/iluwatar/visitor/Commander.java  |  24 +-
 .../iluwatar/visitor/CommanderVisitor.java    |  19 +-
 .../java/com/iluwatar/visitor/Sergeant.java   |  24 +-
 .../com/iluwatar/visitor/SergeantVisitor.java |  19 +-
 .../java/com/iluwatar/visitor/Soldier.java    |  24 +-
 .../com/iluwatar/visitor/SoldierVisitor.java  |  19 +-
 .../main/java/com/iluwatar/visitor/Unit.java  |  18 +-
 .../com/iluwatar/visitor/UnitVisitor.java     |   6 +-
 .../java/com/iluwatar/visitor/AppTest.java    |  10 +-
 337 files changed, 6744 insertions(+), 6851 deletions(-)

diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
index b8d6a41a0..0cc62c995 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/App.java
@@ -6,38 +6,37 @@ 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.
+ * 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.
+ * 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 {
 
-	/**
-	 * 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()))
-                    ;
-            });
-		}
+  /**
+   * 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) {
-			System.out.println("Error waiting for ExecutorService shutdown");
-		}
-	}
+    executorService.shutdown();
+    try {
+      executorService.awaitTermination(5, TimeUnit.SECONDS);
+    } catch (InterruptedException e) {
+      System.out.println("Error waiting for ExecutorService shutdown");
+    }
+  }
 }
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
index a58926d9d..b51e000a7 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Inventory.java
@@ -12,32 +12,30 @@ import java.util.concurrent.locks.ReentrantLock;
  */
 public class Inventory {
 
-	private final int inventorySize;
-	private final List items;
-	private final Lock lock;
+  private final int inventorySize;
+  private final List items;
+  private final Lock lock;
 
-	public Inventory(int inventorySize) {
-		this.inventorySize = inventorySize;
-		this.items = new ArrayList<>(inventorySize);
-		this.lock = new ReentrantLock();
-	}
-
-	public boolean addItem(Item item) {
-		if (items.size() < inventorySize) {
-			lock.lock();
-			try {
-				if (items.size() < inventorySize) {
-					items.add(item);
-					System.out.println(Thread.currentThread()
-							+ ": items.size()=" + items.size()
-							+ ", inventorySize=" + inventorySize);
-					return true;
-				}
-			} finally {
-				lock.unlock();
-			}
-		}
-		return false;
-	}
+  public Inventory(int inventorySize) {
+    this.inventorySize = inventorySize;
+    this.items = new ArrayList<>(inventorySize);
+    this.lock = new ReentrantLock();
+  }
 
+  public boolean addItem(Item item) {
+    if (items.size() < inventorySize) {
+      lock.lock();
+      try {
+        if (items.size() < inventorySize) {
+          items.add(item);
+          System.out.println(Thread.currentThread() + ": items.size()=" + items.size()
+              + ", inventorySize=" + inventorySize);
+          return true;
+        }
+      } finally {
+        lock.unlock();
+      }
+    }
+    return false;
+  }
 }
diff --git a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java
index 8fc7f3888..5efe06215 100644
--- a/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java
+++ b/double-checked-locking/src/main/java/com/iluwatar/doublechecked/locking/Item.java
@@ -6,7 +6,7 @@ package com.iluwatar.doublechecked.locking;
  *
  */
 public class Item {
-	
-	private String name;
-	private int level;
+
+  private String name;
+  private int level;
 }
diff --git a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
index 14fd47488..bd88f223c 100644
--- a/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
+++ b/double-checked-locking/src/test/java/com/iluwatar/doublechecked/locking/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.doublechecked.locking.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
index f32c93cb1..6514feb7f 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/App.java
@@ -5,46 +5,50 @@ 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.
+ * 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.
+ * 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
+ * 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 {
-	
-	/**
-	 * 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 -> System.out.println(o));
-    	System.out.println("");
-    	
-    	// collision check
-    	objects.stream().forEach(o1 -> objects.stream().forEach(o2 -> { if (o1 != o2 && o1.intersectsWith(o2)) o1.collision(o2); } ));
-    	System.out.println("");
-    	
-    	// output eventual object statuses
-    	objects.stream().forEach(o -> System.out.println(o));
-    	System.out.println("");
-    }
+
+  /**
+   * 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 -> System.out.println(o));
+    System.out.println("");
+
+    // collision check
+    objects.stream().forEach(o1 -> objects.stream().forEach(o2 -> {
+      if (o1 != o2 && o1.intersectsWith(o2))
+        o1.collision(o2);
+    }));
+    System.out.println("");
+
+    // output eventual object statuses
+    objects.stream().forEach(o -> System.out.println(o));
+    System.out.println("");
+  }
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java
index 73b633e5b..e23169897 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/FlamingAsteroid.java
@@ -7,13 +7,13 @@ package com.iluwatar.doubledispatch;
  */
 public class FlamingAsteroid extends Meteoroid {
 
-	public FlamingAsteroid(int left, int top, int right, int bottom) {
-		super(left, top, right, bottom);
-		setOnFire(true);
-	}
+  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);
-	}
+  @Override
+  public void collision(GameObject gameObject) {
+    gameObject.collisionResolve(this);
+  }
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java
index afe05e9b2..4fdca4dac 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/GameObject.java
@@ -2,48 +2,47 @@ package com.iluwatar.doubledispatch;
 
 /**
  * 
- * Game objects have coordinates and some
- * other status information.
+ * 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);
+  private boolean damaged;
+  private boolean onFire;
 
-	public abstract void collisionResolve(SpaceStationMir mir);
+  public GameObject(int left, int top, int right, int bottom) {
+    super(left, top, right, bottom);
+  }
 
-	public abstract void collisionResolve(SpaceStationIss iss);
+  @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);
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
index fb59c49b4..20d985e6a 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Meteoroid.java
@@ -7,32 +7,36 @@ package com.iluwatar.doubledispatch;
  */
 public class Meteoroid extends GameObject {
 
-	public Meteoroid(int left, int top, int right, int bottom) {
-		super(left, top, right, bottom);
-	}
+  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 collision(GameObject gameObject) {
+    gameObject.collisionResolve(this);
+  }
 
-	@Override
-	public void collisionResolve(FlamingAsteroid asteroid) {
-		System.out.println(String.format("%s hits %s.", asteroid.getClass().getSimpleName(), this.getClass().getSimpleName()));
-	}
+  @Override
+  public void collisionResolve(FlamingAsteroid asteroid) {
+    System.out.println(String.format("%s hits %s.", asteroid.getClass().getSimpleName(), this
+        .getClass().getSimpleName()));
+  }
 
-	@Override
-	public void collisionResolve(Meteoroid meteoroid) {
-		System.out.println(String.format("%s hits %s.", meteoroid.getClass().getSimpleName(), this.getClass().getSimpleName()));
-	}
+  @Override
+  public void collisionResolve(Meteoroid meteoroid) {
+    System.out.println(String.format("%s hits %s.", meteoroid.getClass().getSimpleName(), this
+        .getClass().getSimpleName()));
+  }
 
-	@Override
-	public void collisionResolve(SpaceStationMir mir) {
-		System.out.println(String.format("%s hits %s.", mir.getClass().getSimpleName(), this.getClass().getSimpleName()));
-	}
+  @Override
+  public void collisionResolve(SpaceStationMir mir) {
+    System.out.println(String.format("%s hits %s.", mir.getClass().getSimpleName(), this.getClass()
+        .getSimpleName()));
+  }
 
-	@Override
-	public void collisionResolve(SpaceStationIss iss) {
-		System.out.println(String.format("%s hits %s.", iss.getClass().getSimpleName(), this.getClass().getSimpleName()));
-	}	
+  @Override
+  public void collisionResolve(SpaceStationIss iss) {
+    System.out.println(String.format("%s hits %s.", iss.getClass().getSimpleName(), this.getClass()
+        .getSimpleName()));
+  }
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
index 12aca0056..db26265cc 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/Rectangle.java
@@ -2,43 +2,46 @@ package com.iluwatar.doubledispatch;
 
 /**
  * 
- * Rectangle has coordinates and can be checked for overlap against
- * other Rectangles.
+ * 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;
+  private int left;
+  private int top;
+  private int right;
+  private int bottom;
 
-	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());
-	}
+  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());
+  }
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java
index 50eae3df8..4563b8de3 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationIss.java
@@ -7,12 +7,12 @@ package com.iluwatar.doubledispatch;
  */
 public class SpaceStationIss extends SpaceStationMir {
 
-	public SpaceStationIss(int left, int top, int right, int bottom) {
-		super(left, top, right, bottom);
-	}
+  public SpaceStationIss(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 collision(GameObject gameObject) {
+    gameObject.collisionResolve(this);
+  }
 }
diff --git a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
index 059b41271..5a4a19aaa 100644
--- a/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
+++ b/double-dispatch/src/main/java/com/iluwatar/doubledispatch/SpaceStationMir.java
@@ -7,45 +7,42 @@ package com.iluwatar.doubledispatch;
  */
 public class SpaceStationMir extends GameObject {
 
-	public SpaceStationMir(int left, int top, int right, int bottom) {
-		super(left, top, right, bottom);
-	}
+  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 collision(GameObject gameObject) {
+    gameObject.collisionResolve(this);
+  }
 
-	@Override
-	public void collisionResolve(FlamingAsteroid asteroid) {
-		System.out.println(String.format("%s hits %s. %s is damaged! %s is set on fire!", 
-				asteroid.getClass().getSimpleName(), this.getClass().getSimpleName(), 
-				this.getClass().getSimpleName(), this.getClass().getSimpleName()));
-		setDamaged(true);
-		setOnFire(true);
-	}
+  @Override
+  public void collisionResolve(FlamingAsteroid asteroid) {
+    System.out.println(String.format("%s hits %s. %s is damaged! %s 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) {
-		System.out.println(String.format("%s hits %s. %s is damaged!", 
-				meteoroid.getClass().getSimpleName(), this.getClass().getSimpleName(), 
-				this.getClass().getSimpleName()));
-		setDamaged(true);
-	}
+  @Override
+  public void collisionResolve(Meteoroid meteoroid) {
+    System.out.println(String.format("%s hits %s. %s is damaged!", meteoroid.getClass()
+        .getSimpleName(), this.getClass().getSimpleName(), this.getClass().getSimpleName()));
+    setDamaged(true);
+  }
 
-	@Override
-	public void collisionResolve(SpaceStationMir mir) {
-		System.out.println(String.format("%s hits %s. %s is damaged!", 
-				mir.getClass().getSimpleName(), this.getClass().getSimpleName(), 
-				this.getClass().getSimpleName()));
-		setDamaged(true);
-	}
+  @Override
+  public void collisionResolve(SpaceStationMir mir) {
+    System.out.println(String.format("%s hits %s. %s is damaged!", mir.getClass().getSimpleName(),
+        this.getClass().getSimpleName(), this.getClass().getSimpleName()));
+    setDamaged(true);
+  }
 
-	@Override
-	public void collisionResolve(SpaceStationIss iss) {
-		System.out.println(String.format("%s hits %s. %s is damaged!", 
-				iss.getClass().getSimpleName(), this.getClass().getSimpleName(), 
-				this.getClass().getSimpleName()));
-		setDamaged(true);
-	}	
+  @Override
+  public void collisionResolve(SpaceStationIss iss) {
+    System.out.println(String.format("%s hits %s. %s is damaged!", iss.getClass().getSimpleName(),
+        this.getClass().getSimpleName(), this.getClass().getSimpleName()));
+    setDamaged(true);
+  }
 }
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
index be93ee559..c5cd213b5 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.doubledispatch.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
index bb8aa954e..fad10c490 100644
--- a/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
+++ b/double-dispatch/src/test/java/com/iluwatar/doubledispatch/RectangleTest.java
@@ -12,11 +12,11 @@ import com.iluwatar.doubledispatch.Rectangle;
  */
 public class RectangleTest {
 
-	@Test
-	public void test() {
-		Assert.assertTrue(new Rectangle(0,0,1,1).intersectsWith(new Rectangle(0,0,1,1)));
-		Assert.assertTrue(new Rectangle(0,0,1,1).intersectsWith(new Rectangle(-1,-5,7,8)));
-		Assert.assertFalse(new Rectangle(0,0,1,1).intersectsWith(new Rectangle(2,2,3,3)));
-		Assert.assertFalse(new Rectangle(0,0,1,1).intersectsWith(new Rectangle(-2,-2,-1,-1)));
-	}
+  @Test
+  public void test() {
+    Assert.assertTrue(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(0, 0, 1, 1)));
+    Assert.assertTrue(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(-1, -5, 7, 8)));
+    Assert.assertFalse(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(2, 2, 3, 3)));
+    Assert.assertFalse(new Rectangle(0, 0, 1, 1).intersectsWith(new Rectangle(-2, -2, -1, -1)));
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
index b69d8ceaa..a16c36444 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/App.java
@@ -5,39 +5,40 @@ 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.
+ * 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.
+ * 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}.
+ * {@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);
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
 
-		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);
-			}
-		}
-	}
+    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);
+      }
+    }
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
index 79d496b80..ab66a6612 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Event.java
@@ -7,15 +7,16 @@ package com.iluwatar.event.aggregator;
  */
 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;
-    }
+  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;
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java
index 1832afeaa..a55d7d0e8 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventEmitter.java
@@ -10,26 +10,26 @@ import java.util.List;
  */
 public abstract class EventEmitter {
 
-	private List observers;
+  private List observers;
 
-	public EventEmitter() {
-		observers = new LinkedList<>();
-	}
+  public EventEmitter() {
+    observers = new LinkedList<>();
+  }
 
-	public EventEmitter(EventObserver obs) {
-		this();
-		registerObserver(obs);
-	}
-	
-	public 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);
+  public EventEmitter(EventObserver obs) {
+    this();
+    registerObserver(obs);
+  }
+
+  public 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);
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java
index a9785627f..dcc5ccab6 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/EventObserver.java
@@ -6,7 +6,7 @@ package com.iluwatar.event.aggregator;
  *
  */
 public interface EventObserver {
-	
-	void onEvent(Event e);
+
+  void onEvent(Event e);
 
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
index da45f2f1e..d6cb252cd 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingJoffrey.java
@@ -7,8 +7,8 @@ package com.iluwatar.event.aggregator;
  */
 public class KingJoffrey implements EventObserver {
 
-	@Override
-	public void onEvent(Event e) {
-		System.out.println("Received event from the King's Hand: " + e.toString());
-	}
+  @Override
+  public void onEvent(Event e) {
+    System.out.println("Received event from the King's Hand: " + e.toString());
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java
index a3e01334b..368033810 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/KingsHand.java
@@ -2,27 +2,26 @@ package com.iluwatar.event.aggregator;
 
 /**
  * 
- * KingsHand observes events from multiple sources and delivers them
- * to listeners.
+ * KingsHand observes events from multiple sources and delivers them to listeners.
  *
  */
 public class KingsHand extends EventEmitter implements EventObserver {
 
-	public KingsHand() {
-		super();
-	}
+  public KingsHand() {
+    super();
+  }
 
-	public KingsHand(EventObserver obs) {
-		super(obs);
-	}
-	
-	@Override
-	public void onEvent(Event e) {
-		notifyObservers(e);
-	}
+  public KingsHand(EventObserver obs) {
+    super(obs);
+  }
 
-	@Override
-	public void timePasses(Weekday day) {
-		// NOP
-	}
+  @Override
+  public void onEvent(Event e) {
+    notifyObservers(e);
+  }
+
+  @Override
+  public void timePasses(Weekday day) {
+    // NOP
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java
index b13ec88fc..6fafceb02 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordBaelish.java
@@ -6,19 +6,19 @@ package com.iluwatar.event.aggregator;
  *
  */
 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);
-		}
-	}
+  public LordBaelish() {
+    super();
+  }
+
+  public LordBaelish(EventObserver obs) {
+    super(obs);
+  }
+
+  @Override
+  public void timePasses(Weekday day) {
+    if (day.equals(Weekday.FRIDAY)) {
+      notifyObservers(Event.STARK_SIGHTED);
+    }
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java
index d1fec048a..880cf4e85 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/LordVarys.java
@@ -6,19 +6,19 @@ package com.iluwatar.event.aggregator;
  *
  */
 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);
-		}
-	}
+  public LordVarys() {
+    super();
+  }
+
+  public LordVarys(EventObserver obs) {
+    super(obs);
+  }
+
+  @Override
+  public void timePasses(Weekday day) {
+    if (day.equals(Weekday.SATURDAY)) {
+      notifyObservers(Event.TRAITOR_DETECTED);
+    }
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java
index 8ff4e04ab..7eb6878ae 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Scout.java
@@ -6,19 +6,19 @@ package com.iluwatar.event.aggregator;
  *
  */
 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);
-		}
-	}
+  public Scout() {
+    super();
+  }
+
+  public Scout(EventObserver obs) {
+    super(obs);
+  }
+
+  @Override
+  public void timePasses(Weekday day) {
+    if (day.equals(Weekday.TUESDAY)) {
+      notifyObservers(Event.WARSHIPS_APPROACHING);
+    }
+  }
 }
diff --git a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
index bafc4f36a..24cc02a25 100644
--- a/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
+++ b/event-aggregator/src/main/java/com/iluwatar/event/aggregator/Weekday.java
@@ -6,16 +6,17 @@ package com.iluwatar.event.aggregator;
  *
  */
 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;
-	}
+  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;
+  }
 }
diff --git a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
index f8f765880..0cb76c215 100644
--- a/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
+++ b/event-aggregator/src/test/java/com/iluwatar/event/aggregator/AppTest.java
@@ -1,4 +1,5 @@
 package com.iluwatar.event.aggregator;
+
 import org.junit.Test;
 
 import com.iluwatar.event.aggregator.App;
@@ -10,9 +11,9 @@ import com.iluwatar.event.aggregator.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/App.java b/execute-around/src/main/java/com/iluwatar/execute/around/App.java
index 910a024de..4a0648dbe 100644
--- a/execute-around/src/main/java/com/iluwatar/execute/around/App.java
+++ b/execute-around/src/main/java/com/iluwatar/execute/around/App.java
@@ -4,32 +4,33 @@ 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.
+ * 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.
+ * 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
-	 * @param args command line args
-	 * @throws IOException
-	 */
-    public static void main( String[] args ) throws IOException {
 
-    	new SimpleFileWriter("testfile.txt", new FileWriterAction() {
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   * @throws IOException
+   */
+  public static void main(String[] args) throws IOException {
 
-    		@Override
-			public void writeFile(FileWriter writer) throws IOException {
-    			writer.write("Hello");
-    			writer.append(" ");
-    			writer.append("there!");
-			}
-    	});
-    }
+    new SimpleFileWriter("testfile.txt", new FileWriterAction() {
+
+      @Override
+      public void writeFile(FileWriter writer) throws IOException {
+        writer.write("Hello");
+        writer.append(" ");
+        writer.append("there!");
+      }
+    });
+  }
 }
diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java b/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java
index 904600ec6..1477c0ae4 100644
--- a/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java
+++ b/execute-around/src/main/java/com/iluwatar/execute/around/FileWriterAction.java
@@ -10,6 +10,6 @@ import java.io.IOException;
  */
 public interface FileWriterAction {
 
-	void writeFile(FileWriter writer) throws IOException;
-	
+  void writeFile(FileWriter writer) throws IOException;
+
 }
diff --git a/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java
index a7ee11d15..be89ff9ce 100644
--- a/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java
+++ b/execute-around/src/main/java/com/iluwatar/execute/around/SimpleFileWriter.java
@@ -5,19 +5,18 @@ 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.
+ * 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 {
 
-	public SimpleFileWriter(String filename, FileWriterAction action) throws IOException {
-		FileWriter writer = new FileWriter(filename);
-		try {
-			action.writeFile(writer);
-		} finally {
-			writer.close();
-		}
-	}
+  public SimpleFileWriter(String filename, FileWriterAction action) throws IOException {
+    FileWriter writer = new FileWriter(filename);
+    try {
+      action.writeFile(writer);
+    } finally {
+      writer.close();
+    }
+  }
 }
diff --git a/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
index 1e8a45947..9eb3dbf5f 100644
--- a/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
+++ b/execute-around/src/test/java/com/iluwatar/execute/around/AppTest.java
@@ -15,17 +15,17 @@ import com.iluwatar.execute.around.App;
  *
  */
 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();
-	}
+
+  @Test
+  public void test() throws IOException {
+    String[] args = {};
+    App.main(args);
+  }
+
+  @Before
+  @After
+  public void cleanup() {
+    File file = new File("testfile.txt");
+    file.delete();
+  }
 }
diff --git a/facade/src/main/java/com/iluwatar/facade/App.java b/facade/src/main/java/com/iluwatar/facade/App.java
index 37cda0281..bcc492e0b 100644
--- a/facade/src/main/java/com/iluwatar/facade/App.java
+++ b/facade/src/main/java/com/iluwatar/facade/App.java
@@ -2,27 +2,28 @@ 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.
+ * 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.
+ * 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();
-	}
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    DwarvenGoldmineFacade facade = new DwarvenGoldmineFacade();
+    facade.startNewDay();
+    facade.digOutGold();
+    facade.endDay();
+  }
 }
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java b/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
index 7c33fd267..d2b6f366e 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenCartOperator.java
@@ -7,14 +7,13 @@ package com.iluwatar.facade;
  */
 public class DwarvenCartOperator extends DwarvenMineWorker {
 
-	@Override
-	public void work() {
-		System.out.println(name() + " moves gold chunks out of the mine.");
-	}
-
-	@Override
-	public String name() {
-		return "Dwarf cart operator";
-	}
+  @Override
+  public void work() {
+    System.out.println(name() + " moves gold chunks out of the mine.");
+  }
 
+  @Override
+  public String name() {
+    return "Dwarf cart operator";
+  }
 }
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
index b503889b7..df5ab1356 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldDigger.java
@@ -7,14 +7,13 @@ package com.iluwatar.facade;
  */
 public class DwarvenGoldDigger extends DwarvenMineWorker {
 
-	@Override
-	public void work() {
-		System.out.println(name() + " digs for gold.");
-	}
-
-	@Override
-	public String name() {
-		return "Dwarf gold digger";
-	}
+  @Override
+  public void work() {
+    System.out.println(name() + " digs for gold.");
+  }
 
+  @Override
+  public String name() {
+    return "Dwarf gold digger";
+  }
 }
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java
index 83a989fa7..d6b653eaa 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenGoldmineFacade.java
@@ -6,40 +6,39 @@ import java.util.List;
 
 /**
  * 
- * DwarvenGoldmineFacade provides a single interface
- * through which users can operate the subsystems.
+ * 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.
+ * 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;
+  private final List workers;
 
-	public DwarvenGoldmineFacade() {
-		workers = new ArrayList<>();
-		workers.add(new DwarvenGoldDigger());
-		workers.add(new DwarvenCartOperator());
-		workers.add(new DwarvenTunnelDigger());
-	}
+  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 startNewDay() {
+    makeActions(workers, DwarvenMineWorker.Action.WAKE_UP, DwarvenMineWorker.Action.GO_TO_MINE);
+  }
 
-	public void digOutGold() {
-        makeActions(workers, DwarvenMineWorker.Action.WORK);
-	}
+  public void digOutGold() {
+    makeActions(workers, DwarvenMineWorker.Action.WORK);
+  }
 
-	public void endDay() {
-        makeActions(workers, DwarvenMineWorker.Action.GO_HOME, DwarvenMineWorker.Action.GO_TO_SLEEP);
-	}
+  public void endDay() {
+    makeActions(workers, DwarvenMineWorker.Action.GO_HOME, DwarvenMineWorker.Action.GO_TO_SLEEP);
+  }
 
-    private void makeActions(Collection workers, DwarvenMineWorker.Action... actions) {
-        for (DwarvenMineWorker worker : workers) {
-            worker.action(actions);
-        }
+  private void makeActions(Collection workers,
+      DwarvenMineWorker.Action... actions) {
+    for (DwarvenMineWorker worker : workers) {
+      worker.action(actions);
     }
+  }
 }
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java b/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
index 3dd51f907..d329fe84b 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenMineWorker.java
@@ -7,56 +7,56 @@ package com.iluwatar.facade;
  */
 public abstract class DwarvenMineWorker {
 
-	public void goToSleep() {
-		System.out.println(name() + " goes to sleep.");
-	}
+  public void goToSleep() {
+    System.out.println(name() + " goes to sleep.");
+  }
 
-	public void wakeUp() {
-		System.out.println(name() + " wakes up.");
-	}
+  public void wakeUp() {
+    System.out.println(name() + " wakes up.");
+  }
 
-	public void goHome() {
-		System.out.println(name() + " goes home.");
-	}
+  public void goHome() {
+    System.out.println(name() + " goes home.");
+  }
 
-	public void goToMine() {
-		System.out.println(name() + " goes to the mine.");
-	}
+  public void goToMine() {
+    System.out.println(name() + " goes to the mine.");
+  }
 
-    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:
-                System.out.println("Undefined action");
-                break;
-        }
+  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:
+        System.out.println("Undefined action");
+        break;
     }
+  }
 
-    public void action(Action... actions) {
-        for (Action action : actions) {
-            action(action);
-        }
+  public void action(Action... actions) {
+    for (Action action : actions) {
+      action(action);
     }
+  }
 
-	public abstract void work();
+  public abstract void work();
 
-	public abstract String name();
+  public abstract String name();
 
-    static enum Action {
-        GO_TO_SLEEP, WAKE_UP, GO_HOME, GO_TO_MINE, WORK
-    }
+  static enum Action {
+    GO_TO_SLEEP, WAKE_UP, GO_HOME, GO_TO_MINE, WORK
+  }
 }
diff --git a/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java b/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
index 05fe02fb6..1d3dbe99d 100644
--- a/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
+++ b/facade/src/main/java/com/iluwatar/facade/DwarvenTunnelDigger.java
@@ -7,14 +7,13 @@ package com.iluwatar.facade;
  */
 public class DwarvenTunnelDigger extends DwarvenMineWorker {
 
-	@Override
-	public void work() {
-		System.out.println(name() + " creates another promising tunnel.");
-	}
-
-	@Override
-	public String name() {
-		return "Dwarven tunnel digger";
-	}
+  @Override
+  public void work() {
+    System.out.println(name() + " creates another promising tunnel.");
+  }
 
+  @Override
+  public String name() {
+    return "Dwarven tunnel digger";
+  }
 }
diff --git a/facade/src/test/java/com/iluwatar/facade/AppTest.java b/facade/src/test/java/com/iluwatar/facade/AppTest.java
index bfca5473a..49b7c01c4 100644
--- a/facade/src/test/java/com/iluwatar/facade/AppTest.java
+++ b/facade/src/test/java/com/iluwatar/facade/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.facade.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/App.java b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
index 118413564..27b7e3121 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/App.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/App.java
@@ -2,39 +2,39 @@ package com.iluwatar.factory.method;
 
 /**
  * 
- * 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.
+ * 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.
+ * 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 {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
-		Blacksmith blacksmith;
-		Weapon weapon;
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    Blacksmith blacksmith;
+    Weapon weapon;
 
-		blacksmith = new OrcBlacksmith();
-		weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
-		System.out.println(weapon);
-		weapon = blacksmith.manufactureWeapon(WeaponType.AXE);
-		System.out.println(weapon);
+    blacksmith = new OrcBlacksmith();
+    weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
+    System.out.println(weapon);
+    weapon = blacksmith.manufactureWeapon(WeaponType.AXE);
+    System.out.println(weapon);
 
-		blacksmith = new ElfBlacksmith();
-		weapon = blacksmith.manufactureWeapon(WeaponType.SHORT_SWORD);
-		System.out.println(weapon);
-		weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
-		System.out.println(weapon);
-	}
+    blacksmith = new ElfBlacksmith();
+    weapon = blacksmith.manufactureWeapon(WeaponType.SHORT_SWORD);
+    System.out.println(weapon);
+    weapon = blacksmith.manufactureWeapon(WeaponType.SPEAR);
+    System.out.println(weapon);
+  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java
index 516c993a9..991a9d433 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/Blacksmith.java
@@ -7,6 +7,6 @@ package com.iluwatar.factory.method;
  */
 public interface Blacksmith {
 
-	Weapon manufactureWeapon(WeaponType weaponType);
+  Weapon manufactureWeapon(WeaponType weaponType);
 
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
index 9a5e62890..99de5329b 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfBlacksmith.java
@@ -7,8 +7,8 @@ package com.iluwatar.factory.method;
  */
 public class ElfBlacksmith implements Blacksmith {
 
-	public Weapon manufactureWeapon(WeaponType weaponType) {
-		return new ElfWeapon(weaponType);
-	}
+  public Weapon manufactureWeapon(WeaponType weaponType) {
+    return new ElfWeapon(weaponType);
+  }
 
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
index 75bb8a9e0..d2f38bc48 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/ElfWeapon.java
@@ -7,15 +7,14 @@ package com.iluwatar.factory.method;
  */
 public class ElfWeapon implements Weapon {
 
-	private WeaponType weaponType;
+  private WeaponType weaponType;
 
-	public ElfWeapon(WeaponType weaponType) {
-		this.weaponType = weaponType;
-	}
-
-	@Override
-	public String toString() {
-		return "Elven " + weaponType;
-	}
+  public ElfWeapon(WeaponType weaponType) {
+    this.weaponType = weaponType;
+  }
 
+  @Override
+  public String toString() {
+    return "Elven " + weaponType;
+  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
index 382507ec9..c4db6c223 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcBlacksmith.java
@@ -7,8 +7,7 @@ package com.iluwatar.factory.method;
  */
 public class OrcBlacksmith implements Blacksmith {
 
-	public Weapon manufactureWeapon(WeaponType weaponType) {
-		return new OrcWeapon(weaponType);
-	}
-
+  public Weapon manufactureWeapon(WeaponType weaponType) {
+    return new OrcWeapon(weaponType);
+  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
index 85500799e..48cd9c5a3 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/OrcWeapon.java
@@ -7,15 +7,14 @@ package com.iluwatar.factory.method;
  */
 public class OrcWeapon implements Weapon {
 
-	private WeaponType weaponType;
+  private WeaponType weaponType;
 
-	public OrcWeapon(WeaponType weaponType) {
-		this.weaponType = weaponType;
-	}
-
-	@Override
-	public String toString() {
-		return "Orcish " + weaponType;
-	}
+  public OrcWeapon(WeaponType weaponType) {
+    this.weaponType = weaponType;
+  }
 
+  @Override
+  public String toString() {
+    return "Orcish " + weaponType;
+  }
 }
diff --git a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
index 1c0341670..4c8f83e9b 100644
--- a/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
+++ b/factory-method/src/main/java/com/iluwatar/factory/method/WeaponType.java
@@ -7,16 +7,16 @@ package com.iluwatar.factory.method;
  */
 public enum WeaponType {
 
-	SHORT_SWORD("short sword"), SPEAR("spear"), AXE("axe"), UNDEFINED("");
+  SHORT_SWORD("short sword"), SPEAR("spear"), AXE("axe"), UNDEFINED("");
 
-    private String title;
+  private String title;
 
-    WeaponType(String title) {
-        this.title = title;
-    }
+  WeaponType(String title) {
+    this.title = title;
+  }
 
-    @Override
-	public String toString() {
-		return title;
-	}
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
index c6db18b3e..cb48d9ad7 100644
--- a/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
+++ b/factory-method/src/test/java/com/iluwatar/factory/method/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.factory.method.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
index 7733df37d..bdff83e17 100644
--- a/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
+++ b/fluentinterface/src/main/java/com/iluwatar/fluentinterface/app/App.java
@@ -11,13 +11,15 @@ import java.util.function.Predicate;
 import static java.lang.String.valueOf;
 
 /**
- * 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.
+ * 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.
+ * {@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 {
@@ -25,11 +27,9 @@ public class App {
   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
-    ));
-    
+    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 =
diff --git a/flux/src/main/java/com/iluwatar/flux/action/Action.java b/flux/src/main/java/com/iluwatar/flux/action/Action.java
index 24d294be7..b456c1ebe 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/Action.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/Action.java
@@ -7,13 +7,13 @@ package com.iluwatar.flux.action;
  */
 public abstract class Action {
 
-	private ActionType type;
-	
-	public Action(ActionType type) {
-		this.type = type;
-	}
-	
-	public ActionType getType() {
-		return type;
-	}
+  private ActionType type;
+
+  public Action(ActionType type) {
+    this.type = type;
+  }
+
+  public ActionType getType() {
+    return type;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/ActionType.java b/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
index 318ca1b12..bbe13bc39 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/ActionType.java
@@ -7,6 +7,6 @@ package com.iluwatar.flux.action;
  */
 public enum ActionType {
 
-	MENU_ITEM_SELECTED, CONTENT_CHANGED;
-	
+  MENU_ITEM_SELECTED, CONTENT_CHANGED;
+
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/Content.java b/flux/src/main/java/com/iluwatar/flux/action/Content.java
index e53871d89..84910b3af 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/Content.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/Content.java
@@ -6,17 +6,18 @@ package com.iluwatar.flux.action;
  *
  */
 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;
-	}
+  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;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java b/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java
index 2c1a40e6e..842a5282f 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/ContentAction.java
@@ -7,14 +7,14 @@ package com.iluwatar.flux.action;
  */
 public class ContentAction extends Action {
 
-	private Content content;
+  private Content content;
 
-	public ContentAction(Content content) {
-		super(ActionType.CONTENT_CHANGED);
-		this.content = content;
-	}
-	
-	public Content getContent() {
-		return content;
-	}
+  public ContentAction(Content content) {
+    super(ActionType.CONTENT_CHANGED);
+    this.content = content;
+  }
+
+  public Content getContent() {
+    return content;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java b/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java
index a3dd9875e..71e47e051 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/MenuAction.java
@@ -8,14 +8,14 @@ package com.iluwatar.flux.action;
  */
 public class MenuAction extends Action {
 
-	private MenuItem menuItem;
+  private MenuItem menuItem;
 
-	public MenuAction(MenuItem menuItem) {
-		super(ActionType.MENU_ITEM_SELECTED);
-		this.menuItem = menuItem;
-	}	
-	
-	public MenuItem getMenuItem() {
-		return menuItem;
-	}
+  public MenuAction(MenuItem menuItem) {
+    super(ActionType.MENU_ITEM_SELECTED);
+    this.menuItem = menuItem;
+  }
+
+  public MenuItem getMenuItem() {
+    return menuItem;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java b/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java
index d842fca78..c1732bb97 100644
--- a/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java
+++ b/flux/src/main/java/com/iluwatar/flux/action/MenuItem.java
@@ -6,17 +6,17 @@ package com.iluwatar.flux.action;
  *
  */
 public enum MenuItem {
-	
-	HOME("Home"), PRODUCTS("Products"), COMPANY("Company");
-	
-	private String title;
 
-	MenuItem(String title) {
-		this.title = title;
-	}
-	
-	@Override
-	public String toString() {
-		return title;
-	}
+  HOME("Home"), PRODUCTS("Products"), COMPANY("Company");
+
+  private String title;
+
+  MenuItem(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/app/App.java b/flux/src/main/java/com/iluwatar/flux/app/App.java
index a567a92d3..0f301a2ae 100644
--- a/flux/src/main/java/com/iluwatar/flux/app/App.java
+++ b/flux/src/main/java/com/iluwatar/flux/app/App.java
@@ -9,43 +9,45 @@ 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.  
+ * 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.
+ * 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);
-    }
+
+  /**
+   * 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);
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java b/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
index 8bf03e4b0..26c836b0e 100644
--- a/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
+++ b/flux/src/main/java/com/iluwatar/flux/dispatcher/Dispatcher.java
@@ -16,37 +16,36 @@ import com.iluwatar.flux.store.Store;
  *
  */
 public 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);
-	}
-	
-	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));
-	}
+  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);
+  }
+
+  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));
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java b/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java
index 15d031abd..621dc4c0c 100644
--- a/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java
+++ b/flux/src/main/java/com/iluwatar/flux/store/ContentStore.java
@@ -12,18 +12,18 @@ import com.iluwatar.flux.action.ContentAction;
  */
 public class ContentStore extends Store {
 
-	private Content content = Content.PRODUCTS;
+  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;
-	}
+  @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;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java b/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java
index 3e614ac73..23d27bcde 100644
--- a/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java
+++ b/flux/src/main/java/com/iluwatar/flux/store/MenuStore.java
@@ -12,18 +12,18 @@ import com.iluwatar.flux.action.MenuItem;
  */
 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;
-	}
+  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;
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/store/Store.java b/flux/src/main/java/com/iluwatar/flux/store/Store.java
index 326af404b..0562405b2 100644
--- a/flux/src/main/java/com/iluwatar/flux/store/Store.java
+++ b/flux/src/main/java/com/iluwatar/flux/store/Store.java
@@ -12,16 +12,16 @@ import com.iluwatar.flux.view.View;
  *
  */
 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));
-	}
+  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));
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/view/ContentView.java b/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
index b12c8b7a2..5718a07f3 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/ContentView.java
@@ -11,17 +11,17 @@ import com.iluwatar.flux.store.Store;
  */
 public class ContentView implements View {
 
-	private Content content = Content.PRODUCTS;
+  private Content content = Content.PRODUCTS;
 
-	@Override
-	public void storeChanged(Store store) {
-		ContentStore contentStore = (ContentStore) store;
-		content = contentStore.getContent();
-		render();
-	}
+  @Override
+  public void storeChanged(Store store) {
+    ContentStore contentStore = (ContentStore) store;
+    content = contentStore.getContent();
+    render();
+  }
 
-	@Override
-	public void render() {
-		System.out.println(content.toString());
-	}
+  @Override
+  public void render() {
+    System.out.println(content.toString());
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/view/MenuView.java b/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
index f37d21bb9..20f8ce03d 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/MenuView.java
@@ -12,27 +12,27 @@ import com.iluwatar.flux.store.Store;
  */
 public class MenuView implements View {
 
-	private MenuItem selected = MenuItem.HOME;
-	
-	@Override
-	public void storeChanged(Store store) {
-		MenuStore menuStore = (MenuStore) store;
-		selected = menuStore.getSelected();
-		render();
-	}
+  private MenuItem selected = MenuItem.HOME;
 
-	@Override
-	public void render() {
-		for (MenuItem item: MenuItem.values()) {
-			if (selected.equals(item)) {
-				System.out.println(String.format("* %s", item.toString()));
-			} else {
-				System.out.println(item.toString());
-			}
-		}
-	}
-	
-	public void itemClicked(MenuItem item) {
-		Dispatcher.getInstance().menuItemSelected(item);
-	}
+  @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)) {
+        System.out.println(String.format("* %s", item.toString()));
+      } else {
+        System.out.println(item.toString());
+      }
+    }
+  }
+
+  public void itemClicked(MenuItem item) {
+    Dispatcher.getInstance().menuItemSelected(item);
+  }
 }
diff --git a/flux/src/main/java/com/iluwatar/flux/view/View.java b/flux/src/main/java/com/iluwatar/flux/view/View.java
index 4eb6ee3fb..a642b5b2c 100644
--- a/flux/src/main/java/com/iluwatar/flux/view/View.java
+++ b/flux/src/main/java/com/iluwatar/flux/view/View.java
@@ -9,7 +9,7 @@ import com.iluwatar.flux.store.Store;
  */
 public interface View {
 
-	public void storeChanged(Store store);
+  public void storeChanged(Store store);
 
-	public void render();
+  public void render();
 }
diff --git a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
index ba4b592a1..918c76acd 100644
--- a/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
+++ b/flux/src/test/java/com/iluwatar/flux/app/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.flux.app.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java b/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
index e87f2e6cf..15206a84a 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/AlchemistShop.java
@@ -5,53 +5,52 @@ import java.util.List;
 
 /**
  * 
- * AlchemistShop holds potions on its shelves.
- * It uses PotionFactory to provide the potions.
+ * AlchemistShop holds potions on its shelves. It uses PotionFactory to provide the potions.
  * 
  */
 public class AlchemistShop {
 
-	private List topShelf;
-	private List bottomShelf;
+  private List topShelf;
+  private List bottomShelf;
 
-	public AlchemistShop() {
-		topShelf = new ArrayList<>();
-		bottomShelf = new ArrayList<>();
-		fillShelves();
-	}
+  public AlchemistShop() {
+    topShelf = new ArrayList<>();
+    bottomShelf = new ArrayList<>();
+    fillShelves();
+  }
 
-	private void fillShelves() {
+  private void fillShelves() {
 
-		PotionFactory factory = new PotionFactory();
+    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));
+    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));
-	}
+    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));
+  }
 
-	public void enumerate() {
+  public void enumerate() {
 
-		System.out.println("Enumerating top shelf potions\n");
+    System.out.println("Enumerating top shelf potions\n");
 
-		for (Potion p : topShelf) {
-			p.drink();
-		}
+    for (Potion p : topShelf) {
+      p.drink();
+    }
 
-		System.out.println("\nEnumerating bottom shelf potions\n");
+    System.out.println("\nEnumerating bottom shelf potions\n");
 
-		for (Potion p : bottomShelf) {
-			p.drink();
-		}
-	}
+    for (Potion p : bottomShelf) {
+      p.drink();
+    }
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/App.java b/flyweight/src/main/java/com/iluwatar/flyweight/App.java
index c08ba78a3..211e031df 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/App.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/App.java
@@ -2,26 +2,27 @@ 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.
+ * 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.
+ * 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.
+ * 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();
-	}
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    AlchemistShop alchemistShop = new AlchemistShop();
+    alchemistShop.enumerate();
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
index a5f8f4fb8..c458e19b5 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/HealingPotion.java
@@ -7,10 +7,8 @@ package com.iluwatar.flyweight;
  */
 public class HealingPotion implements Potion {
 
-	@Override
-	public void drink() {
-		System.out.println("You feel healed. (Potion="
-				+ System.identityHashCode(this) + ")");
-	}
-
+  @Override
+  public void drink() {
+    System.out.println("You feel healed. (Potion=" + System.identityHashCode(this) + ")");
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
index 750e3c568..45034c29a 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/HolyWaterPotion.java
@@ -7,10 +7,8 @@ package com.iluwatar.flyweight;
  */
 public class HolyWaterPotion implements Potion {
 
-	@Override
-	public void drink() {
-		System.out.println("You feel blessed. (Potion="
-				+ System.identityHashCode(this) + ")");
-	}
-
+  @Override
+  public void drink() {
+    System.out.println("You feel blessed. (Potion=" + System.identityHashCode(this) + ")");
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
index db9d261d5..ca8de16e9 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/InvisibilityPotion.java
@@ -7,10 +7,8 @@ package com.iluwatar.flyweight;
  */
 public class InvisibilityPotion implements Potion {
 
-	@Override
-	public void drink() {
-		System.out.println("You become invisible. (Potion="
-				+ System.identityHashCode(this) + ")");
-	}
-
+  @Override
+  public void drink() {
+    System.out.println("You become invisible. (Potion=" + System.identityHashCode(this) + ")");
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
index dfcd3c38d..f1a1855f8 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PoisonPotion.java
@@ -7,10 +7,8 @@ package com.iluwatar.flyweight;
  */
 public class PoisonPotion implements Potion {
 
-	@Override
-	public void drink() {
-		System.out.println("Urgh! This is poisonous. (Potion="
-				+ System.identityHashCode(this) + ")");
-	}
-
+  @Override
+  public void drink() {
+    System.out.println("Urgh! This is poisonous. (Potion=" + System.identityHashCode(this) + ")");
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java b/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java
index c4110201c..1ba72431a 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/Potion.java
@@ -7,5 +7,5 @@ package com.iluwatar.flyweight;
  */
 public interface Potion {
 
-	void drink();
+  void drink();
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java b/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java
index 20ec110e3..8154da984 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PotionFactory.java
@@ -5,48 +5,47 @@ 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.
+ * 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;
+  private final Map potions;
 
-	public PotionFactory() {
-		potions = new EnumMap<>(PotionType.class);
-	}
+  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;
-	}
+  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;
+  }
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java b/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java
index bbb9b6521..0aade3826 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/PotionType.java
@@ -7,5 +7,5 @@ package com.iluwatar.flyweight;
  */
 public enum PotionType {
 
-	HEALING, INVISIBILITY, STRENGTH, HOLY_WATER, POISON
+  HEALING, INVISIBILITY, STRENGTH, HOLY_WATER, POISON
 }
diff --git a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
index 49083cf7c..f729668d4 100644
--- a/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
+++ b/flyweight/src/main/java/com/iluwatar/flyweight/StrengthPotion.java
@@ -7,9 +7,8 @@ package com.iluwatar.flyweight;
  */
 public class StrengthPotion implements Potion {
 
-	@Override
-	public void drink() {
-		System.out.println("You feel strong. (Potion="
-				+ System.identityHashCode(this) + ")");
-	}
+  @Override
+  public void drink() {
+    System.out.println("You feel strong. (Potion=" + System.identityHashCode(this) + ")");
+  }
 }
diff --git a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
index f3b033ba7..16fdb005e 100644
--- a/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
+++ b/flyweight/src/test/java/com/iluwatar/flyweight/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.flyweight.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
index b8cec89e3..80f2eefb2 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/App.java
@@ -8,122 +8,120 @@ import java.util.concurrent.LinkedBlockingQueue;
  * {@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
+ * 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
- * 
    
+ * 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 
    
  * 
    
- *  
+ * 
  • 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.
    • 
+ * 
      
  * 
    • 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.
- *  
  • 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.
+ * 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 {
 
-	/**
-	 * 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;
+  /**
+   * 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));
 
-		public ArithmeticSumTask(long n) {
-			this.n = n;
-		}
+    /*
+     * 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));
+  }
 
-		/*
-		 * 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);
-		}
+  /**
+   * 
+   * ArithmeticSumTask
+   *
+   */
+  static class ArithmeticSumTask implements AsyncTask {
+    private long 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");
-			}
-		}
+    public ArithmeticSumTask(long n) {
+      this.n = n;
+    }
 
-		@Override
-		public void onPostCall(Long result) {
-			// Handle the result of computation
-			System.out.println(result);
-		}
+    /*
+     * 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);
+    }
 
-		@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) {
-		}
-		return (i) * (i + 1) / 2;
-	}
+    /*
+     * 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
+      System.out.println(result);
+    }
+
+    @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) {
+    }
+    return (i) * (i + 1) / 2;
+  }
 }
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java
index 8ed7376b6..fb63e9653 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsyncTask.java
@@ -3,42 +3,42 @@ 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.
+ * 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;
+  /**
+   * 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;
 }
diff --git a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
index 6c36354d0..457dffa20 100644
--- a/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
+++ b/half-sync-half-async/src/main/java/com/iluwatar/halfsynchalfasync/AsynchronousService.java
@@ -9,67 +9,67 @@ 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.
+ * 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);
-	}
-	
+  /*
+   * 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;
 
-	/**
-	 * 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);
-		}
+  /**
+   * 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);
+  }
 
-		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());
-				}
-			}
-		});
-	}
+
+  /**
+   * 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);
+    }
+
+    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());
+        }
+      }
+    });
+  }
 }
diff --git a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
index a72417aff..4104bdaf2 100644
--- a/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
+++ b/half-sync-half-async/src/test/java/com/iluwatar/halfsynchalfasync/AppTest.java
@@ -11,8 +11,8 @@ import org.junit.Test;
  */
 public class AppTest {
 
-	@Test
-	public void test() throws InterruptedException, ExecutionException {
-		App.main(null);
-	}
+  @Test
+  public void test() throws InterruptedException, ExecutionException {
+    App.main(null);
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java
index 2c32772fa..1dd31b201 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AbstractFilter.java
@@ -1,46 +1,44 @@
 package com.iluwatar.intercepting.filter;
 
 /**
- * Base class for order processing filters.
- * Handles chain management.
+ * Base class for order processing filters. Handles chain management.
  *
  */
 public abstract class AbstractFilter implements Filter {
 
-	private Filter next;
-	
-	public AbstractFilter() {
-	}
+  private Filter next;
 
-	public AbstractFilter(Filter next) {
-		this.next = next;
-	}
-	
-	@Override
-	public void setNext(Filter filter) {
-		this.next = filter;	
-	}
-	
-	@Override
-	public Filter getNext() {
-		return next;
-	}
+  public AbstractFilter() {}
 
-	@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 "";
-		}
-	}
+  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 "";
+    }
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java
index 0bd66c047..c1aa0780b 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/AddressFilter.java
@@ -1,19 +1,20 @@
 package com.iluwatar.intercepting.filter;
 
 /**
- * Concrete implementation of filter
- * This filter is responsible for checking/filtering the input in the address field.
+ * 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;
-	}
+
+  @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;
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
index c913da66c..817ae7587 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/App.java
@@ -2,50 +2,46 @@ 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 
+ * 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 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.
+ * 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}
+ * 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(new Target());
-		filterManager.addFilter(new NameFilter());
-		filterManager.addFilter(new ContactFilter());
-		filterManager.addFilter(new AddressFilter());
-		filterManager.addFilter(new DepositFilter());
-		filterManager.addFilter(new OrderFilter());
+public class App {
 
-		Client client = new Client();
-		client.setFilterManager(filterManager);
-	}
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    FilterManager filterManager = new FilterManager(new Target());
+    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);
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java
index 0125d1b9d..02499ed0a 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Client.java
@@ -15,93 +15,95 @@ 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}.
+ * 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}.
+ * 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 static final long serialVersionUID = 1L;
 
-	private FilterManager filterManager;
-	private JLabel jl;
-	private JTextField[] jtFields;
-	private JTextArea[] jtAreas;
-	private JButton clearButton, processButton;
+  private FilterManager filterManager;
+  private JLabel jl;
+  private JTextField[] jtFields;
+  private JTextArea[] jtAreas;
+  private JButton clearButton, processButton;
 
-	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");
+  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();
-	}
+    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);
+  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("");
-				}
-			}
-		});
+    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));
-			}
-		});
+    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);
-	}
+    JRootPane rootPane = SwingUtilities.getRootPane(processButton);
+    rootPane.setDefaultButton(processButton);
+    setVisible(true);
+  }
 
-	public void setFilterManager(FilterManager filterManager) {
-		this.filterManager = filterManager;
-	}
+  public void setFilterManager(FilterManager filterManager) {
+    this.filterManager = filterManager;
+  }
 
-	public String sendRequest(Order order) {
-		return filterManager.filterRequest(order);
-	}
+  public String sendRequest(Order order) {
+    return filterManager.filterRequest(order);
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java
index 214376263..9d5ff1336 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/ContactFilter.java
@@ -1,24 +1,24 @@
 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)
+ * 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;
-		}
-	}
+
+  @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;
+    }
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java
index 129c07cd7..62bc600f3 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/DepositFilter.java
@@ -1,20 +1,20 @@
 package com.iluwatar.intercepting.filter;
 
 /**
- * Concrete implementation of filter
- * This checks for the deposit code 
+ * 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;
-		}
-	}
+
+  @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;
+    }
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java
index a71be5154..9496bde36 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Filter.java
@@ -1,37 +1,40 @@
 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
+ * 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.
-	 * @param order
-	 * @return empty string on success, otherwise error message.
-	 */
-	String execute(Order order);
-	
-	/**
-	 * Set next filter in chain after this.
-	 * @param filter
-	 */
-	void setNext(Filter filter);
-	
-	/**
-	 * Get next filter in chain after this.
-	 * @return
-	 */
-	Filter getNext();
-	
-	/**
-	 * Get last filter in the chain.
-	 * @return
-	 */
-	Filter getLast();
+
+  /**
+   * Execute order processing filter.
+   * 
+   * @param order
+   * @return empty string on success, otherwise error message.
+   */
+  String execute(Order order);
+
+  /**
+   * Set next filter in chain after this.
+   * 
+   * @param filter
+   */
+  void setNext(Filter filter);
+
+  /**
+   * Get next filter in chain after this.
+   * 
+   * @return
+   */
+  Filter getNext();
+
+  /**
+   * Get last filter in the chain.
+   * 
+   * @return
+   */
+  Filter getLast();
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java
index e11a58ea0..987678cc7 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterChain.java
@@ -1,34 +1,34 @@
- package com.iluwatar.intercepting.filter;
- 
-  
+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;
-	
-	private final Target target;
 
-	public FilterChain(Target target) {
-		this.target = target;
-	}
+  private Filter chain;
 
-	public void addFilter(Filter filter) {
-		if (chain == null) {
-			chain = filter;
-		} else {
-			chain.getLast().setNext(filter);
-		}
-	}
+  private final Target target;
 
-	public String execute(Order order) {
-		if (chain != null) {
-			return chain.execute(order);
-		} else {
-			return "RUNNING...";
-		}
-	}
+  public FilterChain(Target target) {
+    this.target = target;
+  }
+
+  public void addFilter(Filter filter) {
+    if (chain == null) {
+      chain = filter;
+    } else {
+      chain.getLast().setNext(filter);
+    }
+  }
+
+  public String execute(Order order) {
+    if (chain != null) {
+      return chain.execute(order);
+    } else {
+      return "RUNNING...";
+    }
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java
index d15df424a..7cdaab103 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/FilterManager.java
@@ -7,18 +7,18 @@ package com.iluwatar.intercepting.filter;
  *
  */
 public class FilterManager {
-	
-	private FilterChain filterChain;
 
-	public FilterManager(Target target) {
-		filterChain = new FilterChain(target);
-	}
+  private FilterChain filterChain;
 
-	public void addFilter(Filter filter) {
-		filterChain.addFilter(filter);
-	}
+  public FilterManager(Target target) {
+    filterChain = new FilterChain(target);
+  }
 
-	public String filterRequest(Order order) {
-		return filterChain.execute(order);
-	}
+  public void addFilter(Filter filter) {
+    filterChain.addFilter(filter);
+  }
+
+  public String filterRequest(Order order) {
+    return filterChain.execute(order);
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java
index 201c68bca..a458e475b 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/NameFilter.java
@@ -1,21 +1,22 @@
 package com.iluwatar.intercepting.filter;
 
 /**
- * Concrete implementation of filter. This filter checks if the input in the Name
- * field is valid. (alphanumeric)
+ * 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 order! ";
-		} else {
-			return result;
-		}
-	}
+
+  @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 order! ";
+    } else {
+      return result;
+    }
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java
index 60bf21f8e..5b30fee35 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Order.java
@@ -6,60 +6,59 @@ package com.iluwatar.intercepting.filter;
  */
 public class Order {
 
-	private String name;
-	private String contactNumber;
-	private String address;
-	private String depositNumber;
-	private String order;
-	
-	public Order() {
-	}
+  private String name;
+  private String contactNumber;
+  private String address;
+  private String depositNumber;
+  private String order;
 
-	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 Order() {}
 
-	public void setName(String name) {
-		this.name = name;
-	}
+  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 getContactNumber() {
-		return contactNumber;
-	}
+  public String getName() {
+    return name;
+  }
 
-	public void setContactNumber(String contactNumber) {
-		this.contactNumber = contactNumber;
-	}
+  public void setName(String name) {
+    this.name = name;
+  }
 
-	public String getAddress() {
-		return address;
-	}
+  public String getContactNumber() {
+    return contactNumber;
+  }
 
-	public void setAddress(String address) {
-		this.address = address;
-	}
+  public void setContactNumber(String contactNumber) {
+    this.contactNumber = contactNumber;
+  }
 
-	public String getDepositNumber() {
-		return depositNumber;
-	}
+  public String getAddress() {
+    return address;
+  }
 
-	public void setDepositNumber(String depositNumber) {
-		this.depositNumber = depositNumber;
-	}
+  public void setAddress(String address) {
+    this.address = address;
+  }
 
-	public String getOrder() {
-		return order;
-	}
+  public String getDepositNumber() {
+    return depositNumber;
+  }
 
-	public void setOrder(String order) {
-		this.order = order;
-	}
+  public void setDepositNumber(String depositNumber) {
+    this.depositNumber = depositNumber;
+  }
+
+  public String getOrder() {
+    return order;
+  }
+
+  public void setOrder(String order) {
+    this.order = order;
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java
index cdeaec6e0..724359927 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/OrderFilter.java
@@ -7,14 +7,14 @@ package com.iluwatar.intercepting.filter;
  *
  */
 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;
-		}
-	}
+
+  @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;
+    }
+  }
 }
diff --git a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java
index 6ca456512..cb96cd6e0 100644
--- a/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java
+++ b/intercepting-filter/src/main/java/com/iluwatar/intercepting/filter/Target.java
@@ -22,57 +22,57 @@ import javax.swing.table.DefaultTableModel;
  */
 public class Target extends JFrame {
 
-	private static final long serialVersionUID = 1L;
+  private static final long serialVersionUID = 1L;
 
-	private JTable jt;
-	private JScrollPane jsp;
-	private DefaultTableModel dtm;
-	private JButton del;
+  private JTable jt;
+  private JScrollPane jsp;
+  private DefaultTableModel dtm;
+  private JButton del;
 
-	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();
-	}
+  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);
+  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());
+    del.addActionListener(new DListener());
 
-		JRootPane rootPane = SwingUtilities.getRootPane(del);
-		rootPane.setDefaultButton(del);
-		setVisible(true);
-	}
+    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] });
-	}
+  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);
-			}
-		}
-	}
+  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);
+      }
+    }
+  }
 }
diff --git a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
index 9d31127a2..bcdf7c09b 100644
--- a/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
+++ b/intercepting-filter/src/test/java/com/iluwatar/intercepting/filter/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.intercepting.filter.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/App.java b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
index 955563915..2f88951f1 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/App.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/App.java
@@ -4,75 +4,66 @@ 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.
+ * 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.
+ * 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 {
 
-	/**
-	 * 
-	 * 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<>();
+  /**
+   * 
+   * 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();
-				System.out
-						.println(String.format(
-								"popped from stack left: %d right: %d",
-								leftExpression.interpret(),
-								rightExpression.interpret()));
-				Expression operator = getOperatorInstance(s, leftExpression,
-						rightExpression);
-				System.out.println(String.format("operator: %s", operator));
-				int result = operator.interpret();
-				NumberExpression resultExpression = new NumberExpression(result);
-				stack.push(resultExpression);
-				System.out.println(String.format("push result to stack: %d",
-						resultExpression.interpret()));
-			} else {
-				Expression i = new NumberExpression(s);
-				stack.push(i);
-				System.out.println(String.format("push to stack: %d",
-						i.interpret()));
-			}
-		}
-		System.out
-				.println(String.format("result: %d", stack.pop().interpret()));
-	}
+    String[] tokenList = tokenString.split(" ");
+    for (String s : tokenList) {
+      if (isOperator(s)) {
+        Expression rightExpression = stack.pop();
+        Expression leftExpression = stack.pop();
+        System.out.println(String.format("popped from stack left: %d right: %d",
+            leftExpression.interpret(), rightExpression.interpret()));
+        Expression operator = getOperatorInstance(s, leftExpression, rightExpression);
+        System.out.println(String.format("operator: %s", operator));
+        int result = operator.interpret();
+        NumberExpression resultExpression = new NumberExpression(result);
+        stack.push(resultExpression);
+        System.out.println(String.format("push result to stack: %d", resultExpression.interpret()));
+      } else {
+        Expression i = new NumberExpression(s);
+        stack.push(i);
+        System.out.println(String.format("push to stack: %d", i.interpret()));
+      }
+    }
+    System.out.println(String.format("result: %d", stack.pop().interpret()));
+  }
 
-	public static boolean isOperator(String s) {
-		return s.equals("+") || s.equals("-") || s.equals("*");
-	}
+  public static boolean isOperator(String s) {
+    return s.equals("+") || s.equals("-") || s.equals("*");
+  }
 
-	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);
-		}
-		return null;
-	}
+  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);
+    }
+    return null;
+  }
 }
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java b/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java
index e70e57f7c..635776115 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/Expression.java
@@ -7,8 +7,8 @@ package com.iluwatar.interpreter;
  */
 public abstract class Expression {
 
-	public abstract int interpret();
+  public abstract int interpret();
 
-	@Override
-	public abstract String toString();
+  @Override
+  public abstract String toString();
 }
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java
index d26f977da..d41e75b5a 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/MinusExpression.java
@@ -7,22 +7,22 @@ package com.iluwatar.interpreter;
  */
 public class MinusExpression extends Expression {
 
-	private Expression leftExpression;
-	private Expression rightExpression;
+  private Expression leftExpression;
+  private Expression rightExpression;
 
-	public MinusExpression(Expression leftExpression, Expression rightExpression) {
-		this.leftExpression = leftExpression;
-		this.rightExpression = rightExpression;
-	}
+  public MinusExpression(Expression leftExpression, Expression rightExpression) {
+    this.leftExpression = leftExpression;
+    this.rightExpression = rightExpression;
+  }
 
-	@Override
-	public int interpret() {
-		return leftExpression.interpret() - rightExpression.interpret();
-	}
+  @Override
+  public int interpret() {
+    return leftExpression.interpret() - rightExpression.interpret();
+  }
 
-	@Override
-	public String toString() {
-		return "-";
-	}
+  @Override
+  public String toString() {
+    return "-";
+  }
 
 }
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java
index 9feada7ee..af7c9f9d0 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/MultiplyExpression.java
@@ -7,23 +7,22 @@ package com.iluwatar.interpreter;
  */
 public class MultiplyExpression extends Expression {
 
-	private Expression leftExpression;
-	private Expression rightExpression;
+  private Expression leftExpression;
+  private Expression rightExpression;
 
-	public MultiplyExpression(Expression leftExpression,
-			Expression rightExpression) {
-		this.leftExpression = leftExpression;
-		this.rightExpression = rightExpression;
-	}
+  public MultiplyExpression(Expression leftExpression, Expression rightExpression) {
+    this.leftExpression = leftExpression;
+    this.rightExpression = rightExpression;
+  }
 
-	@Override
-	public int interpret() {
-		return leftExpression.interpret() * rightExpression.interpret();
-	}
+  @Override
+  public int interpret() {
+    return leftExpression.interpret() * rightExpression.interpret();
+  }
 
-	@Override
-	public String toString() {
-		return "*";
-	}
+  @Override
+  public String toString() {
+    return "*";
+  }
 
 }
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java
index 0cf6b034a..4ca4bd589 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/NumberExpression.java
@@ -7,24 +7,23 @@ package com.iluwatar.interpreter;
  */
 public class NumberExpression extends Expression {
 
-	private int number;
+  private int number;
 
-	public NumberExpression(int number) {
-		this.number = number;
-	}
+  public NumberExpression(int number) {
+    this.number = number;
+  }
 
-	public NumberExpression(String s) {
-		this.number = Integer.parseInt(s);
-	}
+  public NumberExpression(String s) {
+    this.number = Integer.parseInt(s);
+  }
 
-	@Override
-	public int interpret() {
-		return number;
-	}
-
-	@Override
-	public String toString() {
-		return "number";
-	}
+  @Override
+  public int interpret() {
+    return number;
+  }
 
+  @Override
+  public String toString() {
+    return "number";
+  }
 }
diff --git a/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java b/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java
index f244fa946..058199bb2 100644
--- a/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java
+++ b/interpreter/src/main/java/com/iluwatar/interpreter/PlusExpression.java
@@ -7,22 +7,21 @@ package com.iluwatar.interpreter;
  */
 public class PlusExpression extends Expression {
 
-	private Expression leftExpression;
-	private Expression rightExpression;
+  private Expression leftExpression;
+  private Expression rightExpression;
 
-	public PlusExpression(Expression leftExpression, Expression rightExpression) {
-		this.leftExpression = leftExpression;
-		this.rightExpression = 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 "+";
-	}
+  @Override
+  public int interpret() {
+    return leftExpression.interpret() + rightExpression.interpret();
+  }
 
+  @Override
+  public String toString() {
+    return "+";
+  }
 }
diff --git a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
index b0e486833..cb7e957c9 100644
--- a/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
+++ b/interpreter/src/test/java/com/iluwatar/interpreter/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.interpreter.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/App.java b/iterator/src/main/java/com/iluwatar/iterator/App.java
index b8ecfa42c..c9c5fa521 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/App.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/App.java
@@ -2,48 +2,48 @@ package com.iluwatar.iterator;
 
 /**
  * 
- * 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.
+ * 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.
+ * 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 {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
-		TreasureChest chest = new TreasureChest();
+  /**
+   * 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()) {
-			System.out.println(ringIterator.next());
-		}
+    ItemIterator ringIterator = chest.Iterator(ItemType.RING);
+    while (ringIterator.hasNext()) {
+      System.out.println(ringIterator.next());
+    }
 
-		System.out.println("----------");
+    System.out.println("----------");
 
-		ItemIterator potionIterator = chest.Iterator(ItemType.POTION);
-		while (potionIterator.hasNext()) {
-			System.out.println(potionIterator.next());
-		}
+    ItemIterator potionIterator = chest.Iterator(ItemType.POTION);
+    while (potionIterator.hasNext()) {
+      System.out.println(potionIterator.next());
+    }
 
-		System.out.println("----------");
+    System.out.println("----------");
 
-		ItemIterator weaponIterator = chest.Iterator(ItemType.WEAPON);
-		while (weaponIterator.hasNext()) {
-			System.out.println(weaponIterator.next());
-		}
+    ItemIterator weaponIterator = chest.Iterator(ItemType.WEAPON);
+    while (weaponIterator.hasNext()) {
+      System.out.println(weaponIterator.next());
+    }
 
-		System.out.println("----------");
+    System.out.println("----------");
 
-		ItemIterator it = chest.Iterator(ItemType.ANY);
-		while (it.hasNext()) {
-			System.out.println(it.next());
-		}
-	}
+    ItemIterator it = chest.Iterator(ItemType.ANY);
+    while (it.hasNext()) {
+      System.out.println(it.next());
+    }
+  }
 }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/Item.java b/iterator/src/main/java/com/iluwatar/iterator/Item.java
index 4df167c6f..6492fd9ab 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/Item.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/Item.java
@@ -7,24 +7,24 @@ package com.iluwatar.iterator;
  */
 public class Item {
 
-	private ItemType type;
-	private String name;
+  private ItemType type;
+  private String name;
 
-	public Item(ItemType type, String name) {
-		this.setType(type);
-		this.name = name;
-	}
+  public Item(ItemType type, String name) {
+    this.setType(type);
+    this.name = name;
+  }
 
-	@Override
-	public String toString() {
-		return name;
-	}
+  @Override
+  public String toString() {
+    return name;
+  }
 
-	public ItemType getType() {
-		return type;
-	}
+  public ItemType getType() {
+    return type;
+  }
 
-	public void setType(ItemType type) {
-		this.type = type;
-	}
+  public void setType(ItemType type) {
+    this.type = type;
+  }
 }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java b/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java
index 91b5b62c0..3798bbd74 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/ItemIterator.java
@@ -7,7 +7,7 @@ package com.iluwatar.iterator;
  */
 public interface ItemIterator {
 
-	boolean hasNext();
+  boolean hasNext();
 
-	Item next();
+  Item next();
 }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/ItemType.java b/iterator/src/main/java/com/iluwatar/iterator/ItemType.java
index 288590c31..3a51c3946 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/ItemType.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/ItemType.java
@@ -7,6 +7,6 @@ package com.iluwatar.iterator;
  */
 public enum ItemType {
 
-	ANY, WEAPON, RING, POTION
+  ANY, WEAPON, RING, POTION
 
 }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java b/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java
index f4e1337bc..02496e33c 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/TreasureChest.java
@@ -10,30 +10,30 @@ import java.util.List;
  */
 public class TreasureChest {
 
-	private List items;
+  private List items;
 
-	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"));
-	}
+  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 type) {
-		return new TreasureChestItemIterator(this, type);
-	}
+  ItemIterator Iterator(ItemType type) {
+    return new TreasureChestItemIterator(this, type);
+  }
 
-	public List getItems() {
-		ArrayList list = new ArrayList<>();
-		list.addAll(items);
-		return list;
-	}
+  public List getItems() {
+    ArrayList list = new ArrayList<>();
+    list.addAll(items);
+    return list;
+  }
 
 }
diff --git a/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java b/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java
index 1a6daef4e..39c12ab44 100644
--- a/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java
+++ b/iterator/src/main/java/com/iluwatar/iterator/TreasureChestItemIterator.java
@@ -9,46 +9,45 @@ import java.util.List;
  */
 public class TreasureChestItemIterator implements ItemIterator {
 
-	private TreasureChest chest;
-	private int idx;
-	private ItemType type;
+  private TreasureChest chest;
+  private int idx;
+  private ItemType type;
 
-	public TreasureChestItemIterator(TreasureChest chest, ItemType type) {
-		this.chest = chest;
-		this.type = type;
-		this.idx = -1;
-	}
+  public TreasureChestItemIterator(TreasureChest chest, ItemType type) {
+    this.chest = chest;
+    this.type = type;
+    this.idx = -1;
+  }
 
-	@Override
-	public boolean hasNext() {
-		return findNextIdx() != -1;
-	}
+  @Override
+  public boolean hasNext() {
+    return findNextIdx() != -1;
+  }
 
-	@Override
-	public Item next() {
-		idx = findNextIdx();
-		if (idx != -1) {
-			return chest.getItems().get(idx);
-		}
-		return null;
-	}
+  @Override
+  public Item next() {
+    idx = findNextIdx();
+    if (idx != -1) {
+      return chest.getItems().get(idx);
+    }
+    return null;
+  }
 
-	private int findNextIdx() {
+  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;
-	}
+    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;
+  }
 }
diff --git a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
index 1c1d65e34..b6198f5c5 100644
--- a/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
+++ b/iterator/src/test/java/com/iluwatar/iterator/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.iterator.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/App.java b/layers/src/main/java/com/iluwatar/layers/App.java
index bac946265..d175553f7 100644
--- a/layers/src/main/java/com/iluwatar/layers/App.java
+++ b/layers/src/main/java/com/iluwatar/layers/App.java
@@ -4,32 +4,31 @@ import java.util.Arrays;
 
 /**
  * 
- * Layers is an architectural style where software responsibilities are
- * divided among the different layers of the application.
+ * 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.
+ * 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 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
+ * 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.
+ * 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.
+ * 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
@@ -45,52 +44,55 @@ import java.util.Arrays;
  */
 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
-	 * @param cakeBakingService
-	 */
-	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));
+  private static CakeBakingService cakeBakingService = new CakeBakingServiceImpl();
 
-		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();
-		}
-	}
+  /**
+   * 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
+   * 
+   * @param cakeBakingService
+   */
+  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();
+    }
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/Cake.java b/layers/src/main/java/com/iluwatar/layers/Cake.java
index 193ba5e3f..b251576bf 100644
--- a/layers/src/main/java/com/iluwatar/layers/Cake.java
+++ b/layers/src/main/java/com/iluwatar/layers/Cake.java
@@ -19,50 +19,50 @@ import javax.persistence.OneToOne;
 @Entity
 public class Cake {
 
-	@Id
-	@GeneratedValue
-	private Long id;
+  @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<>());
-	}
+  @OneToOne(cascade = CascadeType.REMOVE)
+  private CakeTopping topping;
 
-	public Long getId() {
-		return id;
-	}
+  @OneToMany(cascade = CascadeType.REMOVE, fetch = FetchType.EAGER)
+  private Set layers;
 
-	public void setId(Long id) {
-		this.id = id;
-	}
+  public Cake() {
+    setLayers(new HashSet<>());
+  }
 
-	public CakeTopping getTopping() {
-		return topping;
-	}
+  public Long getId() {
+    return id;
+  }
 
-	public void setTopping(CakeTopping topping) {
-		this.topping = topping;
-	}
+  public void setId(Long id) {
+    this.id = id;
+  }
 
-	public Set getLayers() {
-		return layers;
-	}
+  public CakeTopping getTopping() {
+    return topping;
+  }
 
-	public 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());
-	}	
+  public void setTopping(CakeTopping topping) {
+    this.topping = topping;
+  }
+
+  public Set getLayers() {
+    return layers;
+  }
+
+  public 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());
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java
index 0a44d56f9..a61b65b81 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingException.java
@@ -6,13 +6,12 @@ package com.iluwatar.layers;
  *
  */
 public class CakeBakingException extends Exception {
-	
-	private static final long serialVersionUID = 1L;
 
-	public CakeBakingException() {
-	}
+  private static final long serialVersionUID = 1L;
 
-	public CakeBakingException(String message) {
-		super(message);
-	}
+  public CakeBakingException() {}
+
+  public CakeBakingException(String message) {
+    super(message);
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java
index fec16b494..80bd3438b 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingService.java
@@ -8,41 +8,47 @@ import java.util.List;
  *
  */
 public interface CakeBakingService {
-	
-	/**
-	 * Bakes new cake according to parameters
-	 * @param cakeInfo
-	 * @throws CakeBakingException
-	 */
-	void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException;
-	
-	/**
-	 * Get all cakes
-	 * @return
-	 */
-	List getAllCakes();
 
-	/**
-	 * Store new cake topping
-	 * @param toppingInfo
-	 */
-	void saveNewTopping(CakeToppingInfo toppingInfo);
+  /**
+   * Bakes new cake according to parameters
+   * 
+   * @param cakeInfo
+   * @throws CakeBakingException
+   */
+  void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException;
 
-	/**
-	 * Get available cake toppings
-	 * @return
-	 */
-	List getAvailableToppings();
-	
-	/**
-	 * Add new cake layer
-	 * @param layerInfo
-	 */
-	void saveNewLayer(CakeLayerInfo layerInfo);
-	
-	/**
-	 * Get available cake layers
-	 * @return
-	 */
-	List getAvailableLayers();
+  /**
+   * Get all cakes
+   * 
+   * @return
+   */
+  List getAllCakes();
+
+  /**
+   * Store new cake topping
+   * 
+   * @param toppingInfo
+   */
+  void saveNewTopping(CakeToppingInfo toppingInfo);
+
+  /**
+   * Get available cake toppings
+   * 
+   * @return
+   */
+  List getAvailableToppings();
+
+  /**
+   * Add new cake layer
+   * 
+   * @param layerInfo
+   */
+  void saveNewLayer(CakeLayerInfo layerInfo);
+
+  /**
+   * Get available cake layers
+   * 
+   * @return
+   */
+  List getAvailableLayers();
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java
index 7e5e3dcff..a519ec2ce 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeBakingServiceImpl.java
@@ -22,128 +22,132 @@ import org.springframework.transaction.annotation.Transactional;
 @Transactional
 public class CakeBakingServiceImpl implements CakeBakingService {
 
-	private AbstractApplicationContext context;
+  private AbstractApplicationContext context;
 
-	public CakeBakingServiceImpl() {
-		this.context = new ClassPathXmlApplicationContext("applicationContext.xml");
-	}
-	
-	@Override
-	public void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException {
-		List allToppings = getAvailableToppings();
-		List matchingToppings = allToppings.stream()
-				.filter((t) -> t.name.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().id.get());
-		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);
-		}
-	}
+  public CakeBakingServiceImpl() {
+    this.context = new ClassPathXmlApplicationContext("applicationContext.xml");
+  }
 
-	@Override
-	public void saveNewTopping(CakeToppingInfo toppingInfo) {
-		CakeToppingDao bean = context.getBean(CakeToppingDao.class);
-		bean.save(new CakeTopping(toppingInfo.name, toppingInfo.calories));
-	}
+  @Override
+  public void bakeNewCake(CakeInfo cakeInfo) throws CakeBakingException {
+    List allToppings = getAvailableToppings();
+    List matchingToppings =
+        allToppings.stream().filter((t) -> t.name.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().id.get());
+    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 saveNewLayer(CakeLayerInfo layerInfo) {
-		CakeLayerDao bean = context.getBean(CakeLayerDao.class);
-		bean.save(new CakeLayer(layerInfo.name, layerInfo.calories));
-	}
+  @Override
+  public void saveNewTopping(CakeToppingInfo toppingInfo) {
+    CakeToppingDao bean = context.getBean(CakeToppingDao.class);
+    bean.save(new CakeTopping(toppingInfo.name, toppingInfo.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;
-	}
+  @Override
+  public void saveNewLayer(CakeLayerInfo layerInfo) {
+    CakeLayerDao bean = context.getBean(CakeLayerDao.class);
+    bean.save(new CakeLayer(layerInfo.name, layerInfo.calories));
+  }
 
-	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;
-	}
+  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 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());
-			ArrayList 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;
-	}
+  @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());
+      ArrayList 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;
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java
index 335ce5f4f..f60ee9a14 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeInfo.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeInfo.java
@@ -10,31 +10,31 @@ import java.util.Optional;
  */
 public class CakeInfo {
 
-	public final Optional id;
-	public final CakeToppingInfo cakeToppingInfo;
-	public final List cakeLayerInfos;
+  public final Optional id;
+  public final CakeToppingInfo cakeToppingInfo;
+  public final List cakeLayerInfos;
 
-	public CakeInfo(Long id, CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) {
-		this.id = Optional.of(id);
-		this.cakeToppingInfo = cakeToppingInfo;
-		this.cakeLayerInfos = cakeLayerInfos;
-	}
-	
-	public CakeInfo(CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) {
-		this.id = Optional.empty();
-		this.cakeToppingInfo = cakeToppingInfo;
-		this.cakeLayerInfos = cakeLayerInfos;
-	}
-	
-	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.get(), cakeToppingInfo,
-				cakeLayerInfos, calculateTotalCalories());
-	}
+  public CakeInfo(Long id, CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) {
+    this.id = Optional.of(id);
+    this.cakeToppingInfo = cakeToppingInfo;
+    this.cakeLayerInfos = cakeLayerInfos;
+  }
+
+  public CakeInfo(CakeToppingInfo cakeToppingInfo, List cakeLayerInfos) {
+    this.id = Optional.empty();
+    this.cakeToppingInfo = cakeToppingInfo;
+    this.cakeLayerInfos = cakeLayerInfos;
+  }
+
+  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.get(),
+        cakeToppingInfo, cakeLayerInfos, calculateTotalCalories());
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java
index 2f8649c18..7cbb55e28 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeLayer.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeLayer.java
@@ -14,59 +14,58 @@ import javax.persistence.ManyToOne;
 @Entity
 public class CakeLayer {
 
-	@Id
-	@GeneratedValue
-	private Long id;
+  @Id
+  @GeneratedValue
+  private Long id;
 
-	private String name;
+  private String name;
 
-	private int calories;
-	
-	@ManyToOne(cascade = CascadeType.ALL)
-	private Cake cake;
+  private int calories;
 
-	public CakeLayer() {
-	}
+  @ManyToOne(cascade = CascadeType.ALL)
+  private Cake cake;
 
-	public CakeLayer(String name, int calories) {
-		this.setName(name);
-		this.setCalories(calories);
-	}
+  public CakeLayer() {}
 
-	public Long getId() {
-		return id;
-	}
+  public CakeLayer(String name, int calories) {
+    this.setName(name);
+    this.setCalories(calories);
+  }
 
-	public void setId(Long id) {
-		this.id = id;
-	}
+  public Long getId() {
+    return id;
+  }
 
-	public String getName() {
-		return name;
-	}
+  public void setId(Long id) {
+    this.id = id;
+  }
 
-	public void setName(String name) {
-		this.name = name;
-	}
+  public String getName() {
+    return name;
+  }
 
-	public int getCalories() {
-		return calories;
-	}
+  public void setName(String name) {
+    this.name = name;
+  }
 
-	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 int getCalories() {
+    return calories;
+  }
 
-	public Cake getCake() {
-		return cake;
-	}
+  public void setCalories(int calories) {
+    this.calories = calories;
+  }
 
-	public void setCake(Cake cake) {
-		this.cake = cake;
-	}
+  @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;
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java
index 9aa7ff7f6..3dff379da 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeLayerInfo.java
@@ -9,24 +9,24 @@ import java.util.Optional;
  */
 public class CakeLayerInfo {
 
-	public final Optional id;
-	public final String name;
-	public final int calories;
+  public final Optional id;
+  public final String name;
+  public final int calories;
 
-	public CakeLayerInfo(Long id, String name, int calories) {
-		this.id = Optional.of(id);
-		this.name = name;
-		this.calories = calories;
-	}
-	
-	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.get(), name, calories);
-	}
+  public CakeLayerInfo(Long id, String name, int calories) {
+    this.id = Optional.of(id);
+    this.name = name;
+    this.calories = calories;
+  }
+
+  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.get(), name, calories);
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java
index f0e30997a..6dc9c45fc 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeTopping.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeTopping.java
@@ -14,59 +14,58 @@ import javax.persistence.OneToOne;
 @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);
-	}
+  @Id
+  @GeneratedValue
+  private Long id;
 
-	public Long getId() {
-		return id;
-	}
+  private String name;
 
-	public void setId(Long id) {
-		this.id = id;
-	}
+  private int calories;
 
-	public String getName() {
-		return name;
-	}
+  @OneToOne(cascade = CascadeType.ALL)
+  private Cake cake;
 
-	public void setName(String name) {
-		this.name = name;
-	}
+  public CakeTopping() {}
 
-	public int getCalories() {
-		return calories;
-	}
+  public CakeTopping(String name, int calories) {
+    this.setName(name);
+    this.setCalories(calories);
+  }
 
-	public void setCalories(int calories) {
-		this.calories = calories;
-	}
-	
-	@Override
-	public String toString() {
-		return String.format("id=%s name=%s calories=%d", name, calories);
-	}
+  public Long getId() {
+    return id;
+  }
 
-	public Cake getCake() {
-		return cake;
-	}
+  public void setId(Long id) {
+    this.id = id;
+  }
 
-	public void setCake(Cake cake) {
-		this.cake = cake;
-	}
+  public String getName() {
+    return name;
+  }
+
+  public void setName(String name) {
+    this.name = name;
+  }
+
+  public 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", name, calories);
+  }
+
+  public Cake getCake() {
+    return cake;
+  }
+
+  public void setCake(Cake cake) {
+    this.cake = cake;
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java
index 152b0ff85..4e432ec44 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeToppingInfo.java
@@ -9,24 +9,24 @@ import java.util.Optional;
  */
 public class CakeToppingInfo {
 
-	public final Optional id;
-	public final String name;
-	public final int calories;
+  public final Optional id;
+  public final String name;
+  public final int calories;
 
-	public CakeToppingInfo(Long id, String name, int calories) {
-		this.id = Optional.of(id);
-		this.name = name;
-		this.calories = calories;
-	}
-	
-	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.get(), name, calories);
-	}
+  public CakeToppingInfo(Long id, String name, int calories) {
+    this.id = Optional.of(id);
+    this.name = name;
+    this.calories = calories;
+  }
+
+  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.get(), name, calories);
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java b/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java
index 5fed15c3a..3a465b2b6 100644
--- a/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java
+++ b/layers/src/main/java/com/iluwatar/layers/CakeViewImpl.java
@@ -7,13 +7,13 @@ package com.iluwatar.layers;
  */
 public class CakeViewImpl implements View {
 
-	private CakeBakingService cakeBakingService;
+  private CakeBakingService cakeBakingService;
 
-	public CakeViewImpl(CakeBakingService cakeBakingService) {
-		this.cakeBakingService = cakeBakingService;
-	}
-	
-	public void render() {
-		cakeBakingService.getAllCakes().stream().forEach((cake) -> System.out.println(cake));
-	}
+  public CakeViewImpl(CakeBakingService cakeBakingService) {
+    this.cakeBakingService = cakeBakingService;
+  }
+
+  public void render() {
+    cakeBakingService.getAllCakes().stream().forEach((cake) -> System.out.println(cake));
+  }
 }
diff --git a/layers/src/main/java/com/iluwatar/layers/View.java b/layers/src/main/java/com/iluwatar/layers/View.java
index 123d4ecbf..be2187e4d 100644
--- a/layers/src/main/java/com/iluwatar/layers/View.java
+++ b/layers/src/main/java/com/iluwatar/layers/View.java
@@ -7,6 +7,6 @@ package com.iluwatar.layers;
  */
 public interface View {
 
-	void render();
-	
+  void render();
+
 }
diff --git a/layers/src/test/java/com/iluwatar/layers/AppTest.java b/layers/src/test/java/com/iluwatar/layers/AppTest.java
index e55ab4f84..7db3f6ecd 100644
--- a/layers/src/test/java/com/iluwatar/layers/AppTest.java
+++ b/layers/src/test/java/com/iluwatar/layers/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.layers.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
index db09c781b..14708f0e9 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/App.java
@@ -4,34 +4,33 @@ package com.iluwatar.lazy.loading;
  * 
  * Lazy loading idiom defers object creation until needed.
  * 
    
- * This example shows different implementations of the pattern
- * with increasing sophistication.
+ * 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 
-{
-	/**
-	 * 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();
-    	System.out.println("heavy=" + heavy);
-    	
-    	// Thread safe lazy loader, but with heavy synchronization on each access
-    	HolderThreadSafe holderThreadSafe = new HolderThreadSafe();
-    	Heavy another = holderThreadSafe.getHeavy();
-    	System.out.println("another=" + another);
-    	
-    	// The most efficient lazy loader utilizing Java 8 features
-    	Java8Holder java8Holder = new Java8Holder();
-    	Heavy next = java8Holder.getHeavy();
-    	System.out.println("next=" + next);
-    }
+public class App {
+  /**
+   * 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();
+    System.out.println("heavy=" + heavy);
+
+    // Thread safe lazy loader, but with heavy synchronization on each access
+    HolderThreadSafe holderThreadSafe = new HolderThreadSafe();
+    Heavy another = holderThreadSafe.getHeavy();
+    System.out.println("another=" + another);
+
+    // The most efficient lazy loader utilizing Java 8 features
+    Java8Holder java8Holder = new Java8Holder();
+    Heavy next = java8Holder.getHeavy();
+    System.out.println("next=" + next);
+  }
 }
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
index c2715434f..25e46d8b9 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Heavy.java
@@ -7,13 +7,13 @@ package com.iluwatar.lazy.loading;
  */
 public class Heavy {
 
-	public Heavy() {
-		System.out.println("Creating Heavy ...");
-		try {
-			Thread.sleep(1000);
-		} catch (InterruptedException e) {
-			e.printStackTrace();
-		}
-		System.out.println("... Heavy created");
-	}
+  public Heavy() {
+    System.out.println("Creating Heavy ...");
+    try {
+      Thread.sleep(1000);
+    } catch (InterruptedException e) {
+      e.printStackTrace();
+    }
+    System.out.println("... Heavy created");
+  }
 }
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
index 1421d4b23..132ebaa5f 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderNaive.java
@@ -2,22 +2,21 @@ package com.iluwatar.lazy.loading;
 
 /**
  * 
- * Simple implementation of the lazy loading idiom.
- * However, this is not thread safe.
+ * Simple implementation of the lazy loading idiom. However, this is not thread safe.
  *
  */
 public class HolderNaive {
-	
-	private Heavy heavy;
-	
-	public HolderNaive() {
-		System.out.println("HolderNaive created");
-	}
 
-	public Heavy getHeavy() {
-		if (heavy == null) {
-			heavy = new Heavy();
-		}
-		return heavy;
-	}
+  private Heavy heavy;
+
+  public HolderNaive() {
+    System.out.println("HolderNaive created");
+  }
+
+  public Heavy getHeavy() {
+    if (heavy == null) {
+      heavy = new Heavy();
+    }
+    return heavy;
+  }
 }
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
index cc039d9f0..d2b15a3af 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/HolderThreadSafe.java
@@ -2,23 +2,22 @@ package com.iluwatar.lazy.loading;
 
 /**
  * 
- * Same as HolderNaive but with added synchronization.
- * This implementation is thread safe, but each {@link #getHeavy()}
- * call costs additional synchronization overhead.
+ * 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 Heavy heavy;
-	
-	public HolderThreadSafe() {
-		System.out.println("HolderThreadSafe created");
-	}
 
-	public synchronized Heavy getHeavy() {
-		if (heavy == null) {
-			heavy = new Heavy();
-		}
-		return heavy;
-	}
+  private Heavy heavy;
+
+  public HolderThreadSafe() {
+    System.out.println("HolderThreadSafe created");
+  }
+
+  public synchronized Heavy getHeavy() {
+    if (heavy == null) {
+      heavy = new Heavy();
+    }
+    return heavy;
+  }
 }
diff --git a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
index a03aae352..da021e014 100644
--- a/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
+++ b/lazy-loading/src/main/java/com/iluwatar/lazy/loading/Java8Holder.java
@@ -4,31 +4,34 @@ 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.
+ * 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 Supplier heavy = () -> createAndCacheHeavy();
-	
-	public Java8Holder() {
-		System.out.println("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();
-	}
+  private Supplier heavy = () -> createAndCacheHeavy();
+
+  public Java8Holder() {
+    System.out.println("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();
+  }
 }
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
index 0ef7e8ae2..591b1282d 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.lazy.loading.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
index f27ffc6a9..d827f186b 100644
--- a/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
+++ b/lazy-loading/src/test/java/com/iluwatar/lazy/loading/HolderThreadSafeTest.java
@@ -8,35 +8,38 @@ import static org.junit.Assert.assertNotNull;
 import static org.junit.Assert.assertNull;
 
 /**
- * Using reflection this test shows that the heavy field is not instantiated until the method getHeavy is called
+ * Using reflection this test shows that the heavy field is not instantiated until the method
+ * getHeavy is called
  *
  * Created by jones on 11/10/2015.
  */
 public class HolderThreadSafeTest {
 
-    @Test
-    public void test() throws IllegalAccessException {
-        HolderThreadSafe hts = new HolderThreadSafe();
+  @Test
+  public void test() throws IllegalAccessException {
+    HolderThreadSafe hts = new HolderThreadSafe();
 
-        {//first call is null
-            Field[] ff = HolderThreadSafe.class.getDeclaredFields();
-            for (Field f: ff) {
-                f.setAccessible(true);
-            }
+    {
+      // first call is null
+      Field[] ff = HolderThreadSafe.class.getDeclaredFields();
+      for (Field f : ff) {
+        f.setAccessible(true);
+      }
 
-            assertNull(ff[0].get(hts));
-        }
-
-        // now it is lazily loaded
-        hts.getHeavy();
-
-        {//now it is not null - call via reflection so that the test is the same before and after
-            Field[] ff = HolderThreadSafe.class.getDeclaredFields();
-            for (Field f: ff) {
-                f.setAccessible(true);
-            }
-
-            assertNotNull(ff[0].get(hts));
-        }
+      assertNull(ff[0].get(hts));
     }
+
+    // now it is lazily loaded
+    hts.getHeavy();
+
+    {
+      // now it is not null - call via reflection so that the test is the same before and after
+      Field[] ff = HolderThreadSafe.class.getDeclaredFields();
+      for (Field f : ff) {
+        f.setAccessible(true);
+      }
+
+      assertNotNull(ff[0].get(hts));
+    }
+  }
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Action.java b/mediator/src/main/java/com/iluwatar/mediator/Action.java
index a5b466342..d264f7297 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Action.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Action.java
@@ -7,25 +7,23 @@ package com.iluwatar.mediator;
  */
 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("", "");
+  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;
+  private String title;
+  private String description;
 
-    Action(String title, String description) {
-        this.title = title;
-        this.description = description;
-    }
+  Action(String title, String description) {
+    this.title = title;
+    this.description = description;
+  }
 
-    public String getDescription() {
-        return description;
-    }
+  public String getDescription() {
+    return description;
+  }
 
-    public String toString() {
-		return title;
-	}
+  public String toString() {
+    return title;
+  }
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/App.java b/mediator/src/main/java/com/iluwatar/mediator/App.java
index 9648ac608..0af9a8717 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/App.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/App.java
@@ -2,54 +2,53 @@ 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.
+ * 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.
+ * 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.
+ * 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.
+ * 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();
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
 
-		// add party members
-		party.addMember(hobbit);
-		party.addMember(wizard);
-		party.addMember(rogue);
-		party.addMember(hunter);
+    // create party and members
+    Party party = new PartyImpl();
+    Hobbit hobbit = new Hobbit();
+    Wizard wizard = new Wizard();
+    Rogue rogue = new Rogue();
+    Hunter hunter = new 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);
-	}
+    // 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);
+  }
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java b/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java
index 5981a34a8..3d1bf83bf 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Hobbit.java
@@ -7,9 +7,9 @@ package com.iluwatar.mediator;
  */
 public class Hobbit extends PartyMemberBase {
 
-	@Override
-	public String toString() {
-		return "Hobbit";
-	}
+  @Override
+  public String toString() {
+    return "Hobbit";
+  }
 
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Hunter.java b/mediator/src/main/java/com/iluwatar/mediator/Hunter.java
index 1487c836e..d6abf3416 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Hunter.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Hunter.java
@@ -7,9 +7,8 @@ package com.iluwatar.mediator;
  */
 public class Hunter extends PartyMemberBase {
 
-	@Override
-	public String toString() {
-		return "Hunter";
-	}
-
+  @Override
+  public String toString() {
+    return "Hunter";
+  }
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Party.java b/mediator/src/main/java/com/iluwatar/mediator/Party.java
index 9328cdaa2..cb53dae27 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Party.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Party.java
@@ -7,8 +7,8 @@ package com.iluwatar.mediator;
  */
 public interface Party {
 
-	void addMember(PartyMember member);
+  void addMember(PartyMember member);
 
-	void act(PartyMember actor, Action action);
+  void act(PartyMember actor, Action action);
 
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java b/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java
index 5548f5163..acc70a0e6 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyImpl.java
@@ -10,24 +10,24 @@ import java.util.List;
  */
 public class PartyImpl implements Party {
 
-	private final List members;
+  private final List members;
 
-	public PartyImpl() {
-		members = new ArrayList<>();
-	}
+  public PartyImpl() {
+    members = new ArrayList<>();
+  }
 
-	@Override
-	public void act(PartyMember actor, Action action) {
-		for (PartyMember member : members) {
-			if (member != actor) {
-				member.partyAction(action);
-			}
-		}
-	}
+  @Override
+  public void act(PartyMember actor, Action action) {
+    for (PartyMember member : members) {
+      if (member != actor) {
+        member.partyAction(action);
+      }
+    }
+  }
 
-	@Override
-	public void addMember(PartyMember member) {
-		members.add(member);
-		member.joinedParty(this);
-	}
+  @Override
+  public void addMember(PartyMember member) {
+    members.add(member);
+    member.joinedParty(this);
+  }
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java b/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java
index fffe6dd39..0ee078070 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyMember.java
@@ -7,9 +7,9 @@ package com.iluwatar.mediator;
  */
 public interface PartyMember {
 
-	void joinedParty(Party party);
+  void joinedParty(Party party);
 
-	void partyAction(Action action);
+  void partyAction(Action action);
 
-	void act(Action action);
+  void act(Action action);
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java b/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
index 7a151c355..1f58d3147 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/PartyMemberBase.java
@@ -7,28 +7,28 @@ package com.iluwatar.mediator;
  */
 public abstract class PartyMemberBase implements PartyMember {
 
-	protected Party party;
+  protected Party party;
 
-	@Override
-	public void joinedParty(Party party) {
-		System.out.println(this + " joins the party");
-		this.party = party;
-	}
+  @Override
+  public void joinedParty(Party party) {
+    System.out.println(this + " joins the party");
+    this.party = party;
+  }
 
-	@Override
-	public void partyAction(Action action) {
-		System.out.println(this + " " + action.getDescription());
-	}
+  @Override
+  public void partyAction(Action action) {
+    System.out.println(this + " " + action.getDescription());
+  }
 
-	@Override
-	public void act(Action action) {
-		if (party != null) {
-			System.out.println(this + " " + action.toString());
-			party.act(this, action);
-		}
-	}
+  @Override
+  public void act(Action action) {
+    if (party != null) {
+      System.out.println(this + " " + action.toString());
+      party.act(this, action);
+    }
+  }
 
-	@Override
-	public abstract String toString();
+  @Override
+  public abstract String toString();
 
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Rogue.java b/mediator/src/main/java/com/iluwatar/mediator/Rogue.java
index 69974066f..f7b005c94 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Rogue.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Rogue.java
@@ -7,9 +7,9 @@ package com.iluwatar.mediator;
  */
 public class Rogue extends PartyMemberBase {
 
-	@Override
-	public String toString() {
-		return "Rogue";
-	}
+  @Override
+  public String toString() {
+    return "Rogue";
+  }
 
 }
diff --git a/mediator/src/main/java/com/iluwatar/mediator/Wizard.java b/mediator/src/main/java/com/iluwatar/mediator/Wizard.java
index d4d2594d7..3fdc73aa6 100644
--- a/mediator/src/main/java/com/iluwatar/mediator/Wizard.java
+++ b/mediator/src/main/java/com/iluwatar/mediator/Wizard.java
@@ -7,9 +7,9 @@ package com.iluwatar.mediator;
  */
 public class Wizard extends PartyMemberBase {
 
-	@Override
-	public String toString() {
-		return "Wizard";
-	}
+  @Override
+  public String toString() {
+    return "Wizard";
+  }
 
 }
diff --git a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
index 2b614b003..4b3269244 100644
--- a/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
+++ b/mediator/src/test/java/com/iluwatar/mediator/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.mediator.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/memento/src/main/java/com/iluwatar/memento/App.java b/memento/src/main/java/com/iluwatar/memento/App.java
index 71d0ed466..c99894680 100644
--- a/memento/src/main/java/com/iluwatar/memento/App.java
+++ b/memento/src/main/java/com/iluwatar/memento/App.java
@@ -4,46 +4,45 @@ 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 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.
+ * 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.
+ * 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 {
 
-	public static void main(String[] args) {
-		Stack states = new Stack<>();
+  public static void main(String[] args) {
+    Stack states = new Stack<>();
 
-		Star star = new Star(StarType.SUN, 10000000, 500000);
-		System.out.println(star);
-		states.add(star.getMemento());
-		star.timePasses();
-		System.out.println(star);
-		states.add(star.getMemento());
-		star.timePasses();
-		System.out.println(star);
-		states.add(star.getMemento());
-		star.timePasses();
-		System.out.println(star);
-		states.add(star.getMemento());
-		star.timePasses();
-		System.out.println(star);
-		while (states.size() > 0) {
-			star.setMemento(states.pop());
-			System.out.println(star);
-		}
-	}
+    Star star = new Star(StarType.SUN, 10000000, 500000);
+    System.out.println(star);
+    states.add(star.getMemento());
+    star.timePasses();
+    System.out.println(star);
+    states.add(star.getMemento());
+    star.timePasses();
+    System.out.println(star);
+    states.add(star.getMemento());
+    star.timePasses();
+    System.out.println(star);
+    states.add(star.getMemento());
+    star.timePasses();
+    System.out.println(star);
+    while (states.size() > 0) {
+      star.setMemento(states.pop());
+      System.out.println(star);
+    }
+  }
 }
diff --git a/memento/src/main/java/com/iluwatar/memento/Star.java b/memento/src/main/java/com/iluwatar/memento/Star.java
index 43b5c5c3c..b4ec1c669 100644
--- a/memento/src/main/java/com/iluwatar/memento/Star.java
+++ b/memento/src/main/java/com/iluwatar/memento/Star.java
@@ -7,99 +7,98 @@ package com.iluwatar.memento;
  */
 public class Star {
 
-	private StarType type;
-	private int ageYears;
-	private int massTons;
+  private StarType type;
+  private int ageYears;
+  private int massTons;
 
-	public Star(StarType startType, int startAge, int startMass) {
-		this.type = startType;
-		this.ageYears = startAge;
-		this.massTons = startMass;
-	}
+  public Star(StarType startType, int startAge, int startMass) {
+    this.type = startType;
+    this.ageYears = startAge;
+    this.massTons = startMass;
+  }
 
-	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;
-		}
-	}
+  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() {
+  StarMemento getMemento() {
 
-		StarMementoInternal state = new StarMementoInternal();
-		state.setAgeYears(ageYears);
-		state.setMassTons(massTons);
-		state.setType(type);
-		return state;
+    StarMementoInternal state = new StarMementoInternal();
+    state.setAgeYears(ageYears);
+    state.setMassTons(massTons);
+    state.setType(type);
+    return state;
 
-	}
+  }
 
-	void setMemento(StarMemento memento) {
+  void setMemento(StarMemento memento) {
 
-		StarMementoInternal state = (StarMementoInternal) memento;
-		this.type = state.getType();
-		this.ageYears = state.getAgeYears();
-		this.massTons = state.getMassTons();
+    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 {
+  @Override
+  public String toString() {
+    return String.format("%s age: %d years mass: %d tons", type.toString(), ageYears, massTons);
+  }
 
-		private StarType type;
-		private int ageYears;
-		private int massTons;
+  /**
+   * 
+   * StarMemento implementation
+   * 
+   */
+  private static class StarMementoInternal implements StarMemento {
 
-		public StarType getType() {
-			return type;
-		}
+    private StarType type;
+    private int ageYears;
+    private int massTons;
 
-		public void setType(StarType type) {
-			this.type = type;
-		}
+    public StarType getType() {
+      return type;
+    }
 
-		public int getAgeYears() {
-			return ageYears;
-		}
+    public void setType(StarType type) {
+      this.type = type;
+    }
 
-		public void setAgeYears(int ageYears) {
-			this.ageYears = ageYears;
-		}
+    public int getAgeYears() {
+      return ageYears;
+    }
 
-		public int getMassTons() {
-			return massTons;
-		}
+    public void setAgeYears(int ageYears) {
+      this.ageYears = ageYears;
+    }
 
-		public void setMassTons(int massTons) {
-			this.massTons = massTons;
-		}
-	}
+    public int getMassTons() {
+      return massTons;
+    }
+
+    public void setMassTons(int massTons) {
+      this.massTons = massTons;
+    }
+  }
 }
diff --git a/memento/src/main/java/com/iluwatar/memento/StarType.java b/memento/src/main/java/com/iluwatar/memento/StarType.java
index bae853097..13e84d00f 100644
--- a/memento/src/main/java/com/iluwatar/memento/StarType.java
+++ b/memento/src/main/java/com/iluwatar/memento/StarType.java
@@ -7,16 +7,17 @@ package com.iluwatar.memento;
  */
 public enum StarType {
 
-	SUN("sun"), RED_GIANT("red giant"), WHITE_DWARF("white dwarf"), SUPERNOVA("supernova"), DEAD("dead star"), UNDEFINED("");
+  SUN("sun"), RED_GIANT("red giant"), WHITE_DWARF("white dwarf"), SUPERNOVA("supernova"), DEAD(
+      "dead star"), UNDEFINED("");
 
-    private String title;
+  private String title;
 
-    StarType(String title) {
-        this.title = title;
-    }
+  StarType(String title) {
+    this.title = title;
+  }
 
-    @Override
-	public String toString() {
-		return title;
-	}
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/memento/src/test/java/com/iluwatar/memento/AppTest.java b/memento/src/test/java/com/iluwatar/memento/AppTest.java
index 84afd5945..4eda4a6f9 100644
--- a/memento/src/test/java/com/iluwatar/memento/AppTest.java
+++ b/memento/src/test/java/com/iluwatar/memento/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.memento.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/message-channel/src/main/java/com/iluwatar/message/channel/App.java b/message-channel/src/main/java/com/iluwatar/message/channel/App.java
index f9a334a8a..a41dd74dc 100644
--- a/message-channel/src/main/java/com/iluwatar/message/channel/App.java
+++ b/message-channel/src/main/java/com/iluwatar/message/channel/App.java
@@ -6,48 +6,48 @@ import org.apache.camel.impl.DefaultCamelContext;
 
 /**
  * 
- * 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.
+ * 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.
+ * 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.
+ * 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 {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 * @throws Exception
-	 */
-	public static void main(String[] args) throws Exception {
-		CamelContext context = new DefaultCamelContext();
-		
-		context.addRoutes(new RouteBuilder() {
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   * @throws Exception
+   */
+  public static void main(String[] args) throws Exception {
+    CamelContext context = new DefaultCamelContext();
 
-			@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) -> System.out.println(r));
-		context.stop();
-	}
+    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) -> System.out.println(r));
+    context.stop();
+  }
 }
diff --git a/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java b/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java
index fa3af1161..d36fff43f 100644
--- a/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java
+++ b/message-channel/src/test/java/com/iluwatar/message/channel/AppTest.java
@@ -8,10 +8,10 @@ import org.junit.Test;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() throws Exception {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() throws Exception {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java
index 0ba34b5d4..097ea3932 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/App.java
@@ -5,34 +5,37 @@ 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.
+ * 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.
+ * 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();
-    }
+
+  /**
+   * 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();
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java
index d19df6a8c..d4a60ba93 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Fatigue.java
@@ -7,16 +7,16 @@ package com.iluwatar.model.view.controller;
  */
 public enum Fatigue {
 
-	ALERT("alert"), TIRED("tired"), SLEEPING("sleeping");
-	
-	private String title;
-	
-	Fatigue(String title) {
-		this.title = title;
-	}
+  ALERT("alert"), TIRED("tired"), SLEEPING("sleeping");
 
-	@Override
-	public String toString() {
-		return title;
-	}	
+  private String title;
+
+  Fatigue(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java
index acda727d9..42dcaf539 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantController.java
@@ -7,39 +7,39 @@ package com.iluwatar.model.view.controller;
  */
 public class GiantController {
 
-	private GiantModel giant;
-	private GiantView view;
+  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 GiantController(GiantModel giant, GiantView view) {
+    this.giant = giant;
+    this.view = view;
+  }
 
-	public void setHealth(Health health) {
-		this.giant.setHealth(health);
-	}
+  public Health getHealth() {
+    return giant.getHealth();
+  }
 
-	public Fatigue getFatigue() {
-		return giant.getFatigue();
-	}
+  public void setHealth(Health health) {
+    this.giant.setHealth(health);
+  }
 
-	public void setFatigue(Fatigue fatigue) {
-		this.giant.setFatigue(fatigue);
-	}
+  public Fatigue getFatigue() {
+    return giant.getFatigue();
+  }
 
-	public Nourishment getNourishment() {
-		return giant.getNourishment();
-	}
+  public void setFatigue(Fatigue fatigue) {
+    this.giant.setFatigue(fatigue);
+  }
 
-	public void setNourishment(Nourishment nourishment) {
-		this.giant.setNourishment(nourishment);
-	}
-	
-	public void updateView() {
-		this.view.displayGiant(giant);
-	}
+  public Nourishment getNourishment() {
+    return giant.getNourishment();
+  }
+
+  public void setNourishment(Nourishment nourishment) {
+    this.giant.setNourishment(nourishment);
+  }
+
+  public void updateView() {
+    this.view.displayGiant(giant);
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java
index 97c298768..2ecbe8b1f 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantModel.java
@@ -6,43 +6,43 @@ package com.iluwatar.model.view.controller;
  *
  */
 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;	
-	}
+  private Health health;
+  private Fatigue fatigue;
+  private Nourishment nourishment;
 
-	public Health getHealth() {
-		return health;
-	}
+  GiantModel(Health health, Fatigue fatigue, Nourishment nourishment) {
+    this.health = health;
+    this.fatigue = fatigue;
+    this.nourishment = nourishment;
+  }
 
-	public void setHealth(Health health) {
-		this.health = health;
-	}
+  public Health getHealth() {
+    return health;
+  }
 
-	public Fatigue getFatigue() {
-		return fatigue;
-	}
+  public void setHealth(Health health) {
+    this.health = health;
+  }
 
-	public void setFatigue(Fatigue fatigue) {
-		this.fatigue = fatigue;
-	}
+  public Fatigue getFatigue() {
+    return fatigue;
+  }
 
-	public Nourishment getNourishment() {
-		return nourishment;
-	}
+  public void setFatigue(Fatigue fatigue) {
+    this.fatigue = fatigue;
+  }
 
-	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);
-	}
+  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);
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
index 1cf5e20a6..5b2c8e840 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/GiantView.java
@@ -7,7 +7,7 @@ package com.iluwatar.model.view.controller;
  */
 public class GiantView {
 
-	public void displayGiant(GiantModel giant) {
-		System.out.println(giant);
-	}
+  public void displayGiant(GiantModel giant) {
+    System.out.println(giant);
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java
index feaec81d7..9bde455dd 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Health.java
@@ -6,17 +6,17 @@ package com.iluwatar.model.view.controller;
  *
  */
 public enum Health {
-	
-	HEALTHY("healthy"), WOUNDED("wounded"), DEAD("dead");
-	
-	private String title;
-	
-	Health(String title) {
-		this.title = title;
-	}
 
-	@Override
-	public String toString() {
-		return title;
-	}
+  HEALTHY("healthy"), WOUNDED("wounded"), DEAD("dead");
+
+  private String title;
+
+  Health(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java
index 7bab931b6..c3e043906 100644
--- a/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java
+++ b/model-view-controller/src/main/java/com/iluwatar/model/view/controller/Nourishment.java
@@ -7,16 +7,16 @@ package com.iluwatar.model.view.controller;
  */
 public enum Nourishment {
 
-	SATURATED("saturated"), HUNGRY("hungry"), STARVING("starving");
-	
-	private String title;
-	
-	Nourishment(String title) {
-		this.title = title;
-	}
+  SATURATED("saturated"), HUNGRY("hungry"), STARVING("starving");
 
-	@Override
-	public String toString() {
-		return title;
-	}	
+  private String title;
+
+  Nourishment(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
index 4bb31f6e6..7142c2979 100644
--- a/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
+++ b/model-view-controller/src/test/java/com/iluwatar/model/view/controller/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.model.view.controller.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java
index ac6ccf091..2dc3f4d51 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/App.java
@@ -2,30 +2,31 @@ 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).
+ * 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.
+ * 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.
+ * 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();
-	}
+  /**
+   * 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();
+  }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java
index 96d843f83..d04f284ac 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileLoader.java
@@ -5,76 +5,76 @@ import java.io.File;
 import java.io.FileReader;
 
 /**
- * Every instance of this class represents the Model component in the
- * Model-View-Presenter architectural pattern.
+ * 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 = false;
+  /**
+   * Indicates if the file is loaded or not.
+   */
+  private boolean loaded = false;
 
-	/**
-	 * The name of the file that we want to load.
-	 */
-	private String fileName;
+  /**
+   * 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;
+  /**
+   * 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');
-			}
+      while ((line = br.readLine()) != null) {
+        sb.append(line).append('\n');
+      }
 
-			this.loaded = true;
-			br.close();
+      this.loaded = true;
+      br.close();
 
-			return sb.toString();
-		}
+      return sb.toString();
+    }
 
-		catch (Exception e) {
-			e.printStackTrace();
-		}
+    catch (Exception e) {
+      e.printStackTrace();
+    }
 
-		return null;
-	}
+    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;
-	}
+  /**
+   * 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 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 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;
-	}
+  /**
+   * @return True, if the file is loaded, false otherwise.
+   */
+  public boolean isLoaded() {
+    return this.loaded;
+  }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
index f4d24f59f..02cb2703a 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorJFrame.java
@@ -14,187 +14,185 @@ import javax.swing.JTextArea;
 import javax.swing.JTextField;
 
 /**
- * This class is the GUI implementation of the View component in the
- * Model-View-Presenter pattern.
+ * This class is the GUI implementation of the View component in the Model-View-Presenter pattern.
  */
-public class FileSelectorJFrame extends JFrame implements FileSelectorView,
-		ActionListener {
+public class FileSelectorJFrame extends JFrame implements FileSelectorView, ActionListener {
 
-	/**
-	 * Default serial version ID.
-	 */
-	private static final long serialVersionUID = 1L;
+  /**
+   * Default serial version ID.
+   */
+  private static final long serialVersionUID = 1L;
 
-	/**
-	 * The "OK" button for loading the file.
-	 */
-	private JButton OK;
+  /**
+   * The "OK" button for loading the file.
+   */
+  private JButton OK;
 
-	/**
-	 * The cancel button.
-	 */
-	private JButton cancel;
+  /**
+   * The cancel button.
+   */
+  private JButton cancel;
 
-	/**
-	 * The information label.
-	 */
-	private JLabel info;
+  /**
+   * The information label.
+   */
+  private JLabel info;
 
-	/**
-	 * The contents label.
-	 */
-	private JLabel contents;
+  /**
+   * The contents label.
+   */
+  private JLabel contents;
 
-	/**
-	 * The text field for giving the name of the file that we want to open.
-	 */
-	private JTextField input;
+  /**
+   * 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;
+  /**
+   * 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 panel that will hold our widgets.
+   */
+  private JPanel panel;
 
-	/**
-	 * The Presenter component that the frame will interact with
-	 */
-	private FileSelectorPresenter presenter;
+  /**
+   * 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;
+  /**
+   * 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);
+  /**
+   * 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 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 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 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 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 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 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);
+    /*
+     * 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;
-	}
+    this.presenter = null;
+    this.fileName = null;
+  }
 
-	@Override
-	public void actionPerformed(ActionEvent e) {
-		if (e.getSource() == this.OK) {
-			this.fileName = this.input.getText();
-			presenter.fileNameChanged();
-			presenter.confirmed();
-		}
+  @Override
+  public void actionPerformed(ActionEvent e) {
+    if (e.getSource() == this.OK) {
+      this.fileName = this.input.getText();
+      presenter.fileNameChanged();
+      presenter.confirmed();
+    }
 
-		else if (e.getSource() == this.cancel) {
-			presenter.cancelled();
-		}
-	}
+    else if (e.getSource() == this.cancel) {
+      presenter.cancelled();
+    }
+  }
 
-	@Override
-	public void open() {
-		this.setVisible(true);
-	}
+  @Override
+  public void open() {
+    this.setVisible(true);
+  }
 
-	@Override
-	public void close() {
-		this.dispose();
-	}
+  @Override
+  public void close() {
+    this.dispose();
+  }
 
-	@Override
-	public boolean isOpened() {
-		return this.isVisible();
-	}
+  @Override
+  public boolean isOpened() {
+    return this.isVisible();
+  }
 
-	@Override
-	public void setPresenter(FileSelectorPresenter presenter) {
-		this.presenter = presenter;
-	}
+  @Override
+  public void setPresenter(FileSelectorPresenter presenter) {
+    this.presenter = presenter;
+  }
 
-	@Override
-	public FileSelectorPresenter getPresenter() {
-		return this.presenter;
-	}
+  @Override
+  public FileSelectorPresenter getPresenter() {
+    return this.presenter;
+  }
 
-	@Override
-	public void setFileName(String name) {
-		this.fileName = name;
-	}
+  @Override
+  public void setFileName(String name) {
+    this.fileName = name;
+  }
 
-	@Override
-	public String getFileName() {
-		return this.fileName;
-	}
+  @Override
+  public String getFileName() {
+    return this.fileName;
+  }
 
-	@Override
-	public void showMessage(String message) {
-		JOptionPane.showMessageDialog(null, message);
-	}
+  @Override
+  public void showMessage(String message) {
+    JOptionPane.showMessageDialog(null, message);
+  }
 
-	@Override
-	public void displayData(String data) {
-		this.area.setText(data);
-	}
+  @Override
+  public void displayData(String data) {
+    this.area.setText(data);
+  }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java
index 7119d60bf..133d8555d 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorPresenter.java
@@ -1,75 +1,76 @@
 package com.iluwatar.model.view.presenter;
 
 /**
- * Every instance of this class represents the Presenter component in the
- * Model-View-Presenter architectural pattern.
+ * 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.
+ * 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 View component that the presenter interacts with.
+   */
+  private FileSelectorView view;
 
-	/**
-	 * The Model component that the presenter interacts with.
-	 */
-	private FileLoader loader;
+  /**
+   * 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;
-	}
+  /**
+   * 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;
-	}
+  /**
+   * 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();
-	}
+  /**
+   * 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());
-	}
+  /**
+   * An "event" that fires when the name of the file to be loaded changes.
+   */
+  public void fileNameChanged() {
+    loader.setFileName(view.getFileName());
+  }
 
-	public void confirmed() {
-		if (loader.getFileName() == null || loader.getFileName().equals("")) {
-			view.showMessage("Please give the name of the file first!");
-			return;
-		}
+  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);
-		}
+    if (loader.fileExists()) {
+      String data = loader.loadData();
+      view.displayData(data);
+    }
 
-		else {
-			view.showMessage("The file specified does not exist.");
-		}
-	}
+    else {
+      view.showMessage("The file specified does not exist.");
+    }
+  }
 
-	/**
-	 * Cancels the file loading process.
-	 */
-	public void cancelled() {
-		view.close();
-	}
+  /**
+   * Cancels the file loading process.
+   */
+  public void cancelled() {
+    view.close();
+  }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java
index d0cec4c40..ac338ef22 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorStub.java
@@ -1,109 +1,109 @@
 package com.iluwatar.model.view.presenter;
 
 /**
- * Every instance of this class represents the Stub component in the
- * Model-View-Presenter architectural pattern.
+ * 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.
+ * 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.
+ * 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;
+  /**
+   * Indicates whether or not the view is opened.
+   */
+  private boolean opened;
 
-	/**
-	 * The presenter Component.
-	 */
-	private FileSelectorPresenter presenter;
+  /**
+   * The presenter Component.
+   */
+  private FileSelectorPresenter presenter;
 
-	/**
-	 * The current name of the file.
-	 */
-	private String name;
+  /**
+   * The current name of the file.
+   */
+  private String name;
 
-	/**
-	 * Indicates the number of messages that were "displayed" to the user.
-	 */
-	private int numOfMessageSent;
+  /**
+   * 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;
+  /**
+   * 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;
-	}
+  /**
+   * 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 open() {
+    this.opened = true;
+  }
 
-	@Override
-	public void setPresenter(FileSelectorPresenter presenter) {
-		this.presenter = presenter;
-	}
+  @Override
+  public void setPresenter(FileSelectorPresenter presenter) {
+    this.presenter = presenter;
+  }
 
-	@Override
-	public boolean isOpened() {
-		return this.opened;
-	}
+  @Override
+  public boolean isOpened() {
+    return this.opened;
+  }
 
-	@Override
-	public FileSelectorPresenter getPresenter() {
-		return this.presenter;
-	}
+  @Override
+  public FileSelectorPresenter getPresenter() {
+    return this.presenter;
+  }
 
-	@Override
-	public String getFileName() {
-		return this.name;
-	}
+  @Override
+  public String getFileName() {
+    return this.name;
+  }
 
-	@Override
-	public void setFileName(String name) {
-		this.name = name;
-	}
+  @Override
+  public void setFileName(String name) {
+    this.name = name;
+  }
 
-	@Override
-	public void showMessage(String message) {
-		this.numOfMessageSent++;
-	}
+  @Override
+  public void showMessage(String message) {
+    this.numOfMessageSent++;
+  }
 
-	@Override
-	public void close() {
-		this.opened = false;
-	}
+  @Override
+  public void close() {
+    this.opened = false;
+  }
 
-	@Override
-	public void displayData(String data) {
-		this.dataDisplayed = true;
-	}
+  @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;
-	}
+  /**
+   * 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;
-	}
+  /**
+   * @return True if the data where displayed, false otherwise.
+   */
+  public boolean dataDisplayed() {
+    return this.dataDisplayed;
+  }
 }
diff --git a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java
index 8cd265f9b..80cfadd28 100644
--- a/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java
+++ b/model-view-presenter/src/main/java/com/iluwatar/model/view/presenter/FileSelectorView.java
@@ -1,57 +1,61 @@
 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.
+ * 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.
-	 */
-	public void open();
+  /**
+   * Opens the view.
+   */
+  public void open();
 
-	/**
-	 * Closes the view.
-	 */
-	public void close();
+  /**
+   * Closes the view.
+   */
+  public void close();
 
-	/**
-	 * @return True, if the view is opened, false otherwise.
-	 */
-	public boolean isOpened();
+  /**
+   * @return True, if the view is opened, false otherwise.
+   */
+  public boolean isOpened();
 
-	/**
-	 * Sets the presenter component, to the one given as parameter.
-	 * @param presenter The new presenter component.
-	 */
-	public void setPresenter(FileSelectorPresenter presenter);
+  /**
+   * Sets the presenter component, to the one given as parameter.
+   * 
+   * @param presenter The new presenter component.
+   */
+  public void setPresenter(FileSelectorPresenter presenter);
 
-	/**
-	 * @return The presenter Component.
-	 */
-	public FileSelectorPresenter getPresenter();
+  /**
+   * @return The presenter Component.
+   */
+  public FileSelectorPresenter getPresenter();
 
-	/**
-	 * Sets the file's name, to the value given as parameter.
-	 * @param name The new name of the file.
-	 */
-	public void setFileName(String name);
+  /**
+   * Sets the file's name, to the value given as parameter.
+   * 
+   * @param name The new name of the file.
+   */
+  public void setFileName(String name);
 
-	/**
-	 * @return The name of the file.
-	 */
-	public String getFileName();
+  /**
+   * @return The name of the file.
+   */
+  public String getFileName();
 
-	/**
-	 * Displays a message to the users.
-	 * @param message The message to be displayed.
-	 */
-	public void showMessage(String message);
+  /**
+   * Displays a message to the users.
+   * 
+   * @param message The message to be displayed.
+   */
+  public void showMessage(String message);
 
-	/**
-	 * Displays the data to the view.
-	 * @param data The data to be written.
-	 */
-	public void displayData(String data);
+  /**
+   * Displays the data to the view.
+   * 
+   * @param data The data to be written.
+   */
+  public void displayData(String data);
 }
diff --git a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
index 119448e9c..dfdcba31b 100644
--- a/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
+++ b/model-view-presenter/src/test/java/com/iluwatar/model/view/presenter/FileSelectorPresenterTest.java
@@ -10,116 +10,115 @@ import com.iluwatar.model.view.presenter.FileSelectorPresenter;
 import com.iluwatar.model.view.presenter.FileSelectorStub;
 
 /**
- * This test case is responsible for testing our application by taking advantage
- * of the Model-View-Controller architectural pattern.
+ * 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 Presenter component.
+   */
+  private FileSelectorPresenter presenter;
 
-	/**
-	 * The View component, implemented this time as a Stub!!!
-	 */
-	private FileSelectorStub stub;
+  /**
+   * The View component, implemented this time as a Stub!!!
+   */
+  private FileSelectorStub stub;
 
-	/**
-	 * The Model component.
-	 */
-	private FileLoader loader;
+  /**
+   * 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);
-	}
+  /**
+   * 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();
+  /**
+   * Tests if the Presenter was successfully connected with the View.
+   */
+  @Test
+  public void wiring() {
+    presenter.start();
 
-		assertNotNull(stub.getPresenter());
-		assertTrue(stub.isOpened());
-	}
+    assertNotNull(stub.getPresenter());
+    assertTrue(stub.isOpened());
+  }
 
-	/**
-	 * Tests if the name of the file changes.
-	 */
-	@Test
-	public void updateFileNameToLoader() {
-		String EXPECTED_FILE = "Stamatis";
-		stub.setFileName(EXPECTED_FILE);
+  /**
+   * Tests if the name of the file changes.
+   */
+  @Test
+  public void updateFileNameToLoader() {
+    String EXPECTED_FILE = "Stamatis";
+    stub.setFileName(EXPECTED_FILE);
 
-		presenter.start();
-		presenter.fileNameChanged();
+    presenter.start();
+    presenter.fileNameChanged();
 
-		assertEquals(EXPECTED_FILE, loader.getFileName());
-	}
+    assertEquals(EXPECTED_FILE, 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);
+  /**
+   * 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();
+    presenter.start();
+    presenter.fileNameChanged();
+    presenter.confirmed();
 
-		assertFalse(loader.isLoaded());
-		assertEquals(1, stub.getMessagesSent());
-	}
+    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");
+  /**
+   * 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();
+    presenter.start();
+    presenter.fileNameChanged();
+    presenter.confirmed();
 
-		assertFalse(loader.isLoaded());
-		assertEquals(1, stub.getMessagesSent());
-	}
+    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();
+  /**
+   * 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());
-	}
+    assertTrue(loader.isLoaded());
+    assertTrue(stub.dataDisplayed());
+  }
 
-	/**
-	 * Tests if the view closes after cancellation.
-	 */
-	@Test
-	public void cancellation() {
-		presenter.start();
-		presenter.cancelled();
+  /**
+   * Tests if the view closes after cancellation.
+   */
+  @Test
+  public void cancellation() {
+    presenter.start();
+    presenter.cancelled();
 
-		assertFalse(stub.isOpened());
-	}
+    assertFalse(stub.isOpened());
+  }
 }
diff --git a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
index 7bc0043e8..b81e44251 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/LoadBalancer.java
@@ -46,7 +46,7 @@ public class LoadBalancer {
     Server server = servers.get(lastServedId++);
     server.serve(request);
   }
-  
+
 
 
 }
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Request.java b/monostate/src/main/java/com/iluwatar/monostate/Request.java
index ee1f31d85..b18ba8ff2 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Request.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Request.java
@@ -2,7 +2,7 @@ package com.iluwatar.monostate;
 
 /**
  * 
- * The Request class. A {@link Server} can handle an instance of a Request. 
+ * The Request class. A {@link Server} can handle an instance of a Request.
  * 
  */
 
diff --git a/monostate/src/main/java/com/iluwatar/monostate/Server.java b/monostate/src/main/java/com/iluwatar/monostate/Server.java
index ce4e0222d..f48f4ad0f 100644
--- a/monostate/src/main/java/com/iluwatar/monostate/Server.java
+++ b/monostate/src/main/java/com/iluwatar/monostate/Server.java
@@ -2,8 +2,8 @@ package com.iluwatar.monostate;
 
 /**
  * 
- * The Server class. Each Server sits behind a LoadBalancer which delegates the call to the 
- * servers in a simplistic Round Robin fashion.
+ * 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 {
@@ -26,6 +26,7 @@ public class Server {
   }
 
   public final void serve(Request request) {
-    System.out.println("Server ID " + id + " associated to host : " + getHost() + " and Port " + getPort() +" Processed request with value  " + request.value);
+    System.out.println("Server ID " + id + " associated to host : " + getHost() + " and Port "
+        + getPort() + " Processed request with value  " + request.value);
   }
 }
diff --git a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
index c5f1f7e92..c502dd14a 100644
--- a/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
+++ b/monostate/src/test/java/com/iluwatar/monostate/AppTest.java
@@ -15,7 +15,7 @@ public class AppTest {
     // Both Should have the same LastServedId
     Assert.assertTrue(balancer.getLastServedId() == balancer2.getLastServedId());
   }
-  
+
   @Test
   public void testMain() {
     String[] args = {};
diff --git a/multiton/src/main/java/com/iluwatar/multiton/App.java b/multiton/src/main/java/com/iluwatar/multiton/App.java
index 9f2c5da78..273087310 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/App.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/App.java
@@ -2,31 +2,31 @@ package com.iluwatar.multiton;
 
 /**
  * 
- * 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.
+ * 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.
+ * 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 {
-	
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-    public static void main( String[] args ) {
-    	System.out.println("KHAMUL=" + Nazgul.getInstance(NazgulName.KHAMUL));
-    	System.out.println("MURAZOR=" + Nazgul.getInstance(NazgulName.MURAZOR));
-    	System.out.println("DWAR=" + Nazgul.getInstance(NazgulName.DWAR));
-    	System.out.println("JI_INDUR=" + Nazgul.getInstance(NazgulName.JI_INDUR));
-    	System.out.println("AKHORAHIL=" + Nazgul.getInstance(NazgulName.AKHORAHIL));
-    	System.out.println("HOARMURATH=" + Nazgul.getInstance(NazgulName.HOARMURATH));
-    	System.out.println("ADUNAPHEL=" + Nazgul.getInstance(NazgulName.ADUNAPHEL));
-    	System.out.println("REN=" + Nazgul.getInstance(NazgulName.REN));
-    	System.out.println("UVATHA=" + Nazgul.getInstance(NazgulName.UVATHA));    	
-    }
+
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    System.out.println("KHAMUL=" + Nazgul.getInstance(NazgulName.KHAMUL));
+    System.out.println("MURAZOR=" + Nazgul.getInstance(NazgulName.MURAZOR));
+    System.out.println("DWAR=" + Nazgul.getInstance(NazgulName.DWAR));
+    System.out.println("JI_INDUR=" + Nazgul.getInstance(NazgulName.JI_INDUR));
+    System.out.println("AKHORAHIL=" + Nazgul.getInstance(NazgulName.AKHORAHIL));
+    System.out.println("HOARMURATH=" + Nazgul.getInstance(NazgulName.HOARMURATH));
+    System.out.println("ADUNAPHEL=" + Nazgul.getInstance(NazgulName.ADUNAPHEL));
+    System.out.println("REN=" + Nazgul.getInstance(NazgulName.REN));
+    System.out.println("UVATHA=" + Nazgul.getInstance(NazgulName.UVATHA));
+  }
 }
diff --git a/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java b/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java
index 833923f75..f6f5ce84d 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/Nazgul.java
@@ -5,38 +5,37 @@ import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * 
- * Nazgul is a Multiton class. Nazgul instances can be queried
- * using {@link #getInstance} method.
+ * Nazgul is a Multiton class. Nazgul instances can be queried using {@link #getInstance} method.
  *
  */
 public class Nazgul {
 
-	private static Map nazguls;
-	
-	private NazgulName name;
+  private static Map nazguls;
 
-	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;
-	}
+  private NazgulName name;
 
-	public static Nazgul getInstance(NazgulName name) {
-		return nazguls.get(name);
-	}
-	
-	public NazgulName getName() {
-		return 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;
+  }
 }
diff --git a/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java b/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java
index cef1e43a9..8869042df 100644
--- a/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java
+++ b/multiton/src/main/java/com/iluwatar/multiton/NazgulName.java
@@ -7,6 +7,6 @@ package com.iluwatar.multiton;
  */
 public enum NazgulName {
 
-	KHAMUL, MURAZOR, DWAR, JI_INDUR, AKHORAHIL, HOARMURATH, ADUNAPHEL, REN, UVATHA;
-	
+  KHAMUL, MURAZOR, DWAR, JI_INDUR, AKHORAHIL, HOARMURATH, ADUNAPHEL, REN, UVATHA;
+
 }
diff --git a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
index 439f08e24..41b1387a6 100644
--- a/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
+++ b/multiton/src/test/java/com/iluwatar/multiton/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.multiton.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java
index 641c39ae7..6769f95dd 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageService.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -25,27 +21,25 @@ import org.apache.isis.applib.annotation.HomePage;
 import org.apache.isis.applib.annotation.NatureOfService;
 import org.apache.isis.applib.annotation.SemanticsOf;
 
-@DomainService(
-        nature = NatureOfService.VIEW_CONTRIBUTIONS_ONLY // trick to suppress the actions from the top-level menu
+@DomainService(nature = NatureOfService.VIEW_CONTRIBUTIONS_ONLY // trick to suppress the actions
+                                                                // from the top-level menu
 )
 public class HomePageService {
 
-    //region > homePage (action)
+  // region > homePage (action)
 
-    @Action(
-            semantics = SemanticsOf.SAFE
-    )
-    @HomePage
-    public HomePageViewModel homePage() {
-        return container.injectServicesInto(new HomePageViewModel());
-    }
+  @Action(semantics = SemanticsOf.SAFE)
+  @HomePage
+  public HomePageViewModel homePage() {
+    return container.injectServicesInto(new HomePageViewModel());
+  }
 
-    //endregion
+  // endregion
 
-    //region > injected services
+  // region > injected services
 
-    @javax.inject.Inject
-    DomainObjectContainer container;
+  @javax.inject.Inject
+  DomainObjectContainer container;
 
-    //endregion
+  // endregion
 }
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java
index 83015d057..1391bac6a 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/app/homepage/HomePageViewModel.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -28,23 +24,25 @@ import domainapp.dom.modules.simple.SimpleObjects;
 @ViewModel
 public class HomePageViewModel {
 
-    //region > title
-    public String title() {
-        return getObjects().size() + " objects";
-    }
-    //endregion
+  // region > title
+  public String title() {
+    return getObjects().size() + " objects";
+  }
 
-    //region > object (collection)
-    @org.apache.isis.applib.annotation.HomePage
-    public List getObjects() {
-        return simpleObjects.listAll();
-    }
-    //endregion
+  // endregion
 
-    //region > injected services
+  // region > object (collection)
+  @org.apache.isis.applib.annotation.HomePage
+  public List getObjects() {
+    return simpleObjects.listAll();
+  }
 
-    @javax.inject.Inject
-    SimpleObjects simpleObjects;
+  // endregion
 
-    //endregion
+  // region > injected services
+
+  @javax.inject.Inject
+  SimpleObjects simpleObjects;
+
+  // endregion
 }
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java
index a4fba6dda..300e184fa 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObject.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -37,113 +33,95 @@ import org.apache.isis.applib.services.eventbus.ActionDomainEvent;
 import org.apache.isis.applib.services.i18n.TranslatableString;
 import org.apache.isis.applib.util.ObjectContracts;
 
-@javax.jdo.annotations.PersistenceCapable(
-        identityType=IdentityType.DATASTORE,
-        schema = "simple",
-        table = "SimpleObject"
-)
+@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")
+    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"})
+    @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"
-)
+@DomainObjectLayout(bookmarking = BookmarkPolicy.AS_ROOT, cssClassFa = "fa-flag")
 public class SimpleObject implements Comparable {
 
 
-    //region > identificatiom
-    public TranslatableString title() {
-        return TranslatableString.tr("Object: {name}", "name", getName());
+  // region > identificatiom
+  public TranslatableString title() {
+    return TranslatableString.tr("Object: {name}", "name", getName());
+  }
+
+  // endregion
+
+  // region > name (property)
+
+  private String name;
+
+  @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)
+
+  public static class UpdateNameDomainEvent extends ActionDomainEvent {
+    public UpdateNameDomainEvent(final SimpleObject source, final Identifier identifier,
+        final Object... arguments) {
+      super(source, identifier, arguments);
     }
-    //endregion
+  }
 
-    //region > name (property)
+  @Action(domainEvent = UpdateNameDomainEvent.class)
+  public SimpleObject updateName(
+      @Parameter(maxLength = 40) @ParameterLayout(named = "New name") final String name) {
+    setName(name);
+    return this;
+  }
 
-    private String name;
+  public String default0UpdateName() {
+    return getName();
+  }
 
-    @javax.jdo.annotations.Column(allowsNull="false", length = 40)
-    @Title(sequence="1")
-    @Property(
-            editing = Editing.DISABLED
-    )
-    public String getName() {
-        return name;
-    }
+  public TranslatableString validateUpdateName(final String name) {
+    return name.contains("!") ? TranslatableString.tr("Exclamation mark is not allowed") : null;
+  }
 
-    public void setName(final String name) {
-        this.name = name;
-    }
+  // endregion
 
-    // endregion
+  // region > version (derived property)
+  public Long getVersionSequence() {
+    return (Long) JDOHelper.getVersion(this);
+  }
 
-    //region > updateName (action)
+  // endregion
 
-    public static class UpdateNameDomainEvent extends ActionDomainEvent {
-        public UpdateNameDomainEvent(final SimpleObject source, final Identifier identifier, final Object... arguments) {
-            super(source, identifier, arguments);
-        }
-    }
+  // region > compareTo
 
-    @Action(
-            domainEvent = UpdateNameDomainEvent.class
-    )
-    public SimpleObject updateName(
-            @Parameter(maxLength = 40)
-            @ParameterLayout(named = "New name")
-            final String name) {
-        setName(name);
-        return this;
-    }
+  @Override
+  public int compareTo(final SimpleObject other) {
+    return ObjectContracts.compare(this, other, "name");
+  }
 
-    public String default0UpdateName() {
-        return getName();
-    }
+  // endregion
 
-    public TranslatableString validateUpdateName(final String name) {
-        return name.contains("!")? TranslatableString.tr("Exclamation mark is not allowed"): null;
-    }
+  // region > injected services
 
-    //endregion
+  @javax.inject.Inject
+  @SuppressWarnings("unused")
+  private DomainObjectContainer container;
 
-    //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
+  // endregion
 
 
 }
diff --git a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java
index 0634dd16a..5e4642455 100644
--- a/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java
+++ b/naked-objects/dom/src/main/java/domainapp/dom/modules/simple/SimpleObjects.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -38,70 +34,56 @@ import org.apache.isis.applib.services.i18n.TranslatableString;
 @DomainServiceLayout(menuOrder = "10")
 public class SimpleObjects {
 
-    //region > title
-    public TranslatableString title() {
-        return TranslatableString.tr("Simple Objects");
+  // 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
+
+  // region > create (action)
+  public static class CreateDomainEvent extends ActionDomainEvent {
+    public CreateDomainEvent(final SimpleObjects source, final Identifier identifier,
+        final Object... arguments) {
+      super(source, identifier, arguments);
     }
-    //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
+  @Action(domainEvent = CreateDomainEvent.class)
+  @MemberOrder(sequence = "3")
+  public SimpleObject create(final @ParameterLayout(named = "Name") String name) {
+    final SimpleObject obj = container.newTransientInstance(SimpleObject.class);
+    obj.setName(name);
+    container.persistIfNotAlready(obj);
+    return obj;
+  }
 
-    //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
+  // endregion
 
-    //region > create (action)
-    public static class CreateDomainEvent extends ActionDomainEvent {
-        public CreateDomainEvent(final SimpleObjects source, final Identifier identifier, final Object... arguments) {
-            super(source, identifier, arguments);
-        }
-    }
+  // region > injected services
 
-    @Action(
-            domainEvent = CreateDomainEvent.class
-    )
-    @MemberOrder(sequence = "3")
-    public SimpleObject create(
-            final @ParameterLayout(named="Name") String name) {
-        final SimpleObject obj = container.newTransientInstance(SimpleObject.class);
-        obj.setName(name);
-        container.persistIfNotAlready(obj);
-        return obj;
-    }
+  @javax.inject.Inject
+  DomainObjectContainer container;
 
-    //endregion
-
-    //region > injected services
-
-    @javax.inject.Inject 
-    DomainObjectContainer container;
-
-    //endregion
+  // endregion
 }
diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
index e29b3f246..fc62239c2 100644
--- a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
+++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectTest.java
@@ -1,18 +1,16 @@
 /**
- *  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
+ * 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
+ * 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.
+ * 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;
 
@@ -23,27 +21,27 @@ import static org.assertj.core.api.Assertions.assertThat;
 
 public class SimpleObjectTest {
 
-    SimpleObject simpleObject;
+  SimpleObject simpleObject;
 
-    @Before
-    public void setUp() throws Exception {
-        simpleObject = new SimpleObject();
-    }
-
-    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);
-        }
+  @Before
+  public void setUp() throws Exception {
+    simpleObject = new SimpleObject();
+  }
+
+  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);
     }
+  }
 
 }
diff --git a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
index a41d25ad9..47cad61b8 100644
--- a/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
+++ b/naked-objects/dom/src/test/java/domainapp/dom/modules/simple/SimpleObjectsTest.java
@@ -1,18 +1,16 @@
 /**
- *  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
+ * 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
+ * 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.
+ * 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;
 
@@ -35,70 +33,70 @@ import static org.assertj.core.api.Assertions.assertThat;
 
 public class SimpleObjectsTest {
 
-    @Rule
-    public JUnitRuleMockery2 context = JUnitRuleMockery2.createFor(Mode.INTERFACES_AND_CLASSES);
+  @Rule
+  public JUnitRuleMockery2 context = JUnitRuleMockery2.createFor(Mode.INTERFACES_AND_CLASSES);
 
-    @Mock
-    DomainObjectContainer mockContainer;
-    
-    SimpleObjects simpleObjects;
+  @Mock
+  DomainObjectContainer mockContainer;
 
-    @Before
-    public void setUp() throws Exception {
-        simpleObjects = new SimpleObjects();
-        simpleObjects.container = mockContainer;
-    }
+  SimpleObjects simpleObjects;
 
-    public static class Create extends SimpleObjectsTest {
+  @Before
+  public void setUp() throws Exception {
+    simpleObjects = new SimpleObjects();
+    simpleObjects.container = mockContainer;
+  }
 
-        @Test
-        public void happyCase() throws Exception {
+  public static class Create extends SimpleObjectsTest {
 
-            // given
-            final SimpleObject simpleObject = new SimpleObject();
+    @Test
+    public void happyCase() throws Exception {
 
-            final Sequence seq = context.sequence("create");
-            context.checking(new Expectations() {
-                {
-                    oneOf(mockContainer).newTransientInstance(SimpleObject.class);
-                    inSequence(seq);
-                    will(returnValue(simpleObject));
+      // given
+      final SimpleObject simpleObject = new SimpleObject();
 
-                    oneOf(mockContainer).persistIfNotAlready(simpleObject);
-                    inSequence(seq);
-                }
-            });
+      final Sequence seq = context.sequence("create");
+      context.checking(new Expectations() {
+        {
+          oneOf(mockContainer).newTransientInstance(SimpleObject.class);
+          inSequence(seq);
+          will(returnValue(simpleObject));
 
-            // when
-            final SimpleObject obj = simpleObjects.create("Foobar");
-
-            // then
-            assertThat(obj).isEqualTo(simpleObject);
-            assertThat(obj.getName()).isEqualTo("Foobar");
+          oneOf(mockContainer).persistIfNotAlready(simpleObject);
+          inSequence(seq);
         }
+      });
 
+      // when
+      final SimpleObject obj = simpleObjects.create("Foobar");
+
+      // then
+      assertThat(obj).isEqualTo(simpleObject);
+      assertThat(obj.getName()).isEqualTo("Foobar");
     }
 
-    public static class ListAll extends SimpleObjectsTest {
+  }
 
-        @Test
-        public void happyCase() throws Exception {
+  public static class ListAll extends SimpleObjectsTest {
 
-            // given
-            final List all = Lists.newArrayList();
+    @Test
+    public void happyCase() throws Exception {
 
-            context.checking(new Expectations() {
-                {
-                    oneOf(mockContainer).allInstances(SimpleObject.class);
-                    will(returnValue(all));
-                }
-            });
+      // given
+      final List all = Lists.newArrayList();
 
-            // when
-            final List list = simpleObjects.listAll();
-
-            // then
-            assertThat(list).isEqualTo(all);
+      context.checking(new Expectations() {
+        {
+          oneOf(mockContainer).allInstances(SimpleObject.class);
+          will(returnValue(all));
         }
+      });
+
+      // when
+      final List list = simpleObjects.listAll();
+
+      // then
+      assertThat(list).isEqualTo(all);
     }
+  }
 }
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java
index ab6b6b4be..ccc11f2b8 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/DomainAppFixturesProvider.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -31,14 +27,12 @@ import domainapp.fixture.scenarios.RecreateSimpleObjects;
  */
 @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();
-    }
+  @Override
+  public FixtureScriptsSpecification getSpecification() {
+    return FixtureScriptsSpecification.builder(DomainAppFixturesProvider.class)
+        .with(FixtureScripts.MultipleExecutionStrategy.EXECUTE)
+        .withRunScriptDefault(RecreateSimpleObjects.class)
+        .withRunScriptDropDown(FixtureScriptsSpecification.DropDownPolicy.CHOICES)
+        .withRecreate(RecreateSimpleObjects.class).build();
+  }
 }
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java
index 926217d09..2918fe7f6 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectCreate.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
@@ -26,46 +22,50 @@ import domainapp.dom.modules.simple.SimpleObjects;
 
 public class SimpleObjectCreate extends FixtureScript {
 
-    //region > name (input)
-    private String name;
-    /**
-     * Name of the object (required)
-     */
-    public String getName() {
-        return name;
-    }
+  // region > name (input)
+  private String name;
 
-    public SimpleObjectCreate setName(final String name) {
-        this.name = name;
-        return this;
-    }
-    //endregion
+  /**
+   * Name of the object (required)
+   */
+  public String getName() {
+    return name;
+  }
+
+  public SimpleObjectCreate setName(final String name) {
+    this.name = name;
+    return this;
+  }
+
+  // endregion
 
 
-    //region > simpleObject (output)
-    private SimpleObject simpleObject;
+  // region > simpleObject (output)
+  private SimpleObject simpleObject;
 
-    /**
-     * The created simple object (output).
-     * @return
-     */
-    public SimpleObject getSimpleObject() {
-        return simpleObject;
-    }
-    //endregion
+  /**
+   * The created simple object (output).
+   * 
+   * @return
+   */
+  public SimpleObject getSimpleObject() {
+    return simpleObject;
+  }
 
-    @Override
-    protected void execute(final ExecutionContext ec) {
+  // endregion
 
-        String name = checkParam("name", ec, String.class);
+  @Override
+  protected void execute(final ExecutionContext ec) {
 
-        this.simpleObject = wrap(simpleObjects).create(name);
+    String name = checkParam("name", ec, String.class);
 
-        // also make available to UI
-        ec.addResult(this, simpleObject);
-    }
+    this.simpleObject = wrap(simpleObjects).create(name);
 
-    @javax.inject.Inject
-    private SimpleObjects simpleObjects;
+    // also make available to UI
+    ec.addResult(this, simpleObject);
+  }
+
+  @javax.inject.Inject
+  private SimpleObjects simpleObjects;
 
 }
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java
index cc06eb4ac..e844af9c7 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/modules/simple/SimpleObjectsTearDown.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
@@ -24,13 +20,13 @@ import org.apache.isis.applib.services.jdosupport.IsisJdoSupport;
 
 public class SimpleObjectsTearDown extends FixtureScript {
 
-    @Override
-    protected void execute(ExecutionContext executionContext) {
-        isisJdoSupport.executeUpdate("delete from \"simple\".\"SimpleObject\"");
-    }
+  @Override
+  protected void execute(ExecutionContext executionContext) {
+    isisJdoSupport.executeUpdate("delete from \"simple\".\"SimpleObject\"");
+  }
 
 
-    @javax.inject.Inject
-    private IsisJdoSupport isisJdoSupport;
+  @javax.inject.Inject
+  private IsisJdoSupport isisJdoSupport;
 
 }
diff --git a/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java b/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java
index 072769e29..c978e0b82 100644
--- a/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java
+++ b/naked-objects/fixture/src/main/java/domainapp/fixture/scenarios/RecreateSimpleObjects.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
@@ -33,60 +29,63 @@ import domainapp.fixture.modules.simple.SimpleObjectsTearDown;
 
 public class RecreateSimpleObjects extends FixtureScript {
 
-    public final List NAMES = Collections.unmodifiableList(Arrays.asList(
-            "Foo", "Bar", "Baz", "Frodo", "Froyo", "Fizz", "Bip", "Bop", "Bang", "Boo"));
+  public final List NAMES = Collections.unmodifiableList(Arrays.asList("Foo", "Bar", "Baz",
+      "Frodo", "Froyo", "Fizz", "Bip", "Bop", "Bang", "Boo"));
 
-    public RecreateSimpleObjects() {
-        withDiscoverability(Discoverability.DISCOVERABLE);
+  public RecreateSimpleObjects() {
+    withDiscoverability(Discoverability.DISCOVERABLE);
+  }
+
+  // region > number (optional input)
+  private Integer number;
+
+  /**
+   * 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;
+  }
+
+  // endregion
+
+  // region > simpleObjects (output)
+  private final List simpleObjects = Lists.newArrayList();
+
+  /**
+   * The simpleobjects created by this fixture (output).
+   */
+  public List getSimpleObjects() {
+    return simpleObjects;
+  }
+
+  // endregion
+
+  @Override
+  protected void execute(final ExecutionContext ec) {
+
+    // defaults
+    final int number = defaultParam("number", ec, 3);
+
+    // validate
+    if (number < 0 || number > NAMES.size()) {
+      throw new IllegalArgumentException(String.format("number must be in range [0,%d)",
+          NAMES.size()));
     }
 
-    //region > number (optional input)
-    private Integer number;
+    //
+    // execute
+    //
+    ec.executeChild(this, new SimpleObjectsTearDown());
 
-    /**
-     * 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;
-    }
-    //endregion
-
-    //region > simpleObjects (output)
-    private final List simpleObjects = Lists.newArrayList();
-
-    /**
-     * The simpleobjects created by this fixture (output).
-     */
-    public List getSimpleObjects() {
-        return simpleObjects;
-    }
-    //endregion
-
-    @Override
-    protected void execute(final ExecutionContext ec) {
-
-        // defaults
-        final int number = defaultParam("number", ec, 3);
-
-        // validate
-        if(number < 0 || number > 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 < number; i++) {
-            final SimpleObjectCreate fs = new SimpleObjectCreate().setName(NAMES.get(i));
-            ec.executeChild(this, fs.getName(), fs);
-            simpleObjects.add(fs.getSimpleObject());
-        }
+    for (int i = 0; i < number; i++) {
+      final SimpleObjectCreate fs = new SimpleObjectCreate().setName(NAMES.get(i));
+      ec.executeChild(this, fs.getName(), fs);
+      simpleObjects.add(fs.getSimpleObject());
     }
+  }
 }
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java b/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java
index 28e9d3786..c617915f1 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/bootstrap/SimpleAppSystemInitializer.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -25,30 +21,31 @@ import org.apache.isis.objectstore.jdo.datanucleus.IsisConfigurationForJdoIntegT
 
 public class SimpleAppSystemInitializer {
 
-    public static void initIsft() {
-        IsisSystemForTest isft = IsisSystemForTest.getElseNull();
-        if(isft == null) {
-            isft = new SimpleAppSystemBuilder().build().setUpSystem();
-            IsisSystemForTest.set(isft);
-        }
+  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 class SimpleAppSystemBuilder extends IsisSystemForTest.Builder {
+    private static IsisConfiguration testConfiguration() {
+      final IsisConfigurationForJdoIntegTests testConfiguration =
+          new IsisConfigurationForJdoIntegTests();
 
-        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;
-        }
+      testConfiguration.addRegisterEntitiesPackagePrefix("domainapp.dom.modules");
+      return testConfiguration;
     }
+  }
 }
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java
index b175d4744..190e1f5bb 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/BootstrappingGlue.java
@@ -1,18 +1,16 @@
 /**
-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
+ * 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
+ * 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.
+ * 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;
 
@@ -25,17 +23,17 @@ import domainapp.integtests.bootstrap.SimpleAppSystemInitializer;
 
 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);
-    }
+  @Before(value = {"@integration"}, order = 100)
+  public void beforeScenarioIntegrationScope() {
+    org.apache.log4j.PropertyConfigurator.configure("logging.properties");
+    SimpleAppSystemInitializer.initIsft();
 
-    @After
-    public void afterScenario(cucumber.api.Scenario sc) {
-        assertMocksSatisfied();
-        after(sc);
-    }
+    before(ScenarioExecutionScope.INTEGRATION);
+  }
+
+  @After
+  public void afterScenario(cucumber.api.Scenario sc) {
+    assertMocksSatisfied();
+    after(sc);
+  }
 }
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java
index a2d5c8985..2fcb7cca7 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/CatalogOfFixturesGlue.java
@@ -1,18 +1,16 @@
 /**
- *  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
+ * 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
+ * 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.
+ * 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;
 
@@ -23,9 +21,8 @@ import domainapp.fixture.scenarios.RecreateSimpleObjects;
 
 public class CatalogOfFixturesGlue extends CukeGlueAbstract {
 
-    @Before(value={"@integration", "@SimpleObjectsFixture"}, order=20000)
-    public void integrationFixtures() throws Throwable {
-        scenarioExecution().install(new RecreateSimpleObjects());
-    }
-
+  @Before(value = {"@integration", "@SimpleObjectsFixture"}, order = 20000)
+  public void integrationFixtures() throws Throwable {
+    scenarioExecution().install(new RecreateSimpleObjects());
+  }
 }
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java
index 63d96bd53..ef6012919 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specglue/modules/simple/SimpleObjectGlue.java
@@ -1,18 +1,16 @@
 /**
- *  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
+ * 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
+ * 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.
+ * 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;
 
@@ -30,21 +28,21 @@ import static org.junit.Assert.assertThat;
 
 public class SimpleObjectGlue extends CukeGlueAbstract {
 
-    @Given("^there are.* (\\d+) simple objects$")
-    public void there_are_N_simple_objects(int n) throws Throwable {
-        try {
-            final List findAll = service(SimpleObjects.class).listAll();
-            assertThat(findAll.size(), is(n));
-            putVar("list", "all", findAll);
-            
-        } finally {
-            assertMocksSatisfied();
-        }
+  @Given("^there are.* (\\d+) simple objects$")
+  public void there_are_N_simple_objects(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 I_create_a_new_simple_object() throws Throwable {
-        service(SimpleObjects.class).create(UUID.randomUUID().toString());
-    }
-    
+  }
+
+  @When("^I create a new simple object$")
+  public void I_create_a_new_simple_object() throws Throwable {
+    service(SimpleObjects.class).create(UUID.randomUUID().toString());
+  }
+
 }
diff --git a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
index 910b5a826..8a842a0f3 100644
--- a/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
+++ b/naked-objects/integtests/src/test/java/domainapp/integtests/specs/RunSpecs.java
@@ -1,18 +1,16 @@
 /**
- *  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
+ * 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
+ * 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.
+ * 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;
 
@@ -23,17 +21,12 @@ import cucumber.api.junit.Cucumber;
 
 
 /**
- * Runs scenarios in all .feature files (this package and any subpackages). 
+ * 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" })
+@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 
+  // intentionally empty
 }
diff --git a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
index 57d1e0ba1..c7bbd8c80 100644
--- a/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
+++ b/naked-objects/webapp/src/main/java/domainapp/webapp/SimpleApplication.java
@@ -1,20 +1,16 @@
 /*
- *  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.
+ * 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;
 
@@ -53,6 +49,7 @@ import de.agilecoders.wicket.themes.markup.html.bootswatch.BootswatchThemeProvid
  * 
  * 
    
  * See:
+ * 
  * 
      * <filter>
  *   <filter-name>wicket</filter-name>
@@ -67,87 +64,96 @@ import de.agilecoders.wicket.themes.markup.html.bootswatch.BootswatchThemeProvid
  */
 public class SimpleApplication extends IsisWicketApplication {
 
-    private static final long serialVersionUID = 1L;
+  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 final static boolean DEMO_MODE_USING_CREDENTIALS_AS_QUERYARGS = false;
+  /**
+   * uncomment for a (slightly hacky) way of allowing logins using query args, eg:
+   * 
+   * ?user=sven&pass=pass
+   * 
+   * 
    
+   * for demos only, obvious.
+   */
+  private final static boolean DEMO_MODE_USING_CREDENTIALS_AS_QUERYARGS = false;
 
 
-    @Override
-    protected void init() {
-        super.init();
+  @Override
+  protected void init() {
+    super.init();
 
-        IBootstrapSettings settings = Bootstrap.getSettings();
-        settings.setThemeProvider(new BootswatchThemeProvider(BootswatchTheme.Flatly));
+    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);
     }
 
-    @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;
+    // 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);
     }
 
-    @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) {
-        }
-        WebRequest request = super.newWebRequest(servletRequest, filterPath);
-        return request;
+    // else demo mode
+    try {
+      String uname = servletRequest.getParameter("user");
+      if (uname != null) {
+        servletRequest.getSession().invalidate();
+      }
+    } catch (Exception e) {
     }
-    
-    @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")));
-            }
-        };
+    WebRequest request = super.newWebRequest(servletRequest, filterPath);
+    return request;
+  }
 
-        return Modules.override(isisDefaults).with(overrides);
-    }
+  @Override
+  protected Module newIsisWicketModule() {
+    final Module isisDefaults = super.newIsisWicketModule();
 
-    private static String readLines(final Class contextClass, final String resourceName) {
-        try {
-            List readLines = Resources.readLines(Resources.getResource(contextClass, resourceName), Charset.defaultCharset());
-            final String aboutText = Joiner.on("\n").join(readLines);
-            return aboutText;
-        } catch (IOException e) {
-            return "This is a simple app";
-        }
+    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());
+      final String aboutText = Joiner.on("\n").join(readLines);
+      return aboutText;
+    } catch (IOException e) {
+      return "This is a simple app";
     }
+  }
 
 }
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/App.java b/null-object/src/main/java/com/iluwatar/nullobject/App.java
index 9cc4a14da..65f124c84 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/App.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/App.java
@@ -2,35 +2,27 @@ 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.
+ * 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.
+ * 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())));
+public class App {
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
 
-    	root.walk();
-    }
+    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();
+  }
 }
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/Node.java b/null-object/src/main/java/com/iluwatar/nullobject/Node.java
index 3d52087c9..010c1b7f1 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/Node.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/Node.java
@@ -7,9 +7,13 @@ package com.iluwatar.nullobject;
  */
 public interface Node {
 
-	String getName();
-	int getTreeSize();
-	Node getLeft();
-	Node getRight();
-	void walk();
+  String getName();
+
+  int getTreeSize();
+
+  Node getLeft();
+
+  Node getRight();
+
+  void walk();
 }
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java b/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
index fc9c9c9e3..5de258890 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/NodeImpl.java
@@ -7,44 +7,44 @@ package com.iluwatar.nullobject;
  */
 public class NodeImpl implements Node {
 
-	private final String name;
-	private final Node left;
-	private final Node right;
-	
-	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();
-	}
+  private final String name;
+  private final Node left;
+  private final Node right;
 
-	@Override
-	public Node getLeft() {
-		return left;
-	}
+  public NodeImpl(String name, Node left, Node right) {
+    this.name = name;
+    this.left = left;
+    this.right = right;
+  }
 
-	@Override
-	public Node getRight() {
-		return right;
-	}
+  @Override
+  public int getTreeSize() {
+    return 1 + left.getTreeSize() + right.getTreeSize();
+  }
 
-	@Override
-	public String getName() {
-		return name;
-	}
+  @Override
+  public Node getLeft() {
+    return left;
+  }
 
-	@Override
-	public void walk() {
-		System.out.println(name);
-		if (left.getTreeSize() > 0) {
-			left.walk();
-		}
-		if (right.getTreeSize() > 0) {
-			right.walk();
-		}
-	}
+  @Override
+  public Node getRight() {
+    return right;
+  }
+
+  @Override
+  public String getName() {
+    return name;
+  }
+
+  @Override
+  public void walk() {
+    System.out.println(name);
+    if (left.getTreeSize() > 0) {
+      left.walk();
+    }
+    if (right.getTreeSize() > 0) {
+      right.walk();
+    }
+  }
 }
diff --git a/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java b/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java
index 4a0f4cd2b..992b34af3 100644
--- a/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java
+++ b/null-object/src/main/java/com/iluwatar/nullobject/NullNode.java
@@ -9,36 +9,34 @@ package com.iluwatar.nullobject;
  */
 public class NullNode implements Node {
 
-	private static NullNode instance = new NullNode();
-	
-	private NullNode() {
-	}
-	
-	public static NullNode getInstance() {
-		return instance;
-	}
-	
-	@Override
-	public int getTreeSize() {
-		return 0;
-	}
+  private static NullNode instance = new NullNode();
 
-	@Override
-	public Node getLeft() {
-		return null;
-	}
+  private NullNode() {}
 
-	@Override
-	public Node getRight() {
-		return null;
-	}
+  public static NullNode getInstance() {
+    return instance;
+  }
 
-	@Override
-	public String getName() {
-		return null;
-	}
+  @Override
+  public int getTreeSize() {
+    return 0;
+  }
 
-	@Override
-	public void walk() {
-	}
+  @Override
+  public Node getLeft() {
+    return null;
+  }
+
+  @Override
+  public Node getRight() {
+    return null;
+  }
+
+  @Override
+  public String getName() {
+    return null;
+  }
+
+  @Override
+  public void walk() {}
 }
diff --git a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
index 7ddf2cabc..58f03da28 100644
--- a/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
+++ b/null-object/src/test/java/com/iluwatar/nullobject/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.nullobject.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/App.java b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
index c1893a774..97670223d 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/App.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/App.java
@@ -2,48 +2,51 @@ package com.iluwatar.object.pool;
 
 /**
  * 
- * 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. 
+ * 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.
+ * 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).
+ * 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 {
-	
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-    public static void main( String[] args ) {
-    	OliphauntPool pool = new OliphauntPool();
-    	System.out.println(pool);
-    	Oliphaunt oliphaunt1 = pool.checkOut();
-    	System.out.println("Checked out " + oliphaunt1);
-    	System.out.println(pool);
-    	Oliphaunt oliphaunt2 = pool.checkOut();
-    	System.out.println("Checked out " + oliphaunt2);
-    	Oliphaunt oliphaunt3 = pool.checkOut();
-    	System.out.println("Checked out " + oliphaunt3);
-    	System.out.println(pool);
-    	System.out.println("Checking in " + oliphaunt1);
-    	pool.checkIn(oliphaunt1);
-    	System.out.println("Checking in " + oliphaunt2);
-    	pool.checkIn(oliphaunt2);
-    	System.out.println(pool);
-       	Oliphaunt oliphaunt4 = pool.checkOut();
-    	System.out.println("Checked out " + oliphaunt4);
-       	Oliphaunt oliphaunt5 = pool.checkOut();
-    	System.out.println("Checked out " + oliphaunt5);
-    	System.out.println(pool);
-    }
+
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   */
+  public static void main(String[] args) {
+    OliphauntPool pool = new OliphauntPool();
+    System.out.println(pool);
+    Oliphaunt oliphaunt1 = pool.checkOut();
+    System.out.println("Checked out " + oliphaunt1);
+    System.out.println(pool);
+    Oliphaunt oliphaunt2 = pool.checkOut();
+    System.out.println("Checked out " + oliphaunt2);
+    Oliphaunt oliphaunt3 = pool.checkOut();
+    System.out.println("Checked out " + oliphaunt3);
+    System.out.println(pool);
+    System.out.println("Checking in " + oliphaunt1);
+    pool.checkIn(oliphaunt1);
+    System.out.println("Checking in " + oliphaunt2);
+    pool.checkIn(oliphaunt2);
+    System.out.println(pool);
+    Oliphaunt oliphaunt4 = pool.checkOut();
+    System.out.println("Checked out " + oliphaunt4);
+    Oliphaunt oliphaunt5 = pool.checkOut();
+    System.out.println("Checked out " + oliphaunt5);
+    System.out.println(pool);
+  }
 }
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java b/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java
index 8b582630b..79d7d6345 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/ObjectPool.java
@@ -10,28 +10,28 @@ import java.util.HashSet;
  */
 public abstract class ObjectPool {
 
-	private HashSet available = new HashSet<>();
-	private HashSet inUse = new HashSet<>();
-	
-	protected abstract T create();
-	
-	public synchronized T checkOut() {
-		if (available.size() <= 0) {
-			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());
-	}
+  private HashSet available = new HashSet<>();
+  private HashSet inUse = new HashSet<>();
+
+  protected abstract T create();
+
+  public synchronized T checkOut() {
+    if (available.size() <= 0) {
+      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());
+  }
 }
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java b/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java
index 4b32e0ba1..aeefd6b3a 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/Oliphaunt.java
@@ -6,26 +6,26 @@ package com.iluwatar.object.pool;
  *
  */
 public class Oliphaunt {
-	
-	private static int counter = 1;
-	
-	private final int id;
-	
-	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);
-	}
+
+  private static int counter = 1;
+
+  private final int id;
+
+  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);
+  }
 }
diff --git a/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java b/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java
index a0cfc0d54..106f16c1b 100644
--- a/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java
+++ b/object-pool/src/main/java/com/iluwatar/object/pool/OliphauntPool.java
@@ -7,8 +7,8 @@ package com.iluwatar.object.pool;
  */
 public class OliphauntPool extends ObjectPool {
 
-	@Override
-	protected Oliphaunt create() {
-		return new Oliphaunt();
-	}
+  @Override
+  protected Oliphaunt create() {
+    return new Oliphaunt();
+  }
 }
diff --git a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
index 4114590ec..fd2920d88 100644
--- a/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
+++ b/object-pool/src/test/java/com/iluwatar/object/pool/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.object.pool.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
index 91d30fddd..3f66dc808 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/App.java
@@ -1,43 +1,45 @@
 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).
+ * 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.
+ * 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);
+  /**
+   * 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);
+    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() {
+        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();
-	}
+    new Thread() {
+      @Override
+      public void run() {
+        producer.send("hand shake");
+        producer.send("some very important information");
+        producer.send("bye!");
+        producer.stop();
+      }
+    }.start();
+  }
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
index 3bb9dcc56..ff06d7d5b 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Consumer.java
@@ -7,32 +7,33 @@ import com.iluwatar.poison.pill.Message.Headers;
  */
 public class Consumer {
 
-	private final MQSubscribePoint queue;
-	private final String name;
+  private final MQSubscribePoint queue;
+  private final String name;
 
-	public Consumer(String name, MQSubscribePoint queue) {
-		this.name = name;
-		this.queue = queue;
-	}
+  public Consumer(String name, MQSubscribePoint queue) {
+    this.name = name;
+    this.queue = queue;
+  }
 
-	public void consume() {
-		while (true) {
-			Message msg;
-			try {
-				msg = queue.take();
-				if (msg == Message.POISON_PILL) {
-					System.out.println(String.format("Consumer %s receive request to terminate.", name));
-					break;
-				}
-			} catch (InterruptedException e) {
-				// allow thread to exit
-				System.err.println(e);
-				return;
-			}
+  public void consume() {
+    while (true) {
+      Message msg;
+      try {
+        msg = queue.take();
+        if (msg == Message.POISON_PILL) {
+          System.out.println(String.format("Consumer %s receive request to terminate.", name));
+          break;
+        }
+      } catch (InterruptedException e) {
+        // allow thread to exit
+        System.err.println(e);
+        return;
+      }
 
-			String sender = msg.getHeader(Headers.SENDER);
-			String body = msg.getBody();
-			System.out.println(String.format("Message [%s] from [%s] received by [%s]", body, sender, name));
-		}
-	}
+      String sender = msg.getHeader(Headers.SENDER);
+      String body = msg.getBody();
+      System.out.println(String.format("Message [%s] from [%s] received by [%s]", body, sender,
+          name));
+    }
+  }
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java
index 9c72242be..a266d9f4d 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQPublishPoint.java
@@ -5,5 +5,5 @@ package com.iluwatar.poison.pill;
  */
 public interface MQPublishPoint {
 
-	public void put(Message msg) throws InterruptedException;
+  public void put(Message msg) throws InterruptedException;
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java
index f689835b6..c093b1412 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/MQSubscribePoint.java
@@ -5,5 +5,5 @@ package com.iluwatar.poison.pill;
  */
 public interface MQSubscribePoint {
 
-	public Message take() throws InterruptedException;
+  public Message take() throws InterruptedException;
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java
index 8e167790f..b0fc6d6dc 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Message.java
@@ -3,51 +3,55 @@ 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.
+ * 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 {
 
-	public static final Message POISON_PILL = new Message() {
+  public static final Message POISON_PILL = new Message() {
 
-		@Override
-		public void addHeader(Headers header, String value) {
-			throw poison();
-		}
+    @Override
+    public void addHeader(Headers header, String value) {
+      throw poison();
+    }
 
-		@Override
-		public String getHeader(Headers header) {
-			throw poison();
-		}
+    @Override
+    public String getHeader(Headers header) {
+      throw poison();
+    }
 
-		@Override
-		public Map getHeaders() {
-			throw poison();
-		}
+    @Override
+    public Map getHeaders() {
+      throw poison();
+    }
 
-		@Override
-		public void setBody(String body) {
-			throw poison();
-		}
+    @Override
+    public void setBody(String body) {
+      throw poison();
+    }
 
-		@Override
-		public String getBody() {
-			throw poison();
-		}
+    @Override
+    public String getBody() {
+      throw poison();
+    }
 
-		private RuntimeException poison() {
-			return new UnsupportedOperationException("Poison");
-		}
+    private RuntimeException poison() {
+      return new UnsupportedOperationException("Poison");
+    }
 
-	};
+  };
 
-	public enum Headers {
-		DATE, SENDER
-	}
+  public enum Headers {
+    DATE, SENDER
+  }
 
-	public void addHeader(Headers header, String value);
-	public String getHeader(Headers header);
-	public Map getHeaders();
-	public void setBody(String body);
-	public String getBody();
+  public void addHeader(Headers header, String value);
+
+  public String getHeader(Headers header);
+
+  public Map getHeaders();
+
+  public void setBody(String body);
+
+  public String getBody();
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
index 56d086204..ecde39e35 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/Producer.java
@@ -5,44 +5,46 @@ import java.util.Date;
 import com.iluwatar.poison.pill.Message.Headers;
 
 /**
- * Class responsible for producing unit of work that can be expressed as message and submitted to queue
+ * Class responsible for producing unit of work that can be expressed as message and submitted to
+ * queue
  */
 public class Producer {
 
-	private final MQPublishPoint queue;
-	private final String name;
-	private boolean isStopped;
+  private final MQPublishPoint queue;
+  private final String name;
+  private boolean isStopped;
 
-	public Producer(String name, MQPublishPoint queue) {
-		this.name = name;
-		this.queue = queue;
-		this.isStopped = false;
-	}
+  public Producer(String name, MQPublishPoint queue) {
+    this.name = name;
+    this.queue = queue;
+    this.isStopped = false;
+  }
 
-	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);
+  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
-			System.err.println(e);
-		}
-	}
+    try {
+      queue.put(msg);
+    } catch (InterruptedException e) {
+      // allow thread to exit
+      System.err.println(e);
+    }
+  }
 
-	public void stop() {
-		isStopped = true;
-		try {
-			queue.put(Message.POISON_PILL);
-		} catch (InterruptedException e) {
-			// allow thread to exit
-			System.err.println(e);
-		}
-	}
+  public void stop() {
+    isStopped = true;
+    try {
+      queue.put(Message.POISON_PILL);
+    } catch (InterruptedException e) {
+      // allow thread to exit
+      System.err.println(e);
+    }
+  }
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java
index 61a8664f5..5b08d2295 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessage.java
@@ -9,31 +9,31 @@ import java.util.Map;
  */
 public class SimpleMessage implements Message {
 
-	private Map headers = new HashMap<>();
-	private String body;
+  private Map headers = new HashMap<>();
+  private String body;
 
-	@Override
-	public void addHeader(Headers header, String value) {
-		headers.put(header, value);
-	}
+  @Override
+  public void addHeader(Headers header, String value) {
+    headers.put(header, value);
+  }
 
-	@Override
-	public String getHeader(Headers header) {
-		return headers.get(header);
-	}
+  @Override
+  public String getHeader(Headers header) {
+    return headers.get(header);
+  }
 
-	@Override
-	public Map getHeaders() {
-		return Collections.unmodifiableMap(headers);
-	}
+  @Override
+  public Map getHeaders() {
+    return Collections.unmodifiableMap(headers);
+  }
 
-	@Override
-	public void setBody(String body) {
-		this.body = body;
-	}
+  @Override
+  public void setBody(String body) {
+    this.body = body;
+  }
 
-	@Override
-	public String getBody() {
-		return body;
-	}
+  @Override
+  public String getBody() {
+    return body;
+  }
 }
diff --git a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java
index 316ed33e5..dd0b3ed0a 100644
--- a/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java
+++ b/poison-pill/src/main/java/com/iluwatar/poison/pill/SimpleMessageQueue.java
@@ -8,20 +8,19 @@ import java.util.concurrent.BlockingQueue;
  */
 public class SimpleMessageQueue implements MessageQueue {
 
-	private final BlockingQueue queue;
+  private final BlockingQueue queue;
 
-	public SimpleMessageQueue(int bound) {
-		queue = new ArrayBlockingQueue(bound);
-	}
+  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();
-	}
+  @Override
+  public void put(Message msg) throws InterruptedException {
+    queue.put(msg);
+  }
 
+  @Override
+  public Message take() throws InterruptedException {
+    return queue.take();
+  }
 }
diff --git a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
index 0730e5b10..c9b619016 100644
--- a/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
+++ b/poison-pill/src/test/java/com/iluwatar/poison/pill/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.poison.pill.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java
index a4e2ffa87..4c328043f 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/App.java
@@ -2,37 +2,36 @@ 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.
+ * 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.
+ * 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.
+ * 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();
-    }
+
+  /**
+   * 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();
+  }
 }
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
index ebaaf28a0..599a80407 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/ImmutableStew.java
@@ -7,14 +7,15 @@ package com.iluwatar.privateclassdata;
  */
 public class ImmutableStew {
 
-	private StewData data;
-	
-	public ImmutableStew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
-		data = new StewData(numPotatoes, numCarrots, numMeat, numPeppers);
-	}
-	
-	public void mix() {
-		System.out.println(String.format("Mixing the immutable stew we find: %d potatoes, %d carrots, %d meat and %d peppers",
-				data.getNumPotatoes(), data.getNumCarrots(), data.getNumMeat(), data.getNumPeppers()));
-	}
+  private StewData data;
+
+  public ImmutableStew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
+    data = new StewData(numPotatoes, numCarrots, numMeat, numPeppers);
+  }
+
+  public void mix() {
+    System.out.println(String.format(
+        "Mixing the immutable stew we find: %d potatoes, %d carrots, %d meat and %d peppers",
+        data.getNumPotatoes(), data.getNumCarrots(), data.getNumMeat(), data.getNumPeppers()));
+  }
 }
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
index 6ad05044b..9deb32e16 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/Stew.java
@@ -6,37 +6,38 @@ package com.iluwatar.privateclassdata;
  *
  */
 public class Stew {
-	
-	private int numPotatoes;
-	private int numCarrots;
-	private int numMeat;
-	private int numPeppers;
-	
-	public Stew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
-		this.numPotatoes = numPotatoes;
-		this.numCarrots = numCarrots;
-		this.numMeat = numMeat;
-		this.numPeppers = numPeppers;
-	}
-	
-	public void mix() {
-		System.out.println(String.format("Mixing the stew we find: %d potatoes, %d carrots, %d meat and %d peppers",
-				numPotatoes, numCarrots, numMeat, numPeppers));
-	}
-	
-	public void taste() {
-		System.out.println("Tasting the stew");
-		if (numPotatoes > 0) { 
-			numPotatoes--; 
-		}
-		if (numCarrots > 0) { 
-			numCarrots--; 
-		}
-		if (numMeat > 0) { 
-			numMeat--; 
-		}
-		if (numPeppers > 0) { 
-			numPeppers--; 
-		}
-	}
+
+  private int numPotatoes;
+  private int numCarrots;
+  private int numMeat;
+  private int numPeppers;
+
+  public Stew(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
+    this.numPotatoes = numPotatoes;
+    this.numCarrots = numCarrots;
+    this.numMeat = numMeat;
+    this.numPeppers = numPeppers;
+  }
+
+  public void mix() {
+    System.out.println(String.format(
+        "Mixing the stew we find: %d potatoes, %d carrots, %d meat and %d peppers", numPotatoes,
+        numCarrots, numMeat, numPeppers));
+  }
+
+  public void taste() {
+    System.out.println("Tasting the stew");
+    if (numPotatoes > 0) {
+      numPotatoes--;
+    }
+    if (numCarrots > 0) {
+      numCarrots--;
+    }
+    if (numMeat > 0) {
+      numMeat--;
+    }
+    if (numPeppers > 0) {
+      numPeppers--;
+    }
+  }
 }
diff --git a/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java b/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java
index f90d3bd18..23d54ccf4 100644
--- a/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java
+++ b/private-class-data/src/main/java/com/iluwatar/privateclassdata/StewData.java
@@ -7,31 +7,31 @@ package com.iluwatar.privateclassdata;
  */
 public class StewData {
 
-	private int numPotatoes;
-	private int numCarrots;
-	private int numMeat;
-	private int numPeppers;
-	
-	public StewData(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
-		this.numPotatoes = numPotatoes;
-		this.numCarrots = numCarrots;
-		this.numMeat = numMeat;
-		this.numPeppers = numPeppers;
-	}
+  private int numPotatoes;
+  private int numCarrots;
+  private int numMeat;
+  private int numPeppers;
 
-	public int getNumPotatoes() {
-		return numPotatoes;
-	}
+  public StewData(int numPotatoes, int numCarrots, int numMeat, int numPeppers) {
+    this.numPotatoes = numPotatoes;
+    this.numCarrots = numCarrots;
+    this.numMeat = numMeat;
+    this.numPeppers = numPeppers;
+  }
 
-	public int getNumCarrots() {
-		return numCarrots;
-	}
+  public int getNumPotatoes() {
+    return numPotatoes;
+  }
 
-	public int getNumMeat() {
-		return numMeat;
-	}
+  public int getNumCarrots() {
+    return numCarrots;
+  }
 
-	public int getNumPeppers() {
-		return numPeppers;
-	}
+  public int getNumMeat() {
+    return numMeat;
+  }
+
+  public int getNumPeppers() {
+    return numPeppers;
+  }
 }
diff --git a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
index 92fc9b46a..6623a43ad 100644
--- a/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
+++ b/private-class-data/src/test/java/com/iluwatar/privateclassdata/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.privateclassdata.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}	
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/property/src/main/java/com/iluwatar/property/App.java b/property/src/main/java/com/iluwatar/property/App.java
index ac46f5448..966bd36a5 100644
--- a/property/src/main/java/com/iluwatar/property/App.java
+++ b/property/src/main/java/com/iluwatar/property/App.java
@@ -6,53 +6,55 @@ import com.iluwatar.property.Character.Type;
  * 
  * 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 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 {
 
-	/**
-	 * 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);
+  /**
+   * 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 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 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
+    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);
-		System.out.println(mag);
+    /* usage */
+    Character mag = new Character("Player_1", mageProto);
+    mag.set(Stats.ARMOR, 8);
+    System.out.println(mag);
 
-		Character warrior = new Character("Player_2", warProto);
-		System.out.println(warrior);
+    Character warrior = new Character("Player_2", warProto);
+    System.out.println(warrior);
 
-		Character rogue = new Character("Player_3", rogueProto);
-		System.out.println(rogue);
+    Character rogue = new Character("Player_3", rogueProto);
+    System.out.println(rogue);
 
-		Character rogueDouble = new Character("Player_4", rogue);
-		rogueDouble.set(Stats.ATTACK_POWER, 12);
-		System.out.println(rogueDouble);
-	}
+    Character rogueDouble = new Character("Player_4", rogue);
+    rogueDouble.set(Stats.ATTACK_POWER, 12);
+    System.out.println(rogueDouble);
+  }
 }
diff --git a/property/src/main/java/com/iluwatar/property/Character.java b/property/src/main/java/com/iluwatar/property/Character.java
index cb2fdf583..10b8f495d 100644
--- a/property/src/main/java/com/iluwatar/property/Character.java
+++ b/property/src/main/java/com/iluwatar/property/Character.java
@@ -8,110 +8,100 @@ import java.util.Map;
  */
 public class Character implements Prototype {
 
-	public enum Type {
-		WARRIOR, MAGE, ROGUE
-	}
+  public enum Type {
+    WARRIOR, MAGE, ROGUE
+  }
 
-	private final Prototype prototype;
-	private final Map properties = new HashMap<>();
+  private final Prototype prototype;
+  private final Map properties = new HashMap<>();
 
-	private String name;
-	private Type type;
+  private String name;
+  private Type type;
 
-	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() {
+    this.prototype = new Prototype() { // Null-value object
+          @Override
+          public Integer get(Stats stat) {
+            return null;
+          }
 
-	public Character(Type type, Prototype prototype) {
-		this.type = type;
-		this.prototype = prototype;
-	}
+          @Override
+          public boolean has(Stats stat) {
+            return false;
+          }
 
-	public Character(String name, Character prototype) {
-		this.name = name;
-		this.type = prototype.type;
-		this.prototype = prototype;
-	}
+          @Override
+          public void set(Stats stat, Integer val) {}
 
-	public String name() {
-		return name;
-	}
+          @Override
+          public void remove(Stats stat) {}
+        };
+  }
 
-	public Type type() {
-		return type;
-	}
+  public Character(Type type, Prototype prototype) {
+    this.type = type;
+    this.prototype = prototype;
+  }
 
-	@Override
-	public Integer get(Stats stat) {
-		boolean containsValue = properties.containsKey(stat);
-		if (containsValue) {
-			return properties.get(stat);
-		} else {
-			return prototype.get(stat);
-		}
-	}
+  public Character(String name, Character prototype) {
+    this.name = name;
+    this.type = prototype.type;
+    this.prototype = prototype;
+  }
 
-	@Override
-	public boolean has(Stats stat) {
-		return get(stat) != null;
-	}
+  public String name() {
+    return name;
+  }
 
-	@Override
-	public void set(Stats stat, Integer val) {
-		properties.put(stat, val);
-	}
+  public Type type() {
+    return type;
+  }
 
-	@Override
-	public void remove(Stats stat) {
-		properties.put(stat, null);
-	}
+  @Override
+  public Integer get(Stats stat) {
+    boolean containsValue = properties.containsKey(stat);
+    if (containsValue) {
+      return properties.get(stat);
+    } else {
+      return prototype.get(stat);
+    }
+  }
 
-	@Override
-	public String toString() {
-		StringBuilder builder = new StringBuilder();
-		if (name != null) {
-			builder
-				.append("Player: ")
-				.append(name)
-				.append("\n");
-		}
+  @Override
+  public boolean has(Stats stat) {
+    return get(stat) != null;
+  }
 
-		if (type != null) {
-			builder
-				.append("Character type: ")
-				.append(type.name())
-				.append("\n");
-		}
+  @Override
+  public void set(Stats stat, Integer val) {
+    properties.put(stat, val);
+  }
 
-		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();
-	}
+  @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();
+  }
 
 }
diff --git a/property/src/main/java/com/iluwatar/property/Prototype.java b/property/src/main/java/com/iluwatar/property/Prototype.java
index 12b4ce734..13b4c8608 100644
--- a/property/src/main/java/com/iluwatar/property/Prototype.java
+++ b/property/src/main/java/com/iluwatar/property/Prototype.java
@@ -5,8 +5,11 @@ package com.iluwatar.property;
  */
 public interface Prototype {
 
-	public Integer get(Stats stat);
-	public boolean has(Stats stat);
-	public void set(Stats stat, Integer val);
-	public void remove(Stats stat);
+  public Integer get(Stats stat);
+
+  public boolean has(Stats stat);
+
+  public void set(Stats stat, Integer val);
+
+  public void remove(Stats stat);
 }
diff --git a/property/src/main/java/com/iluwatar/property/Stats.java b/property/src/main/java/com/iluwatar/property/Stats.java
index b791a9dec..5ce71dcfe 100644
--- a/property/src/main/java/com/iluwatar/property/Stats.java
+++ b/property/src/main/java/com/iluwatar/property/Stats.java
@@ -5,5 +5,5 @@ package com.iluwatar.property;
  */
 public enum Stats {
 
-	AGILITY, STRENGTH, ATTACK_POWER, ARMOR, INTELLECT, SPIRIT, ENERGY, RAGE
+  AGILITY, STRENGTH, ATTACK_POWER, ARMOR, INTELLECT, SPIRIT, ENERGY, RAGE
 }
diff --git a/property/src/test/java/com/iluwatar/property/AppTest.java b/property/src/test/java/com/iluwatar/property/AppTest.java
index 1e8078352..75be2f649 100644
--- a/property/src/test/java/com/iluwatar/property/AppTest.java
+++ b/property/src/test/java/com/iluwatar/property/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.property.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/App.java b/prototype/src/main/java/com/iluwatar/prototype/App.java
index 74bb6989d..77c727a39 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/App.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/App.java
@@ -2,44 +2,43 @@ package com.iluwatar.prototype;
 
 /**
  * 
- * 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)
+ * 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.
+ * 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 {
 
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 */
-	public static void main(String[] args) {
-		HeroFactory factory;
-		Mage mage;
-		Warlord warlord;
-		Beast beast;
+  /**
+   * 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();
-		System.out.println(mage);
-		System.out.println(warlord);
-		System.out.println(beast);
+    factory = new HeroFactoryImpl(new ElfMage(), new ElfWarlord(), new ElfBeast());
+    mage = factory.createMage();
+    warlord = factory.createWarlord();
+    beast = factory.createBeast();
+    System.out.println(mage);
+    System.out.println(warlord);
+    System.out.println(beast);
 
-		factory = new HeroFactoryImpl(new OrcMage(), new OrcWarlord(),
-				new OrcBeast());
-		mage = factory.createMage();
-		warlord = factory.createWarlord();
-		beast = factory.createBeast();
-		System.out.println(mage);
-		System.out.println(warlord);
-		System.out.println(beast);
-	}
+    factory = new HeroFactoryImpl(new OrcMage(), new OrcWarlord(), new OrcBeast());
+    mage = factory.createMage();
+    warlord = factory.createWarlord();
+    beast = factory.createBeast();
+    System.out.println(mage);
+    System.out.println(warlord);
+    System.out.println(beast);
+  }
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Beast.java b/prototype/src/main/java/com/iluwatar/prototype/Beast.java
index 028fa11b8..1b6d5d9a4 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Beast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Beast.java
@@ -7,7 +7,7 @@ package com.iluwatar.prototype;
  */
 public abstract class Beast extends Prototype {
 
-	@Override
-	public abstract Beast clone() throws CloneNotSupportedException;
+  @Override
+  public abstract Beast clone() throws CloneNotSupportedException;
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
index b2b517207..f5cb8bdaf 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfBeast.java
@@ -7,20 +7,18 @@ package com.iluwatar.prototype;
  */
 public class ElfBeast extends Beast {
 
-	public ElfBeast() {
-	}
+  public ElfBeast() {}
 
-	public ElfBeast(ElfBeast beast) {
-	}
+  public ElfBeast(ElfBeast beast) {}
 
-	@Override
-	public Beast clone() throws CloneNotSupportedException {
-		return new ElfBeast(this);
-	}
+  @Override
+  public Beast clone() throws CloneNotSupportedException {
+    return new ElfBeast(this);
+  }
 
-	@Override
-	public String toString() {
-		return "Elven eagle";
-	}
+  @Override
+  public String toString() {
+    return "Elven eagle";
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
index b502350c3..c801e4007 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfMage.java
@@ -7,20 +7,18 @@ package com.iluwatar.prototype;
  */
 public class ElfMage extends Mage {
 
-	public ElfMage() {
-	}
+  public ElfMage() {}
 
-	public ElfMage(ElfMage mage) {
-	}
+  public ElfMage(ElfMage mage) {}
 
-	@Override
-	public Mage clone() throws CloneNotSupportedException {
-		return new ElfMage(this);
-	}
+  @Override
+  public Mage clone() throws CloneNotSupportedException {
+    return new ElfMage(this);
+  }
 
-	@Override
-	public String toString() {
-		return "Elven mage";
-	}
+  @Override
+  public String toString() {
+    return "Elven mage";
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
index 7f5829797..8b5167b0e 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/ElfWarlord.java
@@ -7,20 +7,18 @@ package com.iluwatar.prototype;
  */
 public class ElfWarlord extends Warlord {
 
-	public ElfWarlord() {
-	}
+  public ElfWarlord() {}
 
-	public ElfWarlord(ElfWarlord warlord) {
-	}
+  public ElfWarlord(ElfWarlord warlord) {}
 
-	@Override
-	public Warlord clone() throws CloneNotSupportedException {
-		return new ElfWarlord(this);
-	}
+  @Override
+  public Warlord clone() throws CloneNotSupportedException {
+    return new ElfWarlord(this);
+  }
 
-	@Override
-	public String toString() {
-		return "Elven warlord";
-	}
+  @Override
+  public String toString() {
+    return "Elven warlord";
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java b/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java
index 468eefcb5..bf52b9787 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/HeroFactory.java
@@ -7,10 +7,10 @@ package com.iluwatar.prototype;
  */
 public interface HeroFactory {
 
-	Mage createMage();
+  Mage createMage();
 
-	Warlord createWarlord();
+  Warlord createWarlord();
 
-	Beast createBeast();
+  Beast createBeast();
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java b/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
index dc440f41e..4c5a60bcd 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/HeroFactoryImpl.java
@@ -7,38 +7,38 @@ package com.iluwatar.prototype;
  */
 public class HeroFactoryImpl implements HeroFactory {
 
-	private Mage mage;
-	private Warlord warlord;
-	private Beast beast;
+  private Mage mage;
+  private Warlord warlord;
+  private Beast beast;
 
-	public HeroFactoryImpl(Mage mage, Warlord warlord, Beast beast) {
-		this.mage = mage;
-		this.warlord = warlord;
-		this.beast = beast;
-	}
+  public HeroFactoryImpl(Mage mage, Warlord warlord, Beast beast) {
+    this.mage = mage;
+    this.warlord = warlord;
+    this.beast = beast;
+  }
 
-	public Mage createMage() {
-		try {
-			return mage.clone();
-		} catch (CloneNotSupportedException e) {
-			return null;
-		}
-	}
+  public Mage createMage() {
+    try {
+      return mage.clone();
+    } catch (CloneNotSupportedException e) {
+      return null;
+    }
+  }
 
-	public Warlord createWarlord() {
-		try {
-			return warlord.clone();
-		} catch (CloneNotSupportedException e) {
-			return null;
-		}
-	}
+  public Warlord createWarlord() {
+    try {
+      return warlord.clone();
+    } catch (CloneNotSupportedException e) {
+      return null;
+    }
+  }
 
-	public Beast createBeast() {
-		try {
-			return beast.clone();
-		} catch (CloneNotSupportedException e) {
-			return null;
-		}
-	}
+  public Beast createBeast() {
+    try {
+      return beast.clone();
+    } catch (CloneNotSupportedException e) {
+      return null;
+    }
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Mage.java b/prototype/src/main/java/com/iluwatar/prototype/Mage.java
index 7ba192487..73e4ee0a0 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Mage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Mage.java
@@ -7,7 +7,7 @@ package com.iluwatar.prototype;
  */
 public abstract class Mage extends Prototype {
 
-	@Override
-	public abstract Mage clone() throws CloneNotSupportedException;
+  @Override
+  public abstract Mage clone() throws CloneNotSupportedException;
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
index 2af2fefa9..50a6b5ae2 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcBeast.java
@@ -7,20 +7,18 @@ package com.iluwatar.prototype;
  */
 public class OrcBeast extends Beast {
 
-	public OrcBeast() {
-	}
+  public OrcBeast() {}
 
-	public OrcBeast(OrcBeast beast) {
-	}
+  public OrcBeast(OrcBeast beast) {}
 
-	@Override
-	public Beast clone() throws CloneNotSupportedException {
-		return new OrcBeast(this);
-	}
+  @Override
+  public Beast clone() throws CloneNotSupportedException {
+    return new OrcBeast(this);
+  }
 
-	@Override
-	public String toString() {
-		return "Orcish wolf";
-	}
+  @Override
+  public String toString() {
+    return "Orcish wolf";
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
index 1f52a25d9..f27d12519 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcMage.java
@@ -7,20 +7,18 @@ package com.iluwatar.prototype;
  */
 public class OrcMage extends Mage {
 
-	public OrcMage() {
-	}
+  public OrcMage() {}
 
-	public OrcMage(OrcMage mage) {
-	}
+  public OrcMage(OrcMage mage) {}
 
-	@Override
-	public Mage clone() throws CloneNotSupportedException {
-		return new OrcMage(this);
-	}
+  @Override
+  public Mage clone() throws CloneNotSupportedException {
+    return new OrcMage(this);
+  }
 
-	@Override
-	public String toString() {
-		return "Orcish mage";
-	}
+  @Override
+  public String toString() {
+    return "Orcish mage";
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
index 53814d1c2..d21816d8e 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/OrcWarlord.java
@@ -7,20 +7,18 @@ package com.iluwatar.prototype;
  */
 public class OrcWarlord extends Warlord {
 
-	public OrcWarlord() {
-	}
+  public OrcWarlord() {}
 
-	public OrcWarlord(OrcWarlord warlord) {
-	}
+  public OrcWarlord(OrcWarlord warlord) {}
 
-	@Override
-	public Warlord clone() throws CloneNotSupportedException {
-		return new OrcWarlord(this);
-	}
+  @Override
+  public Warlord clone() throws CloneNotSupportedException {
+    return new OrcWarlord(this);
+  }
 
-	@Override
-	public String toString() {
-		return "Orcish warlord";
-	}
+  @Override
+  public String toString() {
+    return "Orcish warlord";
+  }
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Prototype.java b/prototype/src/main/java/com/iluwatar/prototype/Prototype.java
index eb2520c35..272eeaf37 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Prototype.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Prototype.java
@@ -7,7 +7,7 @@ package com.iluwatar.prototype;
  */
 public abstract class Prototype implements Cloneable {
 
-	@Override
-	public abstract Object clone() throws CloneNotSupportedException;
+  @Override
+  public abstract Object clone() throws CloneNotSupportedException;
 
 }
diff --git a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
index bfd5c594a..f4a965ef3 100644
--- a/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
+++ b/prototype/src/main/java/com/iluwatar/prototype/Warlord.java
@@ -7,7 +7,7 @@ package com.iluwatar.prototype;
  */
 public abstract class Warlord extends Prototype {
 
-	@Override
-	public abstract Warlord clone() throws CloneNotSupportedException;
+  @Override
+  public abstract Warlord clone() throws CloneNotSupportedException;
 
 }
diff --git a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
index 030f5472c..c2b8ea4ff 100644
--- a/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
+++ b/prototype/src/test/java/com/iluwatar/prototype/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.prototype.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java
index 420ad5c0a..25a903e41 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/App.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/App.java
@@ -2,30 +2,30 @@ 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.
+ * 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 
+ * 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 WizardTower}).
+ * In this example the proxy ({@link WizardTowerProxy}) controls access to the actual object (
+ * {@link WizardTower}).
  * 
  */
 public class App {
 
-	public static void main(String[] args) {
+  public static void main(String[] args) {
 
-		WizardTowerProxy tower = new WizardTowerProxy();
-		tower.enter(new Wizard("Red wizard"));
-		tower.enter(new Wizard("White wizard"));
-		tower.enter(new Wizard("Black wizard"));
-		tower.enter(new Wizard("Green wizard"));
-		tower.enter(new Wizard("Brown wizard"));
+    WizardTowerProxy tower = new WizardTowerProxy();
+    tower.enter(new Wizard("Red wizard"));
+    tower.enter(new Wizard("White wizard"));
+    tower.enter(new Wizard("Black wizard"));
+    tower.enter(new Wizard("Green wizard"));
+    tower.enter(new Wizard("Brown wizard"));
 
-	}
+  }
 }
diff --git a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
index b6d5691f4..8351b45bf 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/Wizard.java
@@ -7,15 +7,15 @@ package com.iluwatar.proxy;
  */
 public class Wizard {
 
-	private String name;
+  private String name;
 
-	public Wizard(String name) {
-		this.name = name;
-	}
+  public Wizard(String name) {
+    this.name = name;
+  }
 
-	@Override
-	public String toString() {
-		return name;
-	}
+  @Override
+  public String toString() {
+    return name;
+  }
 
 }
diff --git a/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java b/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java
index d4aa27c81..882312c21 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/WizardTower.java
@@ -7,8 +7,8 @@ package com.iluwatar.proxy;
  */
 public class WizardTower {
 
-	public void enter(Wizard wizard) {
-		System.out.println(wizard + " enters the tower.");
-	}
+  public void enter(Wizard wizard) {
+    System.out.println(wizard + " enters the tower.");
+  }
 
 }
diff --git a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
index 567a998d1..42f37c768 100644
--- a/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
+++ b/proxy/src/main/java/com/iluwatar/proxy/WizardTowerProxy.java
@@ -7,17 +7,17 @@ package com.iluwatar.proxy;
  */
 public class WizardTowerProxy extends WizardTower {
 
-	private static final int NUM_WIZARDS_ALLOWED = 3;
+  private static final int NUM_WIZARDS_ALLOWED = 3;
 
-	private int numWizards;
+  private int numWizards;
 
-	@Override
-	public void enter(Wizard wizard) {
-		if (numWizards < NUM_WIZARDS_ALLOWED) {
-			super.enter(wizard);
-			numWizards++;
-		} else {
-			System.out.println(wizard + " is not allowed to enter!");
-		}
-	}
+  @Override
+  public void enter(Wizard wizard) {
+    if (numWizards < NUM_WIZARDS_ALLOWED) {
+      super.enter(wizard);
+      numWizards++;
+    } else {
+      System.out.println(wizard + " is not allowed to enter!");
+    }
+  }
 }
diff --git a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
index 4d21b3d9a..a68629646 100644
--- a/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
+++ b/proxy/src/test/java/com/iluwatar/proxy/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.proxy.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/App.java b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
index 7bb01ddc8..2c49d9001 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/App.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/App.java
@@ -69,11 +69,13 @@ public class App {
   private Dispatcher dispatcher;
 
   /**
-   * Creates an instance of App which will use provided dispatcher for dispatching events on reactor.
+   * 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;
+    this.dispatcher = dispatcher;
   }
 
   /**
@@ -106,7 +108,8 @@ public class App {
      * 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))
+    reactor.registerChannel(tcpChannel(6666, loggingHandler))
+        .registerChannel(tcpChannel(6667, loggingHandler))
         .registerChannel(udpChannel(6668, loggingHandler)).start();
   }
 
@@ -120,7 +123,7 @@ public class App {
     reactor.stop();
     dispatcher.stop();
     for (AbstractNioChannel channel : channels) {
-    	channel.getJavaChannel().close();
+      channel.getJavaChannel().close();
     }
   }
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
index 659f5da21..ee25b0be0 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/app/AppClient.java
@@ -140,7 +140,8 @@ public class AppClient {
         for (int i = 0; i < 4; i++) {
 
           String message = clientName + " - Log request: " + i;
-          DatagramPacket request = new DatagramPacket(message.getBytes(), message.getBytes().length, remoteAddress);
+          DatagramPacket request =
+              new DatagramPacket(message.getBytes(), message.getBytes().length, remoteAddress);
 
           socket.send(request);
 
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
index 9f2f8a95c..df08426d0 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/AbstractNioChannel.java
@@ -24,7 +24,8 @@ public abstract class AbstractNioChannel {
 
   private final SelectableChannel channel;
   private final ChannelHandler handler;
-  private final Map> channelToPendingWrites = new ConcurrentHashMap<>();
+  private final Map> channelToPendingWrites =
+      new ConcurrentHashMap<>();
   private NioReactor reactor;
 
   /**
diff --git a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
index c5caaa7ff..f8be9b777 100644
--- a/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
+++ b/reactor/src/main/java/com/iluwatar/reactor/framework/NioServerSocketChannel.java
@@ -71,7 +71,8 @@ public class NioServerSocketChannel extends AbstractNioChannel {
    */
   @Override
   public void bind() throws IOException {
-    ((ServerSocketChannel) getJavaChannel()).socket().bind(new InetSocketAddress(InetAddress.getLocalHost(), port));
+    ((ServerSocketChannel) getJavaChannel()).socket().bind(
+        new InetSocketAddress(InetAddress.getLocalHost(), port));
     ((ServerSocketChannel) getJavaChannel()).configureBlocking(false);
     System.out.println("Bound TCP socket at port: " + port);
   }
diff --git a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
index 9abb4e690..10611bdc9 100644
--- a/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
+++ b/reactor/src/test/java/com/iluwatar/reactor/app/AppTest.java
@@ -39,7 +39,7 @@ public class AppTest {
 
     app.stop();
   }
-  
+
   /**
    * Test the application using same thread dispatcher.
    * 
diff --git a/repository/src/main/java/com/iluwatar/repository/App.java b/repository/src/main/java/com/iluwatar/repository/App.java
index 37a5f7962..fb9680cb6 100644
--- a/repository/src/main/java/com/iluwatar/repository/App.java
+++ b/repository/src/main/java/com/iluwatar/repository/App.java
@@ -7,61 +7,63 @@ 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
+ * 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 
+ * 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. Underneath we have
- * configured in-memory H2 database for which schema is created and dropped on each run.
+ * 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. Underneath we have configured in-memory H2 database for which schema is created and
+ * dropped on each run.
  *
  */
 public class App {
-	
-	/**
-	 * 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");
-		Person nasta = new Person("Nasta", "Kuzminova");
+  /**
+   * 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);
 
-		// Add new Person records
-		repository.save(peter);
-		repository.save(nasta);
+    Person peter = new Person("Peter", "Sagan");
+    Person nasta = new Person("Nasta", "Kuzminova");
 
-		// Count Person records
-		System.out.println("Count Person records: " + repository.count());
+    // Add new Person records
+    repository.save(peter);
+    repository.save(nasta);
 
-		// Print all records
-		List persons = (List) repository.findAll();
-		for (Person person : persons) {
-			System.out.println(person);
-		}
+    // Count Person records
+    System.out.println("Count Person records: " + repository.count());
 
-		// Find Person by surname
-		System.out.println("Find by surname 'Sagan': "	+ repository.findBySurname("Sagan"));
+    // Print all records
+    List persons = (List) repository.findAll();
+    for (Person person : persons) {
+      System.out.println(person);
+    }
 
-		// Update Person
-		nasta.setName("Barbora");
-		nasta.setSurname("Spotakova");
-		repository.save(nasta);
+    // Find Person by surname
+    System.out.println("Find by surname 'Sagan': " + repository.findBySurname("Sagan"));
 
-		System.out.println("Find by id 2: " + repository.findOne(2L));
+    // Update Person
+    nasta.setName("Barbora");
+    nasta.setSurname("Spotakova");
+    repository.save(nasta);
 
-		// Remove record from Person
-		repository.delete(2L);
+    System.out.println("Find by id 2: " + repository.findOne(2L));
 
-		// And finally count records
-		System.out.println("Count Person records: " + repository.count());
+    // Remove record from Person
+    repository.delete(2L);
 
-		context.close();
-	}
+    // And finally count records
+    System.out.println("Count Person records: " + repository.count());
+
+    context.close();
+  }
 }
diff --git a/repository/src/main/java/com/iluwatar/repository/Person.java b/repository/src/main/java/com/iluwatar/repository/Person.java
index 85d647b1a..97d5e7120 100644
--- a/repository/src/main/java/com/iluwatar/repository/Person.java
+++ b/repository/src/main/java/com/iluwatar/repository/Person.java
@@ -12,47 +12,45 @@ import javax.persistence.Id;
 @Entity
 public class Person {
 
-	@Id
-	@GeneratedValue
-	private Long id;
-	private String name;
-	private String surname;
+  @Id
+  @GeneratedValue
+  private Long id;
+  private String name;
+  private String surname;
 
-	public Person() {
-	}
+  public Person() {}
 
-	public Person(String name, String surname) {
-		this.name = name;
-		this.surname = surname;
-	}
+  public Person(String name, String surname) {
+    this.name = name;
+    this.surname = surname;
+  }
 
-	public Long getId() {
-		return id;
-	}
+  public Long getId() {
+    return id;
+  }
 
-	public void setId(Long id) {
-		this.id = id;
-	}
+  public void setId(Long id) {
+    this.id = id;
+  }
 
-	public String getName() {
-		return name;
-	}
+  public String getName() {
+    return name;
+  }
 
-	public void setName(String name) {
-		this.name = name;
-	}
+  public void setName(String name) {
+    this.name = name;
+  }
 
-	public String getSurname() {
-		return surname;
-	}
+  public String getSurname() {
+    return surname;
+  }
 
-	public void setSurname(String surname) {
-		this.surname = surname;
-	}
+  public void setSurname(String surname) {
+    this.surname = surname;
+  }
 
-	@Override
-	public String toString() {
-		return "Person [id=" + id + ", name=" + name + ", surname=" + surname
-				+ "]";
-	}
+  @Override
+  public String toString() {
+    return "Person [id=" + id + ", name=" + name + ", surname=" + surname + "]";
+  }
 }
diff --git a/repository/src/main/java/com/iluwatar/repository/PersonRepository.java b/repository/src/main/java/com/iluwatar/repository/PersonRepository.java
index fd20bc94c..167b40d19 100644
--- a/repository/src/main/java/com/iluwatar/repository/PersonRepository.java
+++ b/repository/src/main/java/com/iluwatar/repository/PersonRepository.java
@@ -12,6 +12,6 @@ import org.springframework.stereotype.Repository;
  */
 @Repository
 public interface PersonRepository extends CrudRepository {
-	
-	public List findBySurname(String surname);
+
+  public List findBySurname(String surname);
 }
diff --git a/repository/src/test/java/com/iluwatar/repository/AppTest.java b/repository/src/test/java/com/iluwatar/repository/AppTest.java
index 14f597045..929f61941 100644
--- a/repository/src/test/java/com/iluwatar/repository/AppTest.java
+++ b/repository/src/test/java/com/iluwatar/repository/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.repository.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
index 141aea4ec..32cd3792e 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/App.java
@@ -2,43 +2,40 @@ package com.iluwatar.resource.acquisition.is.initialization;
 
 /**
  * 
- * Resource Acquisition Is Initialization pattern was developed
- * for exception safe resource management by C++ creator Bjarne
- * Stroustrup.
+ * 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 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 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.
+ * 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 {
-	
-	/**
-	 * Program entry point
-	 * @param args command line args
-	 * @throws Exception
-	 */
-	public static void main( String[] args ) throws Exception {
-		
-    	try (SlidingDoor slidingDoor = new SlidingDoor()) {
-    		System.out.println("Walking in.");
-    	}
-    	
-    	try (TreasureChest treasureChest = new TreasureChest()) {
-    		System.out.println("Looting contents.");
-    	}
+
+  /**
+   * Program entry point
+   * 
+   * @param args command line args
+   * @throws Exception
+   */
+  public static void main(String[] args) throws Exception {
+
+    try (SlidingDoor slidingDoor = new SlidingDoor()) {
+      System.out.println("Walking in.");
     }
+
+    try (TreasureChest treasureChest = new TreasureChest()) {
+      System.out.println("Looting contents.");
+    }
+  }
 }
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
index 2033707e6..985b761c2 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/SlidingDoor.java
@@ -7,12 +7,12 @@ package com.iluwatar.resource.acquisition.is.initialization;
  */
 public class SlidingDoor implements AutoCloseable {
 
-	public SlidingDoor() {
-		System.out.println("Sliding door opens.");
-	}
-	
-	@Override
-	public void close() throws Exception {
-		System.out.println("Sliding door closes.");
-	}
+  public SlidingDoor() {
+    System.out.println("Sliding door opens.");
+  }
+
+  @Override
+  public void close() throws Exception {
+    System.out.println("Sliding door closes.");
+  }
 }
diff --git a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
index 4d6b1a863..525e69652 100644
--- a/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
+++ b/resource-acquisition-is-initialization/src/main/java/com/iluwatar/resource/acquisition/is/initialization/TreasureChest.java
@@ -10,12 +10,12 @@ import java.io.IOException;
  */
 public class TreasureChest implements Closeable {
 
-	public TreasureChest() {
-		System.out.println("Treasure chest opens.");
-	}
-	
-	@Override
-	public void close() throws IOException {
-		System.out.println("Treasure chest closes.");
-	}
+  public TreasureChest() {
+    System.out.println("Treasure chest opens.");
+  }
+
+  @Override
+  public void close() throws IOException {
+    System.out.println("Treasure chest closes.");
+  }
 }
diff --git a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
index e20815c3f..2859f74ba 100644
--- a/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
+++ b/resource-acquisition-is-initialization/src/test/java/com/iluwatar/resource/acquisition/is/initialization/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.resource.acquisition.is.initialization.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() throws Exception {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() throws Exception {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/servant/src/main/java/com/iluwatar/servant/App.java b/servant/src/main/java/com/iluwatar/servant/App.java
index 832d3d52c..42babbc1d 100644
--- a/servant/src/main/java/com/iluwatar/servant/App.java
+++ b/servant/src/main/java/com/iluwatar/servant/App.java
@@ -4,55 +4,56 @@ import java.util.ArrayList;
 
 
 /**
- * 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.
+ * 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 {
-	
-    static Servant jenkins = new Servant("Jenkins");
-    static Servant travis = new Servant("Travis");
 
-    /**
-     * Program entry point
-     * @param args
-     */
-    public static void main(String[] args) {
-        scenario(jenkins, 1);
-        scenario(travis, 0);
-    }
+  static Servant jenkins = new Servant("Jenkins");
+  static Servant travis = new Servant("Travis");
 
-    /*
-     * 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();
+  /**
+   * Program entry point
+   * 
+   * @param args
+   */
+  public static void main(String[] args) {
+    scenario(jenkins, 1);
+    scenario(travis, 0);
+  }
 
-        ArrayList guests = new ArrayList<>();
-        guests.add(k);
-        guests.add(q);
+  /*
+   * 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();
 
-        //feed
-        servant.feed(k);
-        servant.feed(q);
-        //serve drinks
-        servant.giveWine(k);
-        servant.giveWine(q);
-        //compliment
-        servant.GiveCompliments(guests.get(compliment));
+    ArrayList guests = new ArrayList<>();
+    guests.add(k);
+    guests.add(q);
 
-        //outcome of the night
-        for (Royalty r : guests)
-            r.changeMood();
+    // feed
+    servant.feed(k);
+    servant.feed(q);
+    // serve drinks
+    servant.giveWine(k);
+    servant.giveWine(q);
+    // compliment
+    servant.GiveCompliments(guests.get(compliment));
 
-        //check your luck
-        if (servant.checkIfYouWillBeHanged(guests))
-            System.out.println(servant.name + " will live another day");
-        else
-            System.out.println("Poor " + servant.name + ". His days are numbered");
-    }
+    // outcome of the night
+    for (Royalty r : guests)
+      r.changeMood();
+
+    // check your luck
+    if (servant.checkIfYouWillBeHanged(guests))
+      System.out.println(servant.name + " will live another day");
+    else
+      System.out.println("Poor " + servant.name + ". His days are numbered");
+  }
 }
diff --git a/servant/src/main/java/com/iluwatar/servant/King.java b/servant/src/main/java/com/iluwatar/servant/King.java
index 29ec88192..5e931c149 100644
--- a/servant/src/main/java/com/iluwatar/servant/King.java
+++ b/servant/src/main/java/com/iluwatar/servant/King.java
@@ -6,34 +6,36 @@ package com.iluwatar.servant;
  *
  */
 public class King implements Royalty {
-	
-    private boolean isDrunk;
-    private boolean isHungry = true;
-    private boolean isHappy;
-    private boolean complimentReceived;
 
-    @Override
-    public void getFed() {
-        isHungry = false;
-    }
+  private boolean isDrunk;
+  private boolean isHungry = true;
+  private boolean isHappy;
+  private boolean complimentReceived;
 
-    @Override
-    public void getDrink() {
-        isDrunk = true;
-    }
+  @Override
+  public void getFed() {
+    isHungry = false;
+  }
 
-    public void receiveCompliments() {
-        complimentReceived = true;
-    }
+  @Override
+  public void getDrink() {
+    isDrunk = true;
+  }
 
-    @Override
-    public void changeMood() {
-        if (!isHungry && isDrunk) isHappy = true;
-        if (complimentReceived) isHappy = false;
-    }
+  public void receiveCompliments() {
+    complimentReceived = true;
+  }
 
-    @Override
-    public boolean getMood() {
-        return isHappy;
-    }
+  @Override
+  public void changeMood() {
+    if (!isHungry && isDrunk)
+      isHappy = true;
+    if (complimentReceived)
+      isHappy = false;
+  }
+
+  @Override
+  public boolean getMood() {
+    return isHappy;
+  }
 }
diff --git a/servant/src/main/java/com/iluwatar/servant/Queen.java b/servant/src/main/java/com/iluwatar/servant/Queen.java
index 815106725..db5446d34 100644
--- a/servant/src/main/java/com/iluwatar/servant/Queen.java
+++ b/servant/src/main/java/com/iluwatar/servant/Queen.java
@@ -6,39 +6,40 @@ package com.iluwatar.servant;
  *
  */
 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;
-    }
+  private boolean isDrunk = true;
+  private boolean isHungry;
+  private boolean isHappy;
+  private boolean isFlirty = true;
+  private boolean complimentReceived;
 
-    @Override
-    public void getDrink() {
-        isDrunk = true;
-    }
+  @Override
+  public void getFed() {
+    isHungry = false;
+  }
 
-    public void receiveCompliments() {
-        complimentReceived = true;
-    }
+  @Override
+  public void getDrink() {
+    isDrunk = true;
+  }
 
-    @Override
-    public void changeMood() {
-        if (complimentReceived && isFlirty && isDrunk) isHappy = true;
-    }
+  public void receiveCompliments() {
+    complimentReceived = true;
+  }
 
-    @Override
-    public boolean getMood() {
-        return isHappy;
-    }
+  @Override
+  public void changeMood() {
+    if (complimentReceived && isFlirty && isDrunk)
+      isHappy = true;
+  }
 
-    public void setFlirtiness(boolean f) {
-        this.isFlirty = f;
-    }
+  @Override
+  public boolean getMood() {
+    return isHappy;
+  }
+
+  public void setFlirtiness(boolean f) {
+    this.isFlirty = f;
+  }
 
 }
diff --git a/servant/src/main/java/com/iluwatar/servant/Royalty.java b/servant/src/main/java/com/iluwatar/servant/Royalty.java
index 543ffd8d5..38a0a8e7d 100644
--- a/servant/src/main/java/com/iluwatar/servant/Royalty.java
+++ b/servant/src/main/java/com/iluwatar/servant/Royalty.java
@@ -7,13 +7,13 @@ package com.iluwatar.servant;
  */
 interface Royalty {
 
-    void getFed();
+  void getFed();
 
-    void getDrink();
+  void getDrink();
 
-    void changeMood();
+  void changeMood();
 
-    void receiveCompliments();
+  void receiveCompliments();
 
-    boolean getMood();
+  boolean getMood();
 }
diff --git a/servant/src/main/java/com/iluwatar/servant/Servant.java b/servant/src/main/java/com/iluwatar/servant/Servant.java
index 8e61333d8..987bf8791 100644
--- a/servant/src/main/java/com/iluwatar/servant/Servant.java
+++ b/servant/src/main/java/com/iluwatar/servant/Servant.java
@@ -8,30 +8,31 @@ import java.util.ArrayList;
  *
  */
 public class Servant {
-	
-	public String name;
-	
-	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();
-	}
-	
-	public boolean checkIfYouWillBeHanged(ArrayList tableGuests){
-		boolean anotherDay = true;
-		for( Royalty r : tableGuests )
-			if( !r.getMood() ) anotherDay = false;
-			
-		return anotherDay;
-	}
+  public String name;
+
+  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();
+  }
+
+  public boolean checkIfYouWillBeHanged(ArrayList tableGuests) {
+    boolean anotherDay = true;
+    for (Royalty r : tableGuests)
+      if (!r.getMood())
+        anotherDay = false;
+
+    return anotherDay;
+  }
 }
diff --git a/servant/src/test/java/com/iluwatar/servant/AppTest.java b/servant/src/test/java/com/iluwatar/servant/AppTest.java
index 94a12b207..d5a404291 100644
--- a/servant/src/test/java/com/iluwatar/servant/AppTest.java
+++ b/servant/src/test/java/com/iluwatar/servant/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.servant.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
index 47eb5231e..a7053165d 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/app/App.java
@@ -16,161 +16,163 @@ import com.iluwatar.servicelayer.wizard.WizardDaoImpl;
 
 
 /**
- * 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.
+ * 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.
+ * 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.
+ * 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 {
-	
-	/**
-	 * 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();
+
+  /**
+   * 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();
+  }
+
+  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);
+  }
+
+  public static void queryData() {
+    MagicService service =
+        new MagicServiceImpl(new WizardDaoImpl(), new SpellbookDaoImpl(), new SpellDaoImpl());
+    System.out.println("Enumerating all wizards");
+    for (Wizard w : service.findAllWizards()) {
+      System.out.println(w.getName());
     }
-    
-    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);
+    System.out.println("Enumerating all spellbooks");
+    for (Spellbook s : service.findAllSpellbooks()) {
+      System.out.println(s.getName());
     }
-    
-    public static void queryData() {
-    	MagicService service = new MagicServiceImpl(new WizardDaoImpl(), new SpellbookDaoImpl(), new SpellDaoImpl());
-    	System.out.println("Enumerating all wizards");
-    	for (Wizard w: service.findAllWizards()) {
-    		System.out.println(w.getName());
-    	}
-    	System.out.println("Enumerating all spellbooks");
-    	for (Spellbook s: service.findAllSpellbooks()) {
-    		System.out.println(s.getName());
-    	}
-    	System.out.println("Enumerating all spells");
-    	for (Spell s: service.findAllSpells()) {
-    		System.out.println(s.getName());
-    	}
-    	System.out.println("Find wizards with spellbook 'Book of Idores'");
-    	List wizardsWithSpellbook = service.findWizardsWithSpellbook("Book of Idores");
-    	for (Wizard w: wizardsWithSpellbook) {
-    		System.out.println(String.format("%s has 'Book of Idores'", w.getName()));
-    	}
-    	System.out.println("Find wizards with spell 'Fireball'");
-    	List wizardsWithSpell = service.findWizardsWithSpell("Fireball");
-    	for (Wizard w: wizardsWithSpell) {
-    		System.out.println(String.format("%s has 'Fireball'", w.getName()));
-    	}
+    System.out.println("Enumerating all spells");
+    for (Spell s : service.findAllSpells()) {
+      System.out.println(s.getName());
     }
+    System.out.println("Find wizards with spellbook 'Book of Idores'");
+    List wizardsWithSpellbook = service.findWizardsWithSpellbook("Book of Idores");
+    for (Wizard w : wizardsWithSpellbook) {
+      System.out.println(String.format("%s has 'Book of Idores'", w.getName()));
+    }
+    System.out.println("Find wizards with spell 'Fireball'");
+    List wizardsWithSpell = service.findWizardsWithSpell("Fireball");
+    for (Wizard w : wizardsWithSpell) {
+      System.out.println(String.format("%s has 'Fireball'", w.getName()));
+    }
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java b/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java
index ec0f8e197..d8c796427 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/common/BaseEntity.java
@@ -11,9 +11,9 @@ import javax.persistence.Version;
  *
  */
 @MappedSuperclass
-@Inheritance(strategy=InheritanceType.TABLE_PER_CLASS)
+@Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
 public class BaseEntity {
-	
-	@Version
-	private Long version;
+
+  @Version
+  private Long version;
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java
index e1851b16f..73fa3b7af 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/common/Dao.java
@@ -11,13 +11,13 @@ import java.util.List;
  */
 public interface Dao {
 
-	E find(Long id);
-	
-	void persist(E entity);
-	
-	E merge(E entity);
-	
-	void delete(E entity);
-	
-	List findAll();
+  E find(Long id);
+
+  void persist(E entity);
+
+  E merge(E entity);
+
+  void delete(E entity);
+
+  List findAll();
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java
index bc0116dac..eae9286fa 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/common/DaoBaseImpl.java
@@ -18,110 +18,105 @@ import com.iluwatar.servicelayer.hibernate.HibernateUtil;
  * 
  */
 public abstract class DaoBaseImpl implements Dao {
-	
-	@SuppressWarnings("unchecked")
-	protected Class persistentClass = (Class) ((ParameterizedType) getClass()
-            .getGenericSuperclass()).getActualTypeArguments()[0];
 
-	protected Session getSession() {
-		return HibernateUtil.getSessionFactory().openSession();
-	}
-	
-	@Override
-	public E find(Long id) {
-		Session session = getSession();
-		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 = getSession();
-		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 = getSession();
-		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 = getSession();
-		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 = getSession();
-		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;
-	}
+  @SuppressWarnings("unchecked")
+  protected Class persistentClass = (Class) ((ParameterizedType) getClass()
+      .getGenericSuperclass()).getActualTypeArguments()[0];
+
+  protected Session getSession() {
+    return HibernateUtil.getSessionFactory().openSession();
+  }
+
+  @Override
+  public E find(Long id) {
+    Session session = getSession();
+    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 = getSession();
+    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 = getSession();
+    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 = getSession();
+    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 = getSession();
+    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;
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
index 61d0f5d5d..9d1aec488 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/hibernate/HibernateUtil.java
@@ -14,27 +14,25 @@ import com.iluwatar.servicelayer.wizard.Wizard;
  */
 public class HibernateUtil {
 
-	private static final SessionFactory sessionFactory;
+  private static final SessionFactory sessionFactory;
 
-	static {
-		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", "true")
-	  	  		.setProperty("hibernate.hbm2ddl.auto", "create-drop")
-	  	  		.buildSessionFactory();
-		} catch (Throwable ex) {
-			System.err.println("Initial SessionFactory creation failed." + ex);
-			throw new ExceptionInInitializerError(ex);
-		}
-	}
+  static {
+    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", "true")
+              .setProperty("hibernate.hbm2ddl.auto", "create-drop").buildSessionFactory();
+    } catch (Throwable ex) {
+      System.err.println("Initial SessionFactory creation failed." + ex);
+      throw new ExceptionInInitializerError(ex);
+    }
+  }
 
-	public static SessionFactory getSessionFactory() {
-		return sessionFactory;
-	}
+  public static SessionFactory getSessionFactory() {
+    return sessionFactory;
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
index 38742c78d..26f732aa8 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicService.java
@@ -14,13 +14,13 @@ import com.iluwatar.servicelayer.wizard.Wizard;
  */
 public interface MagicService {
 
-	List findAllWizards();
+  List findAllWizards();
 
-	List findAllSpellbooks();
-	
-	List findAllSpells();
+  List findAllSpellbooks();
 
-	List findWizardsWithSpellbook(String name);
+  List findAllSpells();
 
-	List findWizardsWithSpell(String name);
+  List findWizardsWithSpellbook(String name);
+
+  List findWizardsWithSpell(String name);
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
index 37249894a..f46f55184 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/magic/MagicServiceImpl.java
@@ -16,42 +16,42 @@ import com.iluwatar.servicelayer.wizard.WizardDao;
  *
  */
 public class MagicServiceImpl implements MagicService {
-	
-	private WizardDao wizardDao;
-	private SpellbookDao spellbookDao;
-	private SpellDao spellDao;
 
-	public MagicServiceImpl(WizardDao wizardDao, SpellbookDao spellbookDao, SpellDao spellDao) {
-		this.wizardDao = wizardDao;
-		this.spellbookDao = spellbookDao;
-		this.spellDao = spellDao;
-	}
+  private WizardDao wizardDao;
+  private SpellbookDao spellbookDao;
+  private SpellDao spellDao;
 
-	@Override
-	public List findAllWizards() {
-		return wizardDao.findAll();
-	}
+  public MagicServiceImpl(WizardDao wizardDao, SpellbookDao spellbookDao, SpellDao spellDao) {
+    this.wizardDao = wizardDao;
+    this.spellbookDao = spellbookDao;
+    this.spellDao = spellDao;
+  }
 
-	@Override
-	public List findAllSpellbooks() {
-		return spellbookDao.findAll();
-	}
+  @Override
+  public List findAllWizards() {
+    return wizardDao.findAll();
+  }
 
-	@Override
-	public List findAllSpells() {
-		return spellDao.findAll();
-	}
+  @Override
+  public List findAllSpellbooks() {
+    return spellbookDao.findAll();
+  }
 
-	@Override
-	public List findWizardsWithSpellbook(String name) {
-		Spellbook spellbook = spellbookDao.findByName(name);
-		return new ArrayList(spellbook.getWizards());
-	}
+  @Override
+  public List findAllSpells() {
+    return spellDao.findAll();
+  }
 
-	@Override
-	public List findWizardsWithSpell(String name) {
-		Spell spell = spellDao.findByName(name);
-		Spellbook spellbook = spell.getSpellbook();
-		return new ArrayList(spellbook.getWizards());
-	}
+  @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());
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
index ed166eccc..a3e9e28c4 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/Spell.java
@@ -17,54 +17,53 @@ import com.iluwatar.servicelayer.spellbook.Spellbook;
  *
  */
 @Entity
-@Table(name="SPELL")
+@Table(name = "SPELL")
 public class Spell extends BaseEntity {
-	
-	private String name;
-	
-	public Spell() {
-	}
-	
-	public Spell(String name) {
-		this();
-		this.name = name;
-	}
 
-	@Id
-	@GeneratedValue
-	@Column(name = "SPELL_ID")
-	private Long id;
+  private String name;
 
-	public Long getId() {
-		return id;
-	}
+  public Spell() {}
 
-	public void setId(Long id) {
-		this.id = id;
-	}
-	
-	@ManyToOne
-	@JoinColumn(name="SPELLBOOK_ID_FK", referencedColumnName="SPELLBOOK_ID")
-	private Spellbook spellbook;
-	
-	public String getName() {
-		return name;
-	}
+  public Spell(String name) {
+    this();
+    this.name = name;
+  }
 
-	public void setName(String name) {
-		this.name = name;
-	}
-	
-	public Spellbook getSpellbook() {
-		return spellbook;
-	}
+  @Id
+  @GeneratedValue
+  @Column(name = "SPELL_ID")
+  private Long id;
 
-	public void setSpellbook(Spellbook spellbook) {
-		this.spellbook = spellbook;
-	}
+  public Long getId() {
+    return id;
+  }
 
-	@Override
-	public String toString() {
-		return name;
-	}	
+  public void setId(Long id) {
+    this.id = id;
+  }
+
+  @ManyToOne
+  @JoinColumn(name = "SPELLBOOK_ID_FK", referencedColumnName = "SPELLBOOK_ID")
+  private Spellbook spellbook;
+
+  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;
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
index a59307e7f..b6bffb0ec 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDao.java
@@ -8,7 +8,7 @@ import com.iluwatar.servicelayer.common.Dao;
  *
  */
 public interface SpellDao extends Dao {
-	
-	Spell findByName(String name);
+
+  Spell findByName(String name);
 
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
index d278defe2..f5f017625 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spell/SpellDaoImpl.java
@@ -14,26 +14,25 @@ import com.iluwatar.servicelayer.common.DaoBaseImpl;
  */
 public class SpellDaoImpl extends DaoBaseImpl implements SpellDao {
 
-	@Override
-	public Spell findByName(String name) {
-		Session session = getSession();
-		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();
-			result.getSpellbook().getWizards().size();
-			tx.commit();
-		}
-		catch (Exception e) {
-			if (tx!=null) tx.rollback();
-			throw e;
-		}
-		finally {
-			session.close();
-		}		
-		return result;
-	}
+  @Override
+  public Spell findByName(String name) {
+    Session session = getSession();
+    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();
+      result.getSpellbook().getWizards().size();
+      tx.commit();
+    } catch (Exception e) {
+      if (tx != null)
+        tx.rollback();
+      throw e;
+    } finally {
+      session.close();
+    }
+    return result;
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
index c596c9926..49d81a955 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/Spellbook.java
@@ -22,71 +22,71 @@ import com.iluwatar.servicelayer.wizard.Wizard;
  *
  */
 @Entity
-@Table(name="SPELLBOOK")
+@Table(name = "SPELLBOOK")
 public class Spellbook extends BaseEntity {
-	
-	public Spellbook() {
-		spells = new HashSet();
-		wizards = new HashSet();
-	}
-	
-	public Spellbook(String name) {
-		this();
-		this.name = name;
-	}
 
-	@Id
-	@GeneratedValue
-	@Column(name = "SPELLBOOK_ID")
-	private Long id;
+  public Spellbook() {
+    spells = new HashSet();
+    wizards = new HashSet();
+  }
 
-	public Long getId() {
-		return id;
-	}
+  public Spellbook(String name) {
+    this();
+    this.name = name;
+  }
 
-	public void setId(Long id) {
-		this.id = id;
-	}
-	
-	private String name;
+  @Id
+  @GeneratedValue
+  @Column(name = "SPELLBOOK_ID")
+  private Long id;
 
-	@ManyToMany(mappedBy = "spellbooks")
-	private Set wizards;
+  public Long getId() {
+    return id;
+  }
 
-	@OneToMany(mappedBy = "spellbook", orphanRemoval = true, cascade = CascadeType.ALL)
-	private Set spells;
-	
-	public String getName() {
-		return name;
-	}
+  public void setId(Long id) {
+    this.id = id;
+  }
 
-	public void setName(String name) {
-		this.name = name;
-	}
+  private String name;
 
-	public Set getWizards() {
-		return wizards;
-	}
+  @ManyToMany(mappedBy = "spellbooks")
+  private Set wizards;
 
-	public void setWizards(Set wizards) {
-		this.wizards = wizards;
-	}
+  @OneToMany(mappedBy = "spellbook", orphanRemoval = true, cascade = CascadeType.ALL)
+  private Set spells;
 
-	public Set getSpells() {
-		return spells;
-	}
+  public String getName() {
+    return name;
+  }
 
-	public void setSpells(Set spells) {
-		this.spells = spells;
-	}
+  public void setName(String name) {
+    this.name = name;
+  }
 
-	public void addSpell(Spell spell) {
-		spell.setSpellbook(this);
-		spells.add(spell);
-	}
-	
-	@Override
-	public String toString() {
-		return 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;
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java
index 9731cdf2e..e39e14175 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDao.java
@@ -8,7 +8,7 @@ import com.iluwatar.servicelayer.common.Dao;
  *
  */
 public interface SpellbookDao extends Dao {
-	
-	Spellbook findByName(String name);
+
+  Spellbook findByName(String name);
 
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java
index 5ab604621..1de82d4a9 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/spellbook/SpellbookDaoImpl.java
@@ -14,28 +14,27 @@ import com.iluwatar.servicelayer.common.DaoBaseImpl;
  */
 public class SpellbookDaoImpl extends DaoBaseImpl implements SpellbookDao {
 
-	@Override
-	public Spellbook findByName(String name) {
-		Session session = getSession();
-		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;
-	}
+  @Override
+  public Spellbook findByName(String name) {
+    Session session = getSession();
+    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;
+  }
 
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java
index 10f811a3c..bfe8e46af 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/Wizard.java
@@ -20,59 +20,59 @@ import com.iluwatar.servicelayer.spellbook.Spellbook;
  *
  */
 @Entity
-@Table(name="WIZARD")
+@Table(name = "WIZARD")
 public class Wizard extends BaseEntity {
-	
-	public Wizard() {
-		spellbooks = new HashSet();
-	}
-	
-	public Wizard(String name) {
-		this();
-		this.name = name;
-	}
 
-	@Id
-	@GeneratedValue
-	@Column(name = "WIZARD_ID")
-	private Long id;
+  public Wizard() {
+    spellbooks = new HashSet();
+  }
 
-	public Long getId() {
-		return id;
-	}
+  public Wizard(String name) {
+    this();
+    this.name = name;
+  }
 
-	public void setId(Long id) {
-		this.id = id;
-	}
-	
-	private String name;
+  @Id
+  @GeneratedValue
+  @Column(name = "WIZARD_ID")
+  private Long id;
 
-	@ManyToMany(cascade = CascadeType.ALL)
-	private Set spellbooks;
-	
-	public String getName() {
-		return name;
-	}
+  public Long getId() {
+    return id;
+  }
 
-	public void setName(String name) {
-		this.name = name;
-	}
+  public void setId(Long id) {
+    this.id = id;
+  }
 
-	public Set getSpellbooks() {
-		return spellbooks;
-	}
+  private String name;
 
-	public void setSpellbooks(Set spellbooks) {
-		this.spellbooks = spellbooks;
-	}
+  @ManyToMany(cascade = CascadeType.ALL)
+  private Set spellbooks;
 
-	public void addSpellbook(Spellbook spellbook) {
-		spellbook.getWizards().add(this);
-		spellbooks.add(spellbook);
-	}
-	
-	@Override
-	public String toString() {
-		return name;
-	}	
+  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;
+  }
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java
index f4f415d2f..fc0f7135a 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDao.java
@@ -8,7 +8,7 @@ import com.iluwatar.servicelayer.common.Dao;
  *
  */
 public interface WizardDao extends Dao {
-	
-	Wizard findByName(String name);
+
+  Wizard findByName(String name);
 
 }
diff --git a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java
index 28c3da85b..ad89dd28a 100644
--- a/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java
+++ b/service-layer/src/main/java/com/iluwatar/servicelayer/wizard/WizardDaoImpl.java
@@ -15,28 +15,27 @@ import com.iluwatar.servicelayer.spellbook.Spellbook;
  */
 public class WizardDaoImpl extends DaoBaseImpl implements WizardDao {
 
-	@Override
-	public Wizard findByName(String name) {
-		Session session = getSession();
-		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;
-	}
+  @Override
+  public Wizard findByName(String name) {
+    Session session = getSession();
+    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;
+  }
 }
diff --git a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
index bbf476c0b..2a6202104 100644
--- a/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
+++ b/service-layer/src/test/java/com/iluwatar/servicelayer/app/AppTest.java
@@ -10,10 +10,10 @@ import com.iluwatar.servicelayer.app.App;
  *
  */
 public class AppTest {
-	
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
index 5b6615495..d596e7638 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/App.java
@@ -2,31 +2,33 @@ 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.
+ * 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.
+ * 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();
-    }
+
+  /**
+   * 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();
+  }
 }
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java b/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
index 64b65ea1d..f30baf771 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/InitContext.java
@@ -1,29 +1,29 @@
 package com.iluwatar.servicelocator;
 
 /**
- * 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
+ * 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 {
 
-    /**
-     * 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")) {
-            System.out.println("Looking up service A and creating new service for A");
-            return new ServiceImpl("jndi/serviceA");
-        } else if (serviceName.equals("jndi/serviceB")) {
-            System.out.println("Looking up service B and creating new service for B");
-            return new ServiceImpl("jndi/serviceB");
-        } else {
-            return null;
-        }
+  /**
+   * 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")) {
+      System.out.println("Looking up service A and creating new service for A");
+      return new ServiceImpl("jndi/serviceA");
+    } else if (serviceName.equals("jndi/serviceB")) {
+      System.out.println("Looking up service B and creating new service for B");
+      return new ServiceImpl("jndi/serviceB");
+    } else {
+      return null;
     }
+  }
 }
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java b/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java
index 4831add95..ef26dbb93 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/Service.java
@@ -1,29 +1,26 @@
 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
    • 
+ * 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();
+
+  /*
+   * 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();
 }
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
index c48e4c7af..0a44a5d7f 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceCache.java
@@ -4,44 +4,45 @@ 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
+ * 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 final Map serviceCache;
+  private final Map serviceCache;
 
-    public ServiceCache() {
-        serviceCache = new HashMap();
-    }
+  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);
-                System.out.println("(cache call) Fetched service " + cachedService.getName() + "(" + cachedService.getId() + ") from cache... !");
-            }
-        }
-        return cachedService;
+  /**
+   * 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);
+        System.out.println("(cache call) Fetched service " + cachedService.getName() + "("
+            + cachedService.getId() + ") from cache... !");
+      }
     }
+    return cachedService;
+  }
 
-    /**
-     * Adds the service into the cache map
-     *
-     * @param newService a {@link Service}
-     */
-    public void addService(Service newService) {
-        serviceCache.put(newService.getName(), newService);
-    }
+  /**
+   * Adds the service into the cache map
+   *
+   * @param newService a {@link Service}
+   */
+  public void addService(Service newService) {
+    serviceCache.put(newService.getName(), newService);
+  }
 }
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
index ec7ab215b..f2d338cdc 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceImpl.java
@@ -1,37 +1,37 @@
 package com.iluwatar.servicelocator;
 
 /**
- * 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
+ * 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 final String serviceName;
-    private final int id;
+  private final String serviceName;
+  private final int id;
 
-    public ServiceImpl(String serviceName) {
-        // set the service name
-        this.serviceName = serviceName;
+  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;
-    }
+    // 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 String getName() {
+    return serviceName;
+  }
 
-    @Override
-    public int getId() {
-        return id;
-    }
+  @Override
+  public int getId() {
+    return id;
+  }
 
-    @Override
-    public void execute() {
-        System.out.println("Service " + getName() + " is now executing with id " + getId());
-    }
+  @Override
+  public void execute() {
+    System.out.println("Service " + getName() + " is now executing with id " + getId());
+  }
 }
diff --git a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
index 95df24926..6df74f84e 100644
--- a/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
+++ b/service-locator/src/main/java/com/iluwatar/servicelocator/ServiceLocator.java
@@ -1,36 +1,36 @@
 package com.iluwatar.servicelocator;
 
 /**
- * The service locator module.
- * Will fetch service from cache, otherwise creates a fresh service and update cache
+ * The service locator module. Will fetch service from cache, otherwise creates a fresh service and
+ * update cache
  *
  * @author saifasif
  */
 public class ServiceLocator {
 
-    private static ServiceCache serviceCache = new ServiceCache();
+  private static ServiceCache serviceCache = new ServiceCache();
 
-    /**
-     * 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);
-            serviceCache.addService(serviceObj);
-            return serviceObj;
-        }
+  /**
+   * 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);
+      serviceCache.addService(serviceObj);
+      return serviceObj;
     }
+  }
 }
diff --git a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
index 90e091905..ab1549182 100644
--- a/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
+++ b/service-locator/src/test/java/com/iluwatar/servicelocator/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.servicelocator.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/App.java b/singleton/src/main/java/com/iluwatar/singleton/App.java
index 7566c9c4d..6d4fd9468 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/App.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/App.java
@@ -1,35 +1,40 @@
 package com.iluwatar.singleton;
 
 /**
- * Singleton pattern ensures that the class can have only one existing instance per Java classloader instance 
- * and provides global access to it.
+ * 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.
+ * 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.
+ * 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
+ * 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.
+ * {@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.
+ * 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.
+ * 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 {
 
@@ -47,10 +52,10 @@ public class App {
     System.out.println("ivoryTower2=" + ivoryTower2);
 
     // lazily initialized singleton
-    ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 = ThreadSafeLazyLoadedIvoryTower
-            .getInstance();
-    ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 = ThreadSafeLazyLoadedIvoryTower
-            .getInstance();
+    ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower1 =
+        ThreadSafeLazyLoadedIvoryTower.getInstance();
+    ThreadSafeLazyLoadedIvoryTower threadSafeIvoryTower2 =
+        ThreadSafeLazyLoadedIvoryTower.getInstance();
     System.out.println("threadSafeIvoryTower1=" + threadSafeIvoryTower1);
     System.out.println("threadSafeIvoryTower2=" + threadSafeIvoryTower2);
 
@@ -65,13 +70,13 @@ public class App {
     System.out.println(dcl1);
     ThreadSafeDoubleCheckLocking dcl2 = ThreadSafeDoubleCheckLocking.getInstance();
     System.out.println(dcl2);
-    
+
     // initialize on demand holder idiom
     InitializingOnDemandHolderIdiom demandHolderIdiom =
-            InitializingOnDemandHolderIdiom.getInstance();
+        InitializingOnDemandHolderIdiom.getInstance();
     System.out.println(demandHolderIdiom);
     InitializingOnDemandHolderIdiom demandHolderIdiom2 =
-            InitializingOnDemandHolderIdiom.getInstance();
+        InitializingOnDemandHolderIdiom.getInstance();
     System.out.println(demandHolderIdiom2);
   }
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
index f39babe45..f07afc137 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/EnumIvoryTower.java
@@ -1,8 +1,7 @@
 package com.iluwatar.singleton;
 
 /**
- * Enum based singleton implementation.
- * Effective Java 2nd Edition (Joshua Bloch) p. 18
+ * Enum based singleton implementation. Effective Java 2nd Edition (Joshua Bloch) p. 18
  */
 public enum EnumIvoryTower {
 
diff --git a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
index 88738b8ca..9ffd56ed1 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/InitializingOnDemandHolderIdiom.java
@@ -3,13 +3,12 @@ package com.iluwatar.singleton;
 import java.io.Serializable;
 
 /**
- * The Initialize-on-demand-holder idiom is a secure way of
- * creating lazy initialized singleton object in Java.
- * refer to "The CERT Oracle Secure Coding Standard for Java"
- * By Dhruv Mohindra, Robert C. Seacord p.378
+ * The Initialize-on-demand-holder idiom is a secure way of creating lazy initialized singleton
+ * object in Java. refer to "The CERT Oracle Secure Coding Standard for Java" By Dhruv Mohindra,
+ * Robert C. Seacord p.378
  * 
    
- * Singleton objects usually are heavy to create and sometimes need to serialize them.
- * This class also shows how to preserve singleton in serialized version of singleton.
+ * Singleton objects usually are heavy to create and sometimes need to serialize them. This class
+ * also shows how to preserve singleton in serialized version of singleton.
  *
  * @author mortezaadi@gmail.com
  */
@@ -17,8 +16,7 @@ public class InitializingOnDemandHolderIdiom implements Serializable {
 
   private static final long serialVersionUID = 1L;
 
-  private InitializingOnDemandHolderIdiom() {
-  }
+  private InitializingOnDemandHolderIdiom() {}
 
   public static InitializingOnDemandHolderIdiom getInstance() {
     return HelperHolder.INSTANCE;
@@ -30,7 +28,7 @@ public class InitializingOnDemandHolderIdiom implements Serializable {
 
   private static class HelperHolder {
     public static final InitializingOnDemandHolderIdiom INSTANCE =
-            new InitializingOnDemandHolderIdiom();
+        new InitializingOnDemandHolderIdiom();
   }
 
 }
diff --git a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
index 7470c3f29..585b11e61 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/IvoryTower.java
@@ -1,9 +1,7 @@
 package com.iluwatar.singleton;
 
 /**
- * Singleton class.
- * Eagerly initialized static instance guarantees thread
- * safety.
+ * Singleton class. Eagerly initialized static instance guarantees thread safety.
  */
 public final class IvoryTower {
 
@@ -15,12 +13,10 @@ public final class IvoryTower {
   /**
    * Private constructor so nobody can instantiate the class.
    */
-  private IvoryTower() {
-  }
+  private IvoryTower() {}
 
   /**
-   * To be called by user to
-   * obtain instance of the class.
+   * To be called by user to obtain instance of the class.
    *
    * @return instance of the singleton.
    */
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
index 26b57d4cf..1aca15b30 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeDoubleCheckLocking.java
@@ -17,7 +17,7 @@ public class ThreadSafeDoubleCheckLocking {
    * private constructor to prevent client from instantiating.
    */
   private ThreadSafeDoubleCheckLocking() {
-    //to prevent instantiating by Reflection call
+    // to prevent instantiating by Reflection call
     if (INSTANCE != null) {
       throw new IllegalStateException("Already initialized.");
     }
@@ -29,8 +29,8 @@ public class ThreadSafeDoubleCheckLocking {
    * @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
+    // local variable increases performance by 25 percent
+    // Joshua Bloch "Effective Java, Second Edition", p. 283-284
     ThreadSafeDoubleCheckLocking result = INSTANCE;
     if (result == null) {
       synchronized (ThreadSafeDoubleCheckLocking.class) {
diff --git a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
index c50c99e65..98281b4c8 100644
--- a/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
+++ b/singleton/src/main/java/com/iluwatar/singleton/ThreadSafeLazyLoadedIvoryTower.java
@@ -1,22 +1,20 @@
 package com.iluwatar.singleton;
 
 /**
- * Thread-safe Singleton class.
- * The instance is lazily initialized and thus needs synchronization
+ * 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
+ * Note: if created by reflection then a singleton will not be created but multiple options in the
+ * same classloader
  */
 public class ThreadSafeLazyLoadedIvoryTower {
 
   private static ThreadSafeLazyLoadedIvoryTower instance = null;
 
-  private ThreadSafeLazyLoadedIvoryTower() {
-  }
+  private ThreadSafeLazyLoadedIvoryTower() {}
 
   /**
-   * The instance gets created only when it is called for first time.
-   * Lazy-loading
+   * The instance gets created only when it is called for first time. Lazy-loading
    */
   public synchronized static ThreadSafeLazyLoadedIvoryTower getInstance() {
 
diff --git a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
index c83232037..4957eec6b 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.singleton.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
index 07f99005e..3afc1bf14 100644
--- a/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
+++ b/singleton/src/test/java/com/iluwatar/singleton/LazyLoadedSingletonThreadSafetyTest.java
@@ -12,68 +12,73 @@ import static org.junit.Assert.assertEquals;
 /**
  * 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.
+ * 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.
  *
  */
 public class LazyLoadedSingletonThreadSafetyTest {
 
-    private static final int NUM_THREADS = 5;
-    private List threadObjects = Collections.synchronizedList(new ArrayList<>());
+  private static final int NUM_THREADS = 5;
+  private List threadObjects = Collections
+      .synchronizedList(new ArrayList<>());
 
-    //NullObject class so Callable has to return something
-    private class NullObject{private NullObject(){}}
+  // NullObject class so Callable has to return something
+  private class NullObject {
+    private NullObject() {}
+  }
 
-    @Test
-    public void test_MultipleCallsReturnTheSameObjectInSameThread() {
-        //Create several instances in the same calling thread
-        ThreadSafeLazyLoadedIvoryTower instance1 = ThreadSafeLazyLoadedIvoryTower.getInstance();
-        ThreadSafeLazyLoadedIvoryTower instance2 = ThreadSafeLazyLoadedIvoryTower.getInstance();
-        ThreadSafeLazyLoadedIvoryTower instance3 = ThreadSafeLazyLoadedIvoryTower.getInstance();
-        //now check they are equal
-        assertEquals(instance1, instance1);
-        assertEquals(instance1, instance2);
-        assertEquals(instance2, instance3);
-        assertEquals(instance1, instance3);
+  @Test
+  public void test_MultipleCallsReturnTheSameObjectInSameThread() {
+    // Create several instances in the same calling thread
+    ThreadSafeLazyLoadedIvoryTower instance1 = ThreadSafeLazyLoadedIvoryTower.getInstance();
+    ThreadSafeLazyLoadedIvoryTower instance2 = ThreadSafeLazyLoadedIvoryTower.getInstance();
+    ThreadSafeLazyLoadedIvoryTower instance3 = ThreadSafeLazyLoadedIvoryTower.getInstance();
+    // now check they are equal
+    assertEquals(instance1, instance1);
+    assertEquals(instance1, instance2);
+    assertEquals(instance2, instance3);
+    assertEquals(instance1, instance3);
+  }
+
+  @Test
+  public void test_MultipleCallsReturnTheSameObjectInDifferentThreads()
+      throws InterruptedException, ExecutionException {
+    {// create several threads and inside each callable instantiate the singleton class
+      ExecutorService executorService = Executors.newSingleThreadExecutor();
+
+      List> threadList = new ArrayList<>();
+      for (int i = 0; i < NUM_THREADS; i++) {
+        threadList.add(new SingletonCreatingThread());
+      }
+
+      ExecutorService service = Executors.newCachedThreadPool();
+      List> results = service.invokeAll(threadList);
+
+      // wait for all of the threads to complete
+      for (Future res : results) {
+        res.get();
+      }
+
+      // tidy up the executor
+      executorService.shutdown();
     }
-
-    @Test
-    public void test_MultipleCallsReturnTheSameObjectInDifferentThreads() throws InterruptedException, ExecutionException {
-        {//create several threads and inside each callable instantiate the singleton class
-            ExecutorService executorService = Executors.newSingleThreadExecutor();
-
-            List> threadList = new ArrayList<>();
-            for (int i = 0; i < NUM_THREADS; i++) {
-                threadList.add(new SingletonCreatingThread());
-            }
-
-            ExecutorService service = Executors.newCachedThreadPool();
-            List> results = service.invokeAll(threadList);
-
-            //wait for all of the threads to complete
-            for (Future res : results) {
-                res.get();
-            }
-
-            //tidy up the executor
-            executorService.shutdown();
-        }
-        {//now check the contents that were added to threadObjects by each thread
-            assertEquals(NUM_THREADS, threadObjects.size());
-            assertEquals(threadObjects.get(0), threadObjects.get(1));
-            assertEquals(threadObjects.get(1), threadObjects.get(2));
-            assertEquals(threadObjects.get(2), threadObjects.get(3));
-            assertEquals(threadObjects.get(3), threadObjects.get(4));
-        }
+    {// now check the contents that were added to threadObjects by each thread
+      assertEquals(NUM_THREADS, threadObjects.size());
+      assertEquals(threadObjects.get(0), threadObjects.get(1));
+      assertEquals(threadObjects.get(1), threadObjects.get(2));
+      assertEquals(threadObjects.get(2), threadObjects.get(3));
+      assertEquals(threadObjects.get(3), threadObjects.get(4));
     }
+  }
 
-    private class SingletonCreatingThread implements Callable {
-        @Override
-        public NullObject call() {
-            //instantiate the thread safety class and add to list to test afterwards
-            ThreadSafeLazyLoadedIvoryTower instance = ThreadSafeLazyLoadedIvoryTower.getInstance();
-            threadObjects.add(instance);
-            return new NullObject();//return null object (cannot return Void)
-        }
+  private class SingletonCreatingThread implements Callable {
+    @Override
+    public NullObject call() {
+      // instantiate the thread safety class and add to list to test afterwards
+      ThreadSafeLazyLoadedIvoryTower instance = ThreadSafeLazyLoadedIvoryTower.getInstance();
+      threadObjects.add(instance);
+      return new NullObject();// return null object (cannot return Void)
     }
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/app/App.java b/specification/src/main/java/com/iluwatar/specification/app/App.java
index 642278f16..d755d6c2e 100644
--- a/specification/src/main/java/com/iluwatar/specification/app/App.java
+++ b/specification/src/main/java/com/iluwatar/specification/app/App.java
@@ -18,33 +18,41 @@ import com.iluwatar.specification.selector.MovementSelector;
 
 /**
  * 
- * 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.
+ * 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.
+ * 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 {
-	
-    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
-    	System.out.println("Find all walking creatures");
-    	List walkingCreatures = creatures.stream().filter(new MovementSelector(Movement.WALKING)).collect(Collectors.toList());
-    	walkingCreatures.stream().forEach(System.out::println);
-    	// find all dark creatures
-    	System.out.println("Find all dark creatures");
-    	List darkCreatures = creatures.stream().filter(new ColorSelector(Color.DARK)).collect(Collectors.toList());
-    	darkCreatures.stream().forEach(System.out::println);
-    	// find all red and flying creatures
-    	System.out.println("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(System.out::println);
-    }
+
+  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
+    System.out.println("Find all walking creatures");
+    List walkingCreatures =
+        creatures.stream().filter(new MovementSelector(Movement.WALKING))
+            .collect(Collectors.toList());
+    walkingCreatures.stream().forEach(System.out::println);
+    // find all dark creatures
+    System.out.println("Find all dark creatures");
+    List darkCreatures =
+        creatures.stream().filter(new ColorSelector(Color.DARK)).collect(Collectors.toList());
+    darkCreatures.stream().forEach(System.out::println);
+    // find all red and flying creatures
+    System.out.println("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(System.out::println);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java b/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java
index 12dae6cc9..2ec3ccf55 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/AbstractCreature.java
@@ -11,40 +11,40 @@ import com.iluwatar.specification.property.Size;
  */
 public abstract class AbstractCreature implements Creature {
 
-	private String name;
-	private Size size;
-	private Movement movement;
-	private Color color;
+  private String name;
+  private Size size;
+  private Movement movement;
+  private Color color;
 
-	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;
-	}
+  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;
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Creature.java b/specification/src/main/java/com/iluwatar/specification/creature/Creature.java
index f2d1d38d7..e6f48ffd0 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Creature.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Creature.java
@@ -11,11 +11,11 @@ import com.iluwatar.specification.property.Size;
  */
 public interface Creature {
 
-	String getName();
-	
-	Size getSize();
-	
-	Movement getMovement();
-	
-	Color getColor();
+  String getName();
+
+  Size getSize();
+
+  Movement getMovement();
+
+  Color getColor();
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java b/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java
index 0a6fd31ba..1c629d652 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Dragon.java
@@ -11,7 +11,7 @@ import com.iluwatar.specification.property.Size;
  */
 public class Dragon extends AbstractCreature {
 
-	public Dragon() {
-		super("Dragon", Size.LARGE, Movement.FLYING, Color.RED);
-	}
+  public Dragon() {
+    super("Dragon", Size.LARGE, Movement.FLYING, Color.RED);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java b/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java
index f7cc1ef0b..c01f98505 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Goblin.java
@@ -11,7 +11,7 @@ import com.iluwatar.specification.property.Size;
  */
 public class Goblin extends AbstractCreature {
 
-	public Goblin() {
-		super("Goblin", Size.SMALL, Movement.WALKING, Color.GREEN);
-	}
+  public Goblin() {
+    super("Goblin", Size.SMALL, Movement.WALKING, Color.GREEN);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java b/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java
index 11a4711c7..909767a67 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/KillerBee.java
@@ -11,7 +11,7 @@ import com.iluwatar.specification.property.Size;
  */
 public class KillerBee extends AbstractCreature {
 
-	public KillerBee() {
-		super("KillerBee", Size.SMALL, Movement.FLYING, Color.LIGHT);
-	}
+  public KillerBee() {
+    super("KillerBee", Size.SMALL, Movement.FLYING, Color.LIGHT);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java b/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java
index 7a2ae2c18..125b5d0e3 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Octopus.java
@@ -11,7 +11,7 @@ import com.iluwatar.specification.property.Size;
  */
 public class Octopus extends AbstractCreature {
 
-	public Octopus() {
-		super("Octopus", Size.NORMAL, Movement.SWIMMING, Color.DARK);
-	}
+  public Octopus() {
+    super("Octopus", Size.NORMAL, Movement.SWIMMING, Color.DARK);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Shark.java b/specification/src/main/java/com/iluwatar/specification/creature/Shark.java
index 42090500d..7c8b3faba 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Shark.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Shark.java
@@ -11,7 +11,7 @@ import com.iluwatar.specification.property.Size;
  */
 public class Shark extends AbstractCreature {
 
-	public Shark() {
-		super("Shark", Size.NORMAL, Movement.SWIMMING, Color.LIGHT);
-	}
+  public Shark() {
+    super("Shark", Size.NORMAL, Movement.SWIMMING, Color.LIGHT);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/creature/Troll.java b/specification/src/main/java/com/iluwatar/specification/creature/Troll.java
index 1dd31c17f..788c0d770 100644
--- a/specification/src/main/java/com/iluwatar/specification/creature/Troll.java
+++ b/specification/src/main/java/com/iluwatar/specification/creature/Troll.java
@@ -10,8 +10,8 @@ import com.iluwatar.specification.property.Size;
  *
  */
 public class Troll extends AbstractCreature {
-	
-	public Troll() {
-		super("Troll", Size.LARGE, Movement.WALKING, Color.DARK);
-	}
+
+  public Troll() {
+    super("Troll", Size.LARGE, Movement.WALKING, Color.DARK);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Color.java b/specification/src/main/java/com/iluwatar/specification/property/Color.java
index e23cb1585..197631737 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Color.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Color.java
@@ -7,16 +7,16 @@ package com.iluwatar.specification.property;
  */
 public enum Color {
 
-    DARK("dark"), LIGHT("light"), GREEN("green"), RED("red");
-    
-    private String title;
+  DARK("dark"), LIGHT("light"), GREEN("green"), RED("red");
 
-    Color(String title) {
-        this.title = title;
-    }
+  private String title;
 
-    @Override
-	public String toString() {
-        return title;
-	}		
+  Color(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Movement.java b/specification/src/main/java/com/iluwatar/specification/property/Movement.java
index 1b4b0ec9e..7c09cf642 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Movement.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Movement.java
@@ -7,16 +7,16 @@ package com.iluwatar.specification.property;
  */
 public enum Movement {
 
-    WALKING("walking"), SWIMMING("swimming"), FLYING("flying");
-    
-    private String title;
+  WALKING("walking"), SWIMMING("swimming"), FLYING("flying");
 
-    Movement(String title) {
-        this.title = title;
-    }
+  private String title;
 
-    @Override
-	public String toString() {
-        return title;
-	}	
+  Movement(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/property/Size.java b/specification/src/main/java/com/iluwatar/specification/property/Size.java
index 7f07fe147..855d0eadc 100644
--- a/specification/src/main/java/com/iluwatar/specification/property/Size.java
+++ b/specification/src/main/java/com/iluwatar/specification/property/Size.java
@@ -7,16 +7,16 @@ package com.iluwatar.specification.property;
  */
 public enum Size {
 
-    SMALL("small"), NORMAL("normal"), LARGE("large");
-    
-    private String title;
+  SMALL("small"), NORMAL("normal"), LARGE("large");
 
-    Size(String title) {
-        this.title = title;
-    }
+  private String title;
 
-    @Override
-	public String toString() {
-        return title;
-	}
+  Size(String title) {
+    this.title = title;
+  }
+
+  @Override
+  public String toString() {
+    return title;
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java
index d68127599..41b51fa95 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/ColorSelector.java
@@ -12,14 +12,14 @@ import com.iluwatar.specification.property.Color;
  */
 public class ColorSelector implements Predicate {
 
-	private final Color c;
+  private final Color c;
 
-	public ColorSelector(Color c) {
-		this.c = c;
-	}
-	
-	@Override
-	public boolean test(Creature t) {
-		return t.getColor().equals(c);
-	}
+  public ColorSelector(Color c) {
+    this.c = c;
+  }
+
+  @Override
+  public boolean test(Creature t) {
+    return t.getColor().equals(c);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java
index 260abd0e3..288205c86 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/MovementSelector.java
@@ -11,15 +11,15 @@ import com.iluwatar.specification.property.Movement;
  *
  */
 public class MovementSelector implements Predicate {
-	
-	private final Movement m;
 
-	public MovementSelector(Movement m) {
-		this.m = m;
-	}
+  private final Movement m;
 
-	@Override
-	public boolean test(Creature t) {
-		return t.getMovement().equals(m);
-	}
+  public MovementSelector(Movement m) {
+    this.m = m;
+  }
+
+  @Override
+  public boolean test(Creature t) {
+    return t.getMovement().equals(m);
+  }
 }
diff --git a/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java b/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java
index a54eaf16c..88bdb8793 100644
--- a/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java
+++ b/specification/src/main/java/com/iluwatar/specification/selector/SizeSelector.java
@@ -12,14 +12,14 @@ import com.iluwatar.specification.property.Size;
  */
 public class SizeSelector implements Predicate {
 
-	private final Size s;
+  private final Size s;
 
-	public SizeSelector(Size s) {
-		this.s = s;
-	}
-	
-	@Override
-	public boolean test(Creature t) {
-		return t.getSize().equals(s);
-	}
+  public SizeSelector(Size s) {
+    this.s = s;
+  }
+
+  @Override
+  public boolean test(Creature t) {
+    return t.getSize().equals(s);
+  }
 }
diff --git a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
index 31965336c..fe613eab7 100644
--- a/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
+++ b/specification/src/test/java/com/iluwatar/specification/app/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.specification.app.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/state/src/main/java/com/iluwatar/state/AngryState.java b/state/src/main/java/com/iluwatar/state/AngryState.java
index f09fbb518..d9fab7e67 100644
--- a/state/src/main/java/com/iluwatar/state/AngryState.java
+++ b/state/src/main/java/com/iluwatar/state/AngryState.java
@@ -7,20 +7,20 @@ package com.iluwatar.state;
  */
 public class AngryState implements State {
 
-	private Mammoth mammoth;
+  private Mammoth mammoth;
 
-	public AngryState(Mammoth mammoth) {
-		this.mammoth = mammoth;
-	}
+  public AngryState(Mammoth mammoth) {
+    this.mammoth = mammoth;
+  }
 
-	@Override
-	public void observe() {
-		System.out.println(String.format("%s is furious!", mammoth));
-	}
+  @Override
+  public void observe() {
+    System.out.println(String.format("%s is furious!", mammoth));
+  }
 
-	@Override
-	public void onEnterState() {
-		System.out.println(String.format("%s gets angry!", mammoth));
-	}
+  @Override
+  public void onEnterState() {
+    System.out.println(String.format("%s gets angry!", mammoth));
+  }
 
 }
diff --git a/state/src/main/java/com/iluwatar/state/App.java b/state/src/main/java/com/iluwatar/state/App.java
index 95d411076..2013466e0 100644
--- a/state/src/main/java/com/iluwatar/state/App.java
+++ b/state/src/main/java/com/iluwatar/state/App.java
@@ -2,27 +2,25 @@ 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.
+ * 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.
+ * 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 {
 
-	public static void main(String[] args) {
+  public static void main(String[] args) {
 
-		Mammoth mammoth = new Mammoth();
-		mammoth.observe();
-		mammoth.timePasses();
-		mammoth.observe();
-		mammoth.timePasses();
-		mammoth.observe();
+    Mammoth mammoth = new Mammoth();
+    mammoth.observe();
+    mammoth.timePasses();
+    mammoth.observe();
+    mammoth.timePasses();
+    mammoth.observe();
 
-	}
+  }
 }
diff --git a/state/src/main/java/com/iluwatar/state/Mammoth.java b/state/src/main/java/com/iluwatar/state/Mammoth.java
index f98da3b5e..8269ecb3d 100644
--- a/state/src/main/java/com/iluwatar/state/Mammoth.java
+++ b/state/src/main/java/com/iluwatar/state/Mammoth.java
@@ -7,31 +7,31 @@ package com.iluwatar.state;
  */
 public class Mammoth {
 
-	private State state;
+  private State state;
 
-	public Mammoth() {
-		state = new PeacefulState(this);
-	}
+  public Mammoth() {
+    state = new PeacefulState(this);
+  }
 
-	public void timePasses() {
-		if (state.getClass().equals(PeacefulState.class)) {
-			changeStateTo(new AngryState(this));
-		} else {
-			changeStateTo(new PeacefulState(this));
-		}
-	}
+  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();
-	}
+  private void changeStateTo(State newState) {
+    this.state = newState;
+    this.state.onEnterState();
+  }
 
-	@Override
-	public String toString() {
-		return "The mammoth";
-	}
+  @Override
+  public String toString() {
+    return "The mammoth";
+  }
 
-	public void observe() {
-		this.state.observe();
-	}
+  public void observe() {
+    this.state.observe();
+  }
 }
diff --git a/state/src/main/java/com/iluwatar/state/PeacefulState.java b/state/src/main/java/com/iluwatar/state/PeacefulState.java
index 237fe7c2c..d3a53913f 100644
--- a/state/src/main/java/com/iluwatar/state/PeacefulState.java
+++ b/state/src/main/java/com/iluwatar/state/PeacefulState.java
@@ -7,20 +7,20 @@ package com.iluwatar.state;
  */
 public class PeacefulState implements State {
 
-	private Mammoth mammoth;
+  private Mammoth mammoth;
 
-	public PeacefulState(Mammoth mammoth) {
-		this.mammoth = mammoth;
-	}
+  public PeacefulState(Mammoth mammoth) {
+    this.mammoth = mammoth;
+  }
 
-	@Override
-	public void observe() {
-		System.out.println(String.format("%s is calm and peaceful.", mammoth));
-	}
+  @Override
+  public void observe() {
+    System.out.println(String.format("%s is calm and peaceful.", mammoth));
+  }
 
-	@Override
-	public void onEnterState() {
-		System.out.println(String.format("%s calms down.", mammoth));
-	}
+  @Override
+  public void onEnterState() {
+    System.out.println(String.format("%s calms down.", mammoth));
+  }
 
 }
diff --git a/state/src/main/java/com/iluwatar/state/State.java b/state/src/main/java/com/iluwatar/state/State.java
index 3f65e3532..4851a5c6c 100644
--- a/state/src/main/java/com/iluwatar/state/State.java
+++ b/state/src/main/java/com/iluwatar/state/State.java
@@ -7,8 +7,8 @@ package com.iluwatar.state;
  */
 public interface State {
 
-	void onEnterState();
+  void onEnterState();
 
-	void observe();
+  void observe();
 
 }
diff --git a/state/src/test/java/com/iluwatar/state/AppTest.java b/state/src/test/java/com/iluwatar/state/AppTest.java
index 556cbc01c..0961a1c26 100644
--- a/state/src/test/java/com/iluwatar/state/AppTest.java
+++ b/state/src/test/java/com/iluwatar/state/AppTest.java
@@ -11,9 +11,9 @@ import com.iluwatar.state.App;
  */
 public class AppTest {
 
-	@Test
-	public void test() {
-		String[] args = {};
-		App.main(args);
-	}
+  @Test
+  public void test() {
+    String[] args = {};
+    App.main(args);
+  }
 }
diff --git a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
index 533394acb..3bf7b9a68 100644
--- a/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
+++ b/step-builder/src/main/java/com/iluwatar/stepbuilder/App.java
@@ -3,72 +3,60 @@ package com.iluwatar.stepbuilder;
 /**
  * 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.
+ * 
    
+ * 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
- * 
    
- *