Improved Proxy Javadoc

iluwatar · iluwatar · commit c3a827b475c8 · 2015-10-04T00:08:34.000+03:00
diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java
@@ -2,7 +2,18 @@
 
 /**
  * 
- * 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.
+ * <p>
+ * 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.
+ * <p>
+ * In this example the proxy ({@link WizardTowerProxy}) controls access to the actual object 
+ * ({@link WizardTower}).
  * 
  */
 public class App {
