issue #292

adapter/src/main/java/com/iluwatar/adapter/App.java

@@ -1,28 +1,43 @@
 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.
  * 
- * <p>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.
+ * <p>
+ * 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.
+ * 
+ * <p>
+ * The Adapter ({@link BattleFishingBoat}) converts the interface of the adaptee
+ * class ( {@link FishingBoat}) into a suitable one expected by the client (
+ * {@link BattleShip} ).
+ * 
+ * <p>
+ * The story of this implementation is this. <br>
+ * Pirates are coming! we need a {@link BattleShip} to fight! We have a
+ * {@link FishingBoat} and our captain. We have no time to make up a new ship!
+ * we need to reuse this {@link FishingBoat}. The captain needs a battleship
+ * which can fire and move. The spec is in {@link BattleShip}. We will use the
+ * Adapter pattern to reuse {@link FishingBoat}.
  * 
- * <p>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(new GnomeEngineer());
-    manager.operateDevice();
-  }
+	/**
+	 * Program entry point.
+	 *
+	 * @param args
+	 *            command line args
+	 */
+	public static void main(String[] args) {
+		Captain captain = new Captain(new BattleFishingBoat());
+		captain.move();
+		captain.fire();
+	}
 }

adapter/src/main/java/com/iluwatar/adapter/Engineer.java

@@ -1,11 +0,0 @@
-package com.iluwatar.adapter;
-
-/**
- * 
- * Engineers can operate devices.
- * 
- */
-public interface Engineer {
-
-  void operateDevice();
-}

adapter/src/main/java/com/iluwatar/adapter/GnomeEngineer.java

@@ -1,23 +0,0 @@
-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();
-  }
-}

adapter/src/main/java/com/iluwatar/adapter/GnomeEngineeringManager.java

@@ -1,26 +0,0 @@
-package com.iluwatar.adapter;
-
-/**
- * GnomeEngineering manager uses {@link Engineer} to operate devices.
- */
-public class GnomeEngineeringManager implements Engineer {
-
-  private Engineer engineer;
-
-  public GnomeEngineeringManager() {
-
-  }
-
-  public GnomeEngineeringManager(Engineer engineer) {
-    this.engineer = engineer;
-  }
-
-  @Override
-  public void operateDevice() {
-    engineer.operateDevice();
-  }
-
-  public void setEngineer(Engineer engineer) {
-    this.engineer = engineer;
-  }
-}

adapter/src/main/java/com/iluwatar/adapter/GoblinGlider.java

@@ -1,21 +0,0 @@
-package com.iluwatar.adapter;
-
-/**
- * 
- * Device class (adaptee in the pattern).
- * 
- */
-public class GoblinGlider {
-
-  public void attachGlider() {
-    System.out.println("Glider attached.");
-  }
-
-  public void gainSpeed() {
-    System.out.println("Gaining speed.");
-  }
-
-  public void takeOff() {
-    System.out.println("Lift-off!");
-  }
-}