Reformat Abstract Factory - Issue #224

abstract-factory/src/main/java/com/iluwatar/abstractfactory/App.java

@@ -3,21 +3,18 @@ package com.iluwatar.abstractfactory;
 
 /**
  * 
- * The Abstract Factory pattern provides a way to encapsulate a group of individual 
+ * The Abstract Factory pattern provides a way to encapsulate a group of individual factories that
- * factories that have a common theme without specifying their concrete classes. In 
+ * have a common theme without specifying their concrete classes. In normal usage, the client
- * normal usage, the client software creates a concrete implementation of the abstract 
+ * software creates a concrete implementation of the abstract factory and then uses the generic
- * factory and then uses the generic interface of the factory to create the concrete 
+ * interface of the factory to create the concrete objects that are part of the theme. The client
- * objects that are part of the theme. The client does not know (or care) which 
+ * does not know (or care) which concrete objects it gets from each of these internal factories,
- * concrete objects it gets from each of these internal factories, since it uses only 
+ * since it uses only the generic interfaces of their products. This pattern separates the details
- * the generic interfaces of their products. This pattern separates the details of 
+ * of implementation of a set of objects from their general usage and relies on object composition,
- * implementation of a set of objects from their general usage and relies on object 
+ * as object creation is implemented in methods exposed in the factory interface.
- * composition, as object creation is implemented in methods exposed in the factory 
- * interface.
  * <p>
- * The essence of the Abstract Factory pattern is a factory interface
+ * The essence of the Abstract Factory pattern is a factory interface ({@link KingdomFactory}) and
- * ({@link KingdomFactory}) and its implementations ({@link ElfKingdomFactory},
+ * its implementations ({@link ElfKingdomFactory}, {@link OrcKingdomFactory}). The example uses both
- * {@link OrcKingdomFactory}). The example uses both concrete implementations to 
+ * concrete implementations to create a king, a castle and an army.
- * create a king, a castle and an army.
  * 
  */
 public class App {
@@ -28,6 +25,7 @@ public class App {
 
   /**
    * Creates kingdom
+   * 
    * @param factory
    */
   public void createKingdom(final KingdomFactory factory) {

abstract-factory/src/main/java/com/iluwatar/abstractfactory/OrcKingdomFactory.java

@@ -18,5 +18,4 @@ public class OrcKingdomFactory implements KingdomFactory {
   public Army createArmy() {
     return new OrcArmy();
   }
-
 }

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;