diff --git a/proxy/src/main/java/com/iluwatar/proxy/App.java b/proxy/src/main/java/com/iluwatar/proxy/App.java index fb401ac9f..420ad5c0a 100644 --- a/proxy/src/main/java/com/iluwatar/proxy/App.java +++ b/proxy/src/main/java/com/iluwatar/proxy/App.java @@ -2,7 +2,18 @@ package com.iluwatar.proxy; /** * - * 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. + *
+ * 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. + *
+ * In this example the proxy ({@link WizardTowerProxy}) controls access to the actual object + * ({@link WizardTower}). * */ public class App {