Added code comments for Multiton.

iluwatar · iluwatar · commit d0c32782ce3a · 2015-05-16T00:27:06.000+03:00
diff --git a/multiton/src/main/java/com/iluwatar/App.java b/multiton/src/main/java/com/iluwatar/App.java
@@ -1,5 +1,17 @@
 package com.iluwatar;
 
+/**
+ * 
+ * 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 Nazgul is the Multiton and we can ask single
+ * Nazgul from it using NazgulName. The Nazguls are statically
+ * initialized and stored in concurrent hash map.
+ *
+ */
 public class App {
 	
     public static void main( String[] args ) {
diff --git a/multiton/src/main/java/com/iluwatar/Nazgul.java b/multiton/src/main/java/com/iluwatar/Nazgul.java
@@ -3,6 +3,12 @@
 import java.util.Map;
 import java.util.concurrent.ConcurrentHashMap;
 
+/**
+ * 
+ * Nazgul is a Multiton class. Nazgul instances can be queried
+ * using getInstance() method.
+ *
+ */
 public class Nazgul {
 
 	private static Map<NazgulName, Nazgul> nazguls;
diff --git a/multiton/src/main/java/com/iluwatar/NazgulName.java b/multiton/src/main/java/com/iluwatar/NazgulName.java
@@ -1,5 +1,10 @@
 package com.iluwatar;
 
+/**
+ * 
+ * Each Nazgul has different NazgulName.
+ *
+ */
 public enum NazgulName {
 
 	KHAMUL, MURAZOR, DWAR, JI_INDUR, AKHORAHIL, HOARMURATH, ADUNAPHEL, REN, UVATHA;
