Introduction to the Command Pattern

Welcome to the Behavioral Patterns course! In this lesson, we will explore the Command Pattern, a fundamental design pattern that is highly useful for promoting flexible and reusable code. This pattern is particularly effective in scenarios where you need to parameterize objects with operations, queues, or logs. You might remember from previous lessons that behavioral design patterns help with object communication and responsibility distribution within your software. The Command Pattern encapsulates a request as an object, thereby allowing users to parameterize clients with queues, requests, and operations. This encapsulation enables us to decouple the sender from the receiver, enhancing the flexibility and maintainability of the system. The Command Pattern involves creating a command interface with an execute method. We then create concrete command classes that implement this interface, each representing a specific action. Finally, we'll integrate these commands with a request invoker to execute the actions. This structure allows us to easily extend or modify commands without changing the invoker or the receiver.

Key Components and Their Implementation

To understand the Command Pattern, we should first identify its essential components: Command, Receiver, Concrete Commands, and Invoker . Here's a breakdown of each component, along with their implementations. Each of these components plays a critical role in decoupling the sender and receiver, thereby making the system more modular and flexible.

Command Interface

The Command interface declares an execute method that must be implemented by all concrete commands. This interface will help us define the actions to be executed. This interface enables a consistent method signature for executing various commands, making the system easier to extend. Python from abc import ABC, abstractmethod class Command(ABC): @abstractmethod def execute(self): pass

Receiver

The receiver is the object that performs the actual action. In our example, the Light class will serve as the receiver that can turn the light on or off. The receiver contains the actual logic that gets executed when the command is invoked. Python class Light: def on(self): print("Light is on.") def off(self): print("Light is off.") class Light: def on(self): print("Light is on.") def off(self): print("Light is off.")

Join the 1M+ learners on CodeSignal

Be a part of our community of 1M+ users who develop and demonstrate their skills on CodeSignal

Putting It All Together

Now that we have broken down the Command Pattern into its core components, let's put it all together in a cohesive example. The RemoteControl (invoker) holds and triggers the command objects without knowing their implementation details. The LightOnCommand and LightOffCommand (concrete commands) encapsulate actions on the Light (receiver), translating invoker requests into specific receiver operations. This setup decouples the sender (invoker) from the receiver, promoting flexibility and extensibility in the system. This example demonstrates how encapsulating requests as objects can significantly simplify the design of a system with multiple actions and receivers.

Python

from abc import ABC, abstractmethod

class Command(ABC):
    @abstractmethod
    def execute(self):
        pass

class Light:
    def on(self):
        print("Light is on.")

    def off(self):
        print("Light is off.")

class LightOnCommand(Command):
    def __init__(self, light):
        self.light = light

    def execute(self):
        self.light.on()

class LightOffCommand(Command):
    def __init__(self, light):
        self.light = light

    def execute(self):
        self.light.off()

class RemoteControl:
    def __init__(self):
        self.command = None

    def set_command(self, command):
        self.command = command

    def press_button(self):
        if self.command:
            self.command.execute()

if __name__ == "__main__":
    light = Light()
    light_on = LightOnCommand(light)
    light_off = LightOffCommand(light)

    remote = RemoteControl()
    remote.set_command(light_on)
    remote.press_button() # Output: Light is on.
    remote.set_command(light_off)
    remote.press_button() # Output: Light is off.

from abc import ABC, abstractmethod

class Command(ABC):
    @abstractmethod
    def execute(self):
        pass

class Light:
    def on(self):
        print("Light is on.")

    def off(self):
        print("Light is off.")

class LightOnCommand(Command):
    def __init__(self, light):
        self.light = light

    def execute(self):
        self.light.on()

class LightOffCommand(Command):
    def __init__(self, light):
        self.light = light

    def execute(self):
        self.light.off()

class RemoteControl:
    def __init__(self):
        self.command = None

    def set_command(self, command):
        self.command = command

    def press_button(self):
        if self.command:
            self.command.execute()

if __name__ == "__main__":
    light = Light()
    light_on = LightOnCommand(light)
    light_off = LightOffCommand(light)

    remote = RemoteControl()
    remote.set_command(light_on)
    remote.press_button() # Output: Light is on.
    remote.set_command(light_off)
    remote.press_button() # Output: Light is off.

Enhancing the Command Pattern

To make the example more dynamic and extendable while maintaining the proper usage of the Command Pattern with an invoker, we can introduce a dictionary within the invoker to manage our command objects. This adjustment allows us to easily look up and execute commands based on keys while still preserving the invoker's role. Here’s an updated version of the main section:

Python

class RemoteControl:
    def __init__(self):
        self.commands = {}

    def set_command(self, name, command):
        self.commands[name] = command

    def press_button(self, name):
        if name in self.commands:
            self.commands[name].execute()
        else:
            print(f"No command named '{name}' found.")

if __name__ == "__main__":
    light = Light()
    light_on = LightOnCommand(light)
    light_off = LightOffCommand(light)

    remote = RemoteControl()
    remote.set_command("lightOn", light_on)
    remote.set_command("lightOff", light_off)

    # Simulate user input
    remote.press_button("lightOn") # Output: Light is on.
    remote.press_button("lightOff") # Output: Light is off.

class RemoteControl:
    def __init__(self):
        self.commands = {}

    def set_command(self, name, command):
        self.commands[name] = command

    def press_button(self, name):
        if name in self.commands:
            self.commands[name].execute()
        else:
            print(f"No command named '{name}' found.")

if __name__ == "__main__":
    light = Light()
    light_on = LightOnCommand(light)
    light_off = LightOffCommand(light)

    remote = RemoteControl()
    remote.set_command("lightOn", light_on)
    remote.set_command("lightOff", light_off)

    # Simulate user input
    remote.press_button("lightOn") # Output: Light is on.
    remote.press_button("lightOff") # Output: Light is off.

In this enhancement, commands are stored in a dictionary within the RemoteControl (invoker), simplifying command referencing and execution via keys. This structure maintains the integrity of the Command Pattern, ensuring that the invoker triggers the commands. This dynamic structure helps handle various inputs and extends the system with ease.

Introduction to the Command Pattern