Facade: improve conceptual example

Author: lex111

Facade.Conceptual/Program.cs

@@ -1,28 +1,69 @@
-using System;
+// EN: Facade Design Pattern
+//
+// Intent: Provide a unified interface to a number of classes/interfaces of a
+// complex subsystem. The Facade pattern defines a higher-level interface that
+// makes the subsystem easier to use.
+//
+// RU: Паттерн Фасад
+//
+// Назначение: Предоставляет единый интерфейс к ряду классов/интерфейсов сложной
+// подсистемы. Паттерн Фасад определяет интерфейс более высокого уровня, который
+// упрощает использование подсистемы.
+
+using System;
 
 namespace RefactoringGuru.DesignPatterns.Facade.Conceptual
 {
-    class Program
+    // EN: The Facade class provides a simple interface to the complex logic of
+    // one or several subsystems. The Facade delegates the client requests to
+    // the appropriate objects within the subsystem. The Facade is also
+    // responsible for managing their lifecycle. All of this shields the client
+    // from the undesired complexity of the subsystem.
+    //
+    // RU: Класс Фасада предоставляет простой интерфейс для сложной логики одной
+    // или нескольких подсистем. Фасад делегирует запросы клиентов
+    // соответствующим объектам внутри подсистемы. Фасад также отвечает за
+    // управление их жизненным циклом. Все это защищает клиента от нежелательной
+    // сложности подсистемы.
+    public class Facade
     {
-        static void Main(string[] args)
-        {
-            Client client = new Client();
+        protected Subsystem1 _subsystem1;
+		
+        protected Subsystem2 _subsystem2;
 
-            Subsystem1 s1 = new Subsystem1();
-            Subsystem2 s2 = new Subsystem2();
-            Facade facade = new Facade(s1, s2);
-            client.ClientCode(facade);
+        public Facade(Subsystem1 subsystem1, Subsystem2 subsystem2)
+        {
+            this._subsystem1 = subsystem1;
+            this._subsystem2 = subsystem2;
         }
-    }
-
-    class Client
-    {
-        internal void ClientCode(Facade facade)
+		
+        //
+        // EN: The Facade's methods are convenient shortcuts to the sophisticated
+        // functionality of the subsystems. However, clients get only to a fraction
+        // of a subsystem's capabilities.
+        //
+        // RU: Методы Фасада удобны для быстрого доступа к сложной функциональности
+        // подсистем. Однако клиенты получают только часть возможностей подсистемы.
+        ///
+        public string Operation()
         {
-            Console.WriteLine(facade.Operation());
+            string result = "Facade initializes subsystems:\n";
+            result += this._subsystem1.operation1();
+            result += this._subsystem2.operation1();
+            result += "Facade orders subsystems to perform the action:\n";
+            result += this._subsystem1.operationN();
+            result += this._subsystem2.operationZ();
+            return result;
         }
     }
-
+    
+    // EN: The Subsystem can accept requests either from the facade or client
+    // directly. In any case, to the Subsystem, the Facade is yet another
+    // client, and it's not a part of the Subsystem.
+    //
+    // RU: Подсистема может принимать запросы либо от фасада, либо от клиента
+    // напрямую. В любом случае, для Подсистемы Фасад – это еще один клиент, и
+    // он не является частью Подсистемы.
     public class Subsystem1
     {
         public string operation1()
@@ -36,6 +77,9 @@ public string operationN()
         }
     }
 
+    // EN: Some facades can work with multiple subsystems at the same time.
+    //
+    // RU: Некоторые фасады могут работать с разными подсистемами одновременно.
     public class Subsystem2
     {
         public string operation1()
@@ -49,27 +93,44 @@ public string operationZ()
         }
     }
 
-    public class Facade
-    {
-        Subsystem1 Subsystem1;
-		
-        Subsystem2 Subsystem2;
 
-        public Facade(Subsystem1 s1, Subsystem2 s2)
+    class Client
+    {
+        // EN: The client code works with complex subsystems through a simple
+        // interface provided by the Facade. When a facade manages the lifecycle
+        // of the subsystem, the client might not even know about the existence
+        // of the subsystem. This approach lets you keep the complexity under
+        // control.
+        //
+        // RU: Клиентский код работает со сложными подсистемами через простой
+        // интерфейс, предоставляемый Фасадом. Когда фасад управляет жизненным
+        // циклом подсистемы, клиент может даже не знать о существовании
+        // подсистемы. Такой подход позволяет держать сложность под контролем.
+        public void ClientCode(Facade facade)
         {
-            this.Subsystem1 = s1;
-            this.Subsystem2 = s2;
+            Console.Write(facade.Operation());
         }
-		
-        public string Operation()
+    }
+    
+    class Program
+    {
+        static void Main(string[] args)
         {
-            string result = "Facade initializes subsystems:\n";
-            result += Subsystem1.operation1();
-            result += Subsystem2.operation1();
-            result += "Facade orders subsystems to perform the action:\n";
-            result += Subsystem1.operationN();
-            result += Subsystem2.operationZ();
-            return result;
+            Client client = new Client();
+
+            // EN: The client code may have some of the subsystem's objects
+            // already created. In this case, it might be worthwhile to
+            // initialize the Facade with these objects instead of letting the
+            // Facade create new instances.
+            //
+            // RU: В клиентском коде могут быть уже созданы некоторые объекты
+            // подсистемы. В этом случае может оказаться целесообразным
+            // инициализировать Фасад с этими объектами вместо того, чтобы
+            // позволить Фасаду создавать новые экземпляры.
+            Subsystem1 subsystem1 = new Subsystem1();
+            Subsystem2 subsystem2 = new Subsystem2();
+            Facade facade = new Facade(subsystem1, subsystem2);
+            client.ClientCode(facade);
         }
     }
 }