Command Design Pattern

In the series of behavioral design patterns, the Command Pattern is the one that encapsulates method invocation. We can issue requests to objects without knowing anything about the operation being requested or the receiver of the request. Let’s go into detail and see what it is:

The Command Pattern

The Command Pattern encapsulates a request as an object, thereby letting you parameterize clients with various requests, queue or log requests, and support undoable operations. (Gamma et. al.).

Uses of The Command Pattern

Let’s understand it with an example of the use of the Command Pattern.

I will use the same example I did in my first blog; The Remote Control. A company that manufactures the remote control, has several vendors (classes). These vendors have their own set of methods and interfaces to be invoked, such as On, Off, Dim, IncreaseVolumne, DecreaseVolume and so on and so forth. There are not many common interfaces among several vendor classes other than ON or OFF.

The manufacturing company can expect more diverse classes in the future with just as diverse methods. A bad design for the problem would be:

If(slot1== TV), then light.On(),

else if(slot1==Washmachine), then washmachine.On()


One way of analyzing the preceding problem is to follow the Separation of Concerns Principle: The remote should know how to interpret button presses and make requests, but it should not know a lot about home automation.

Goals of a good design for this situation:

  • Separate the remote’s ability to execute a command from the variety of operations and devices that can be supported.

  • We should analyze our problem with the following two questions:

    1. What varies?

      Devices and operations.

    2. What stays the same?

      The structure of the remote control.
UML Diagram and participants:

Command pattern

For the sake of a better understanding, I have mapped participants in the pattern with probable classes in my example.

Participants

The classes and/or objects participating in this pattern are:
  • Command (Command)

    – declares an interface for executing an operation.

  • ConcreteCommand (SwitchOnWaschmachine)

    – defines a binding between a Receiver object and an action.

    – implements Execute by invoking the corresponding operation(s) on Receiver.

  • Client (CommandApp)

    – creates a ConcreteCommand object and sets its receiver.

  • Invoker (Remote)

    – asks the command to carry out the request.

  • Receiver (Waschmachine, Fernseher, Microwelle)

    – knows how to do the operations associated with carrying out the request.

Sequence Diagram

A Sequence Diagram shows how multiple participants communicates among each other.

design

Step-by-step analysis:

  1. The client creates a ConcreteCommand object and specifies its receiver.

  2. An invoker object stores the concreteCommand object.

  3. The Invoker issues a request by calling Execute on the command. When commands are undoable, ConcreteCommand stores for undoing the command prior to invoking Execute.

  4. The concreteCommand object invokes operations on its receiver to carry out the request.

As it is said, if you are able to execute an action, you should also know how to undo the executed action. The same applies to our example too. If a household is started, the undo button should be able to shut it down. Or let’s say any last executed action should be reset when the undo button is pressed.

How to undo it

  • Add undo() to the Command interface.

  • Each ConcreteCommand must know how to undo the action it executed.

  • Make the Remote remember the last command executed and call it’s undo method for the undo button.

  • How does a remote remember a previously executed command?

  • Undo for.

  • Oven: simple (does an Oven need the hardcoded previous state on/off?).

  • Washing machine: ask the device for the state before execution.

Command Pattern in action

Abstract Command class:

  1. public abstract class ICommand  
  2. {  
  3.    public abstract void Exceute();  
  4.   
  5.    public abstract void Undo();  
  6. }  
Concrete Receivers

An Oven and Washing machine are receivers in our examples. They only know how can they be switched on or switched off.

Oven
  1. public class Oven  
  2. {  
  3.   
  4.    internal void SwitchOff()  
  5.    {  
  6.       MessageBox.Show("Oven is off");  
  7.    }  
  8.   
  9.    internal void SwitchOn()  
  10.    {  
  11.       MessageBox.Show("Oven is on");  
  12.    }  
  13. }  
  14.   
  15. //Washmachine  
  16. public class Waschmachine  
  17. {  
  18.   
  19.    internal void SwitchOn()  
  20.    {  
  21.       MessageBox.Show("Switching On Washing Machine");  
  22.    }  
  23.   
  24.   
  25.    internal void SwitchOff()  
  26.    {  
  27.       MessageBox.Show("Switching Off Washing Machine");  
  28.    }  
  29. }  
Concrete Commands

Concrete commands implement abstract command interfaces. The Execute method in a concrete class encapsulates method invocation (_waschmachine.SwitchOn()). Concrete commands also know their receivers.
  1. public class SwitchOnWaschmachine:ICommand  
  2. {  
  3.    private readonly Waschmachine _waschmachine;  
  4.   
  5.    public SwitchOnWaschmachine(Waschmachine waschmachine)  
  6.    {  
  7.       _waschmachine = waschmachine;  
  8.    }  
  9.   
  10.    public override void Exceute()  
  11.    {  
  12.       _waschmachine.SwitchOn();  
  13.    }  
  14.   
  15.   
  16.    public override void Undo()  
  17.    {  
  18.       _waschmachine.SwitchOff();  
  19.    }  
  20.   
  21.    public override string ToString()  
  22.    {  
  23.       return "Washing Machine";  
  24.    }  
  25. }  
Also, observe that each concrete command knows how to undo its original operation. One command knows how to switch it off and vice versa.
  1. public class SwitchOffWaschmachine :ICommand  
  2. {  
  3.    private readonly Waschmachine _waschmachine;  
  4.   
  5.    public SwitchOffWaschmachine(Waschmachine waschmachine)  
  6.    {  
  7.       _waschmachine = waschmachine;   
  8.    }  
  9.   
  10.    public override void Exceute()  
  11.    {  
  12.       _waschmachine.SwitchOff();  
  13.    }  
  14.   
  15.   
  16.    public override void Undo()  
  17.    {  
  18.       _waschmachine.SwitchOn();  
  19.    }  
  20.   
  21.    public override string ToString()  
  22.    {  
  23.       return "Washing Machine";  
  24.    }  
  25. }  
Invoker

A remote plays the role of an invoker and only knows how to execute a command but it does not know who the receiver of the command is and how the command is actually executed. In that way, the receiver and invoker are separated from each other.

Switch On click button
  1. private void SwitchOn_Click(object sender, EventArgs e)  
  2. {  
  3.    Button btn = sender as Button;  
  4.   
  5.    int col = btn != null ? Grid.GetColumn(btn) : -1;  
  6.    if (col == 1)  
  7.    {  
  8.       var slot = btn != null ? Grid.GetRow(btn) : -1;  
  9.       _onCommands[slot].Exceute(); // Execute Command  
  10.   
  11.   
  12.       _unDoCommand = _onCommands[slot];  
  13.    }  
  14.   
  15. }  
Switch Off click button
  1. private void SwitchOff_Click(object sender, EventArgs e)  
  2. {  
  3.    Button btn = sender as Button;  
  4.   
  5.    int col = btn != null ? Grid.GetColumn(btn) : -1;  
  6.    if (col == 2)  
  7.    {  
  8.       var slot = btn != null ? Grid.GetRow(btn) : -1;  
  9.       _offCommands[slot].Exceute();  
  10.       _unDoCommand = _offCommands[slot];  
  11.    }  
  12. }  
Client

The client is the one that associates a concrete command with its concrete receiver and also assigns each slot in the remote a command.
  1. MainWindow remotecontrol = new MainWindow();  
  2.   
  3. Waschmachine waschmachine= new Waschmachine();  
  4.   
  5. Oven oven= new Oven();  
  6.   
  7. SwitchOffOven switchOffOven= new SwitchOffOven(oven);  
  8. SwitchOnOven switchOnOven= new SwitchOnOven(oven);  
  9.   
  10.   
  11. SwitchOnWaschmachine switchOnWaschmachine= new SwitchOnWaschmachine(waschmachine);  
  12. SwitchOffWaschmachine switchOffWaschmachine= new SwitchOffWaschmachine(waschmachine);  
  13.   
  14. remotecontrol.SetCommand(0, switchOnOven, switchOffOven);  
  15. remotecontrol.SetCommand(1, switchOnWaschmachine, switchOffWaschmachine);  
Macro Commands

Many of us have certainly used macros in Excel. Macros are quite useful when you want to execute a series of commands every now and then. The only point to remember is that this macro (series of commands) must be stored somewhere.

In our example too, a remote control with macro commands can play a vital role to attract customers. For example, let’s say we need a button/mode on our remote. With this button, the user can configure much of the equipment all together. Let’s call this mode, the party mode. When party mode is selected, the remote should dim the lights, play the CD player, set the volume and so on. Fundamentally, the remote must know which commands to executes and in which order. That’s where Macro Commands are relevant.

Let’s see an example as in the following:
  1. //Receivers  
  2. Light light= new Light();  
  3. TV tv= new TV();  
  4. --------  
  5. //setting concrete commands and it‘s receivers  
  6. LightOnCommand lightOn= new LightOnCommand(light);  
  7. TVOnCommand TVOn= new TVOnCommand(Tv);  
  8. ------  
  9. //command collection both on and off  
  10. Command[] partyOn={lightOn, TVOn,…..};  
  11. Command[] partyOff={lightOff,TV TVOff,…..};  
  12. //set macro commands that accepts a collection of commands  
  13. MacroCommand partyOnMacro= new MacroCommand(partyOn);  
  14. MacroCommand partyOffMacro= new MacroCommand(partyOff);  
  15. //assign macro command to button on remote control  
  16. remoteControl.SetCommand(7, partyOnMacro,partyOffMacro);  
  17. -------  
  18. // Playiton  
  19. remoteControl.SwitchOn();  
  20. -----  
  21. //switchitOff  
  22. remoteControl.SwitchOff();  
Macro Commands 
  • Can make a Concrete Command (subclass of Command) that contains a list of commands.

  • Commands can be given at construction, or set up via method calls.

  • The Execute method calls the execute method on each of the commands in the list.

  • How can we use this to provide a good progress indicator?

Other usages of command

  • Queuing requests

    – Can allocate commands to various threads for processing to load balance between threads/processors.

  • Logging requests (audit trail)

    – Just needs to save the command objects as they execute.

    – If something goes wrong, we can read the log and re-create the sequence of commands (so no data is lost).

    – Can also back out changes that cause trouble

Advantages and Disadvantages

  • Creating a structure

    – Invoker and Receiver are independent of each other.

  • Extensibility

    – add a new command without changing the existing code.

  • A sequence of commands

    – Macro Commands