State design pattern

Author: Eder Duran

src/State/Conceptual/Output.txt

@@ -0,0 +1,15 @@
+Context: Transition to 14ConcreteStateA.
+ConcreteStateA handles request1.
+ConcreteStateA wants to change the state of the context.
+Context: Transition to 14ConcreteStateB.
+ConcreteStateB handles request2.
+ConcreteStateB wants to change the state of the context.
+Context: Transition to 14ConcreteStateA.
+  
+Context: Transition to RefactoringGuru\State\Conceptual\ConcreteStateA.
+ConcreteStateA handles request1.
+ConcreteStateA wants to change the state of the context.
+Context: Transition to RefactoringGuru\State\Conceptual\ConcreteStateB.
+ConcreteStateB handles request2.
+ConcreteStateB wants to change the state of the context.
+Context: Transition to RefactoringGuru\State\Conceptual\ConcreteStateA.

src/State/Conceptual/main.cc

@@ -0,0 +1,170 @@
+#include <iostream>
+#include <typeinfo>
+/**
+ * EN: State Design Pattern
+ *
+ * Intent: Lets an object alter its behavior when its internal state changes. It
+ * appears as if the object changed its class.
+ *
+ * RU: Паттерн Состояние
+ *
+ * Назначение: Позволяет объектам менять поведение в зависимости от своего
+ * состояния. Извне создаётся впечатление, что изменился класс объекта.
+ */
+
+/**
+ * EN: The base State class declares methods that all Concrete State should
+ * implement and also provides a backreference to the Context object, associated
+ * with the State. This backreference can be used by States to transition the
+ * Context to another State.
+ *
+ * RU: Базовый класс Состояния объявляет методы, которые должны реализовать все
+ * Конкретные Состояния, а также предоставляет обратную ссылку на объект
+ * Контекст, связанный с Состоянием. Эта обратная ссылка может использоваться
+ * Состояниями для передачи Контекста другому Состоянию.
+ */
+
+class Context;
+
+class State
+{
+    /**
+     * @var Context
+     */
+protected:
+    Context *context_;
+
+public:
+    virtual ~State()
+    {
+    }
+
+    void set_context(Context *context)
+    {
+        this->context_ = context;
+    }
+
+    virtual void Handle1() = 0;
+    virtual void Handle2() = 0;
+};
+
+/**
+ * EN: The Context defines the interface of interest to clients. It also
+ * maintains a reference to an instance of a State subclass, which represents
+ * the current state of the Context.
+ *
+ * RU: Контекст определяет интерфейс, представляющий интерес для клиентов. Он
+ * также хранит ссылку на экземпляр подкласса Состояния, который отображает
+ * текущее состояние Контекста.
+ */
+class Context
+{
+    /**
+     * EN: @var State A reference to the current state of the Context.
+     *
+     * RU: @var State Ссылка на текущее состояние Контекста.
+     */
+private:
+    State *state_;
+
+public:
+    Context(State *state) : state_(nullptr)
+    {
+        this->TransitionTo(state);
+    }
+    ~Context()
+    {
+        delete state_;
+    }
+    /**
+     * EN: The Context allows changing the State object at runtime.
+     *
+     * RU: Контекст позволяет изменять объект Состояния во время выполнения.
+     */
+    void TransitionTo(State *state)
+    {
+        std::cout << "Context: Transition to " << typeid(*state).name() << ".\n";
+        if (this->state_ != nullptr)
+            delete this->state_;
+        this->state_ = state;
+        this->state_->set_context(this);
+    }
+    /**
+     * EN: The Context delegates part of its behavior to the current State
+     * object.
+     *
+     * RU: Контекст делегирует часть своего поведения текущему объекту
+     * Состояния.
+     */
+    void Request1()
+    {
+        this->state_->Handle1();
+    }
+    void Request2()
+    {
+        this->state_->Handle2();
+    }
+};
+
+/**
+ * EN: Concrete States implement various behaviors, associated with a state of
+ * the Context.
+ *
+ * RU: Конкретные Состояния реализуют различные модели поведения, связанные с
+ * состоянием Контекста.
+ */
+
+class ConcreteStateA : public State
+{
+public:
+    void Handle1() override;
+
+    void Handle2() override
+    {
+        std::cout << "ConcreteStateA handles request2.\n";
+    }
+};
+
+class ConcreteStateB : public State
+{
+public:
+    void Handle1() override
+    {
+        std::cout << "ConcreteStateB handles request1.\n";
+    }
+    void Handle2() override
+    {
+        std::cout << "ConcreteStateB handles request2.\n";
+        std::cout << "ConcreteStateB wants to change the state of the context.\n";
+        this->context_->TransitionTo(new ConcreteStateA);
+    }
+};
+
+void ConcreteStateA::Handle1()
+{
+    {
+        std::cout << "ConcreteStateA handles request1.\n";
+        std::cout << "ConcreteStateA wants to change the state of the context.\n";
+
+        this->context_->TransitionTo(new ConcreteStateB);
+    }
+}
+
+/**
+ * EN: The client code.
+ *
+ * RU: Клиентский код.
+ */
+void ClientCode()
+{
+    Context *context = new Context(new ConcreteStateA);
+    context->Request1();
+    context->Request2();
+    delete context;
+}
+
+int main()
+{
+    ClientCode();
+    return 0;
+}