#107 Chain example JavaDoc improvements

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

@@ -1,22 +1,26 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-/**
+/**
- * 
+ * 
- * Chain of Responsibility organizes request handlers (RequestHandler) into a
+ * 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
+ * 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
+ * this example the king ({@link OrcKing}) makes requests and the military orcs
- * (OrcCommander, OrcOfficer, OrcSoldier) form the handler chain.
+ * ({@link OrcCommander}, {@link OrcOfficer}, {@link OrcSoldier}) form the handler chain.
- * 
+ * 
- */
+ */
-public class App {
+public class App {
-
+
-	public static void main(String[] args) {
+	/**
-
+	 * Program entry point
-		OrcKing king = new OrcKing();
+	 * @param args command line args
-		king.makeRequest(new Request(RequestType.DEFEND_CASTLE, "defend castle"));
+	 */
-		king.makeRequest(new Request(RequestType.TORTURE_PRISONER,
+	public static void main(String[] args) {
-				"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"));
+
+	}
+}

chain/src/main/java/com/iluwatar/chain/OrcCommander.java

@@ -1,22 +1,27 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-public class OrcCommander extends RequestHandler {
+/**
-
+ * 
-	public OrcCommander(RequestHandler handler) {
+ * OrcCommander
-		super(handler);
+ *
-	}
+ */
-
+public class OrcCommander extends RequestHandler {
-	@Override
+
-	public void handleRequest(Request req) {
+	public OrcCommander(RequestHandler handler) {
-		if (req.getRequestType().equals(RequestType.DEFEND_CASTLE)) {
+		super(handler);
-			printHandling(req);
+	}
-		} else {
+
-			super.handleRequest(req);
+	@Override
-		}
+	public void handleRequest(Request req) {
-	}
+		if (req.getRequestType().equals(RequestType.DEFEND_CASTLE)) {
-
+			printHandling(req);
-	@Override
+		} else {
-	public String toString() {
+			super.handleRequest(req);
-		return "Orc commander";
+		}
-	}
+	}
-}
+
+	@Override
+	public String toString() {
+		return "Orc commander";
+	}
+}

chain/src/main/java/com/iluwatar/chain/OrcKing.java

@@ -1,24 +1,24 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-/**
+/**
- * 
+ * 
- * Makes requests that are handled by the chain.
+ * OrcKing makes requests that are handled by the chain.
- * 
+ * 
- */
+ */
-public class OrcKing {
+public class OrcKing {
-
+
-	RequestHandler chain;
+	RequestHandler chain;
-
+
-	public OrcKing() {
+	public OrcKing() {
-		buildChain();
+		buildChain();
-	}
+	}
-
+
-	private void buildChain() {
+	private void buildChain() {
-		chain = new OrcCommander(new OrcOfficer(new OrcSoldier(null)));
+		chain = new OrcCommander(new OrcOfficer(new OrcSoldier(null)));
-	}
+	}
-
+
-	public void makeRequest(Request req) {
+	public void makeRequest(Request req) {
-		chain.handleRequest(req);
+		chain.handleRequest(req);
-	}
+	}
-
+
-}
+}

chain/src/main/java/com/iluwatar/chain/OrcOfficer.java

@@ -1,23 +1,28 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-public class OrcOfficer extends RequestHandler {
+/**
-
+ * 
-	public OrcOfficer(RequestHandler handler) {
+ * OrcOfficer
-		super(handler);
+ *
-	}
+ */
-
+public class OrcOfficer extends RequestHandler {
-	@Override
+
-	public void handleRequest(Request req) {
+	public OrcOfficer(RequestHandler handler) {
-		if (req.getRequestType().equals(RequestType.TORTURE_PRISONER)) {
+		super(handler);
-			printHandling(req);
+	}
-		} else {
+
-			super.handleRequest(req);
+	@Override
-		}
+	public void handleRequest(Request req) {
-	}
+		if (req.getRequestType().equals(RequestType.TORTURE_PRISONER)) {
-
+			printHandling(req);
-	@Override
+		} else {
-	public String toString() {
+			super.handleRequest(req);
-		return "Orc officer";
+		}
-	}
+	}
-
+
-}
+	@Override
+	public String toString() {
+		return "Orc officer";
+	}
+
+}

chain/src/main/java/com/iluwatar/chain/OrcSoldier.java

@@ -1,22 +1,27 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-public class OrcSoldier extends RequestHandler {
+/**
-
+ * 
-	public OrcSoldier(RequestHandler handler) {
+ * OrcSoldier
-		super(handler);
+ *
-	}
+ */
-
+public class OrcSoldier extends RequestHandler {
-	@Override
+
-	public void handleRequest(Request req) {
+	public OrcSoldier(RequestHandler handler) {
-		if (req.getRequestType().equals(RequestType.COLLECT_TAX)) {
+		super(handler);
-			printHandling(req);
+	}
-		} else {
+
-			super.handleRequest(req);
+	@Override
-		}
+	public void handleRequest(Request req) {
-	}
+		if (req.getRequestType().equals(RequestType.COLLECT_TAX)) {
-
+			printHandling(req);
-	@Override
+		} else {
-	public String toString() {
+			super.handleRequest(req);
-		return "Orc soldier";
+		}
-	}
+	}
-}
+
+	@Override
+	public String toString() {
+		return "Orc soldier";
+	}
+}

chain/src/main/java/com/iluwatar/chain/Request.java

@@ -1,33 +1,38 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-public class Request {
+/**
-
+ * 
-	private String requestDescription;
+ * Request
-	private RequestType requestType;
+ *
-
+ */
-	public Request(RequestType requestType, String requestDescription) {
+public class Request {
-		this.setRequestType(requestType);
+
-		this.setRequestDescription(requestDescription);
+	private String requestDescription;
-	}
+	private RequestType requestType;
-
+
-	public String getRequestDescription() {
+	public Request(RequestType requestType, String requestDescription) {
-		return requestDescription;
+		this.setRequestType(requestType);
-	}
+		this.setRequestDescription(requestDescription);
-
+	}
-	public void setRequestDescription(String requestDescription) {
+
-		this.requestDescription = requestDescription;
+	public String getRequestDescription() {
-	}
+		return requestDescription;
-
+	}
-	public RequestType getRequestType() {
+
-		return requestType;
+	public void setRequestDescription(String requestDescription) {
-	}
+		this.requestDescription = requestDescription;
-
+	}
-	public void setRequestType(RequestType requestType) {
+
-		this.requestType = requestType;
+	public RequestType getRequestType() {
-	}
+		return requestType;
-
+	}
-	@Override
+
-	public String toString() {
+	public void setRequestType(RequestType requestType) {
-		return getRequestDescription();
+		this.requestType = requestType;
-	}
+	}
-}
+
+	@Override
+	public String toString() {
+		return getRequestDescription();
+	}
+}

chain/src/main/java/com/iluwatar/chain/RequestHandler.java

@@ -1,23 +1,28 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-public abstract class RequestHandler {
+/**
-
+ * 
-	private RequestHandler next;
+ * RequestHandler
-
+ *
-	public RequestHandler(RequestHandler next) {
+ */
-		this.next = next;
+public abstract class RequestHandler {
-	}
+
-
+	private RequestHandler next;
-	public void handleRequest(Request req) {
+
-		if (next != null) {
+	public RequestHandler(RequestHandler next) {
-			next.handleRequest(req);
+		this.next = next;
-		}
+	}
-	}
+
-
+	public void handleRequest(Request req) {
-	protected void printHandling(Request req) {
+		if (next != null) {
-		System.out.println(this + " handling request \"" + req + "\"");
+			next.handleRequest(req);
-	}
+		}
-
+	}
-	@Override
+
-	public abstract String toString();
+	protected void printHandling(Request req) {
-}
+		System.out.println(this + " handling request \"" + req + "\"");
+	}
+
+	@Override
+	public abstract String toString();
+}

chain/src/main/java/com/iluwatar/chain/RequestType.java

@@ -1,7 +1,12 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-public enum RequestType {
+/**
-
+ * 
-	DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX
+ * RequestType enumeration
-
+ *
-}
+ */
+public enum RequestType {
+
+	DEFEND_CASTLE, TORTURE_PRISONER, COLLECT_TAX
+
+}

chain/src/test/java/com/iluwatar/chain/AppTest.java

@@ -1,14 +1,19 @@
-package com.iluwatar.chain;
+package com.iluwatar.chain;
-
+
-import org.junit.Test;
+import org.junit.Test;
-
+
-import com.iluwatar.chain.App;
+import com.iluwatar.chain.App;
-
+
-public class AppTest {
+/**
-
+ * 
-	@Test
+ * Application test
-	public void test() {
+ *
-		String[] args = {};
+ */
-		App.main(args);
+public class AppTest {
-	}
+
-}
+	@Test
+	public void test() {
+		String[] args = {};
+		App.main(args);
+	}
+}