Introduction

🎉 Ultra-simplified explanation to design patterns! 🎉

A topic that can easily make anyone's mind wobble. Here I try to make them stick in to your
mind (and maybe mine) by explaining them in the simplest way possible.

_{Check out my other project and say "hi" on Twitter.}

Creational Design Patterns	Structural Design Patterns	Behavioral Design Patterns
Simple Factory	Adapter	Chain of Responsibility
Factory Method	Bridge	Command
Abstract Factory	Composite	Iterator
Builder	Decorator	Mediator
Prototype	Facade	Memento
Singleton	Flyweight	Observer
	Proxy	Visitor
		Strategy
		State
		Template Method

Introduction

Design patterns are solutions to recurring problems; guidelines on how to tackle certain problems. They are not classes, packages or libraries that you can plug into your application and wait for the magic to happen. These are, rather, guidelines on how to tackle certain problems in certain situations.

Design patterns are solutions to recurring problems; guidelines on how to tackle certain problems

Wikipedia describes them as

In software engineering, a software design pattern is a general reusable solution to a commonly occurring problem within a given context in software design. It is not a finished design that can be transformed directly into source or machine code. It is a description or template for how to solve a problem that can be used in many different situations.

⚠️ Be Careful

Design patterns are not a silver bullet to all your problems.
Do not try to force them; bad things are supposed to happen, if done so.
Keep in mind that design patterns are solutions to problems, not solutions finding problems; so don't overthink.
If used in a correct place in a correct manner, they can prove to be a savior; or else they can result in a horrible mess of a code.

Also note that the code samples below are in C#, however this shouldn't stop you because the concepts are same anyways. If you want to see PHP examples, refer to the original forked repo.

Types of Design Patterns

Creational Design Patterns

In plain words

Creational patterns are focused towards how to instantiate an object or group of related objects.

Wikipedia says

In software engineering, creational design patterns are design patterns that deal with object creation mechanisms, trying to create objects in a manner suitable to the situation. The basic form of object creation could result in design problems or added complexity to the design. Creational design patterns solve this problem by somehow controlling this object creation.

🏠 Simple Factory

Real world example

Consider, you are building a house and you need doors. You can either put on your carpenter clothes, bring some wood, glue, nails and all the tools required to build the door and start building it in your house or you can simply call the factory and get the built door delivered to you so that you don't need to learn anything about the door making or to deal with the mess that comes with making it.

In plain words

Simple factory simply generates an instance for client without exposing any instantiation logic to the client

Wikipedia says

In object-oriented programming (OOP), a factory is an object for creating other objects – formally a factory is a function or method that returns objects of a varying prototype or class from some method call, which is assumed to be "new".

Programmatic Example

First of all we have a door interface and the implementation

public interface IDoor
{
    float GetWidth();
    float GetHeight();
}

public class WoodenDoor : IDoor
{
    public float Width { get; }
    public float Height { get; }

    public WoodenDoor(float width, float height)
    {
        Width = width;
        Height = height;
    }
}

Then we have our door factory that makes the door and returns it

public static class DoorFactory
{
    public static IDoor MakeDoor(float width, float height)
    {
        return new WoodenDoor(width, height);
    }
}

And then it can be used as

class Program
{
    // Make me a door of 100x200
    static void Main(string[] args)
    {
        IDoor door = DoorFactory.MakeDoor(100, 200);

        Console.WriteLine("Width: " + door.GetWidth());
        Console.WriteLine("Height: " + door.GetHeight());

        // Make me a door of 50x100
        IDoor door2 = DoorFactory.MakeDoor(50, 100);
    }
}

When to Use?

When creating an object is not just a few assignments and involves some logic, it makes sense to put it in a dedicated factory instead of repeating the same code everywhere.

🏭 Factory Method

Real world example

Consider the case of a hiring manager. It is impossible for one person to interview for each of the positions. Based on the job opening, she has to decide and delegate the interview steps to different people.

In plain words

It provides a way to delegate the instantiation logic to child classes.

Wikipedia says

In class-based programming, the factory method pattern is a creational pattern that uses factory methods to deal with the problem of creating objects without having to specify the exact class of the object that will be created. This is done by creating objects by calling a factory method—either specified in an interface and implemented by child classes, or implemented in a base class and optionally overridden by derived classes—rather than by calling a constructor.

Programmatic Example

Taking our hiring manager example above. First of all we have an interviewer interface and some implementations for it

public interface IInterviewer
{
    void AskQuestions();
}

public class Developer : IInterviewer
{
    public void AskQuestions()
    {
        Console.WriteLine("Asking about design patterns!");
    }
}

public class CommunityExecutive : IInterviewer
{
    public void AskQuestions()
    {
        Console.WriteLine("Asking about community building");
    }
}

Now let us create our HiringManager

public abstract class HiringManager
{
    // Factory method
    protected abstract IInterviewer MakeInterviewer();

    public void TakeInterview()
    {
        IInterviewer interviewer = MakeInterviewer();
        interviewer.AskQuestions();
    }
}

Now any child can extend it and provide the required interviewer

public class DevelopmentManager : HiringManager
{
    protected override IInterviewer MakeInterviewer()
    {
        return new Developer();
    }
}

public class MarketingManager : HiringManager
{
    protected override IInterviewer MakeInterviewer()
    {
        return new CommunityExecutive();
    }
}

and then it can be used as

class Program
{
    static void Main(string[] args)
    {
        DevelopmentManager devManager = new DevelopmentManager();
        devManager.TakeInterview(); // Output: Asking about design patterns

        MarketingManager marketingManager = new MarketingManager();
        marketingManager.TakeInterview(); // Output: Asking about community building.
    }
}

When to use?

Useful when there is some generic processing in a class but the required sub-class is dynamically decided at runtime. Or putting it in other words, when the client doesn't know what exact sub-class it might need.

🔨 Abstract Factory

Real world example

Extending our door example from Simple Factory. Based on your needs you might get a wooden door from a wooden door shop, iron door from an iron shop or a PVC door from the relevant shop. Plus you might need a guy with different kind of specialities to fit the door, for example a carpenter for wooden door, welder for iron door etc. As you can see there is a dependency between the doors now, wooden door needs carpenter, iron door needs a welder etc.

In plain words

A factory of factories; a factory that groups the individual but related/dependent factories together without specifying their concrete classes.

Wikipedia says

The abstract factory pattern provides a way to encapsulate a group of individual factories that have a common theme without specifying their concrete classes

Programmatic Example

Translating the door example above. First of all we have our Door interface and some implementation for it

public interface IDoor
{
    void GetDescription();
}

public class WoodenDoor : IDoor
{
    public void GetDescription()
    {
        Console.WriteLine("I am a wooden door");
    }
}

public class IronDoor : IDoor
{
    public void GetDescription()
    {
        Console.WriteLine("I am an iron door");
    }
}

Then we have some fitting experts for each door type

public interface IDoorFittingExpert
{
    void GetDescription();
}

public class Welder : IDoorFittingExpert
{
    public void GetDescription()
    {
        Console.WriteLine("I can only fit iron doors");
    }
}

public class Carpenter : IDoorFittingExpert
{
    public void GetDescription()
    {
        Console.WriteLine("I can only fit wooden doors");
    }
}

Now we have our abstract factory that would let us make family of related objects i.e. wooden door factory would create a wooden door and wooden door fitting expert and iron door factory would create an iron door and iron door fitting expert

public interface IDoorFactory
{
    IDoor MakeDoor();
    IDoorFittingExpert MakeFittingExpert();
}

// Wooden factory to return carpenter and wooden door
public class WoodenDoorFactory : IDoorFactory
{
    public IDoor MakeDoor()
    {
        return new WoodenDoor();
    }

    public IDoorFittingExpert MakeFittingExpert()
    {
        return new Carpenter();
    }
}

// Iron door factory to get iron door and the relevant fitting expert
public class IronDoorFactory : IDoorFactory
{
    public IDoor MakeDoor()
    {
        return new IronDoor();
    }

    public IDoorFittingExpert MakeFittingExpert()
    {
        return new Welder();
    }
}

And then it can be used as

class Program
{
    static void Main(string[] args)
    {
        // Using wooden door factory
        IDoorFactory woodenFactory = new WoodenDoorFactory();

        IDoor door = woodenFactory.MakeDoor();
        IDoorFittingExpert expert = woodenFactory.MakeFittingExpert();

        door.GetDescription();  // Output: I am a wooden door
        expert.GetDescription(); // Output: I can only fit wooden doors

        // Using iron door factory
        IDoorFactory ironFactory = new IronDoorFactory();

        door = ironFactory.MakeDoor();
        expert = ironFactory.MakeFittingExpert();

        door.GetDescription();  // Output: I am an iron door
        expert.GetDescription(); // Output: I can only fit iron doors
    }
}

As you can see the wooden door factory has encapsulated the carpenter and the wooden door also iron door factory has encapsulated the iron door and welder. And thus it had helped us make sure that for each of the created door, we do not get a wrong fitting expert.

When to use?

When there are interrelated dependencies with not-that-simple creation logic involved

👷 Builder

Real world example

Imagine you are at Hardee's and you order a specific deal, lets say, "Big Hardee" and they hand it over to you without any questions; this is the example of simple factory. But there are cases when the creation logic might involve more steps. For example you want a customized Subway deal, you have several options in how your burger is made e.g what bread do you want? what types of sauces would you like? What cheese would you want? etc. In such cases builder pattern comes to the rescue.

In plain words

Allows you to create different flavors of an object while avoiding constructor pollution. Useful when there could be several flavors of an object. Or when there are a lot of steps involved in creation of an object.

Wikipedia says

The builder pattern is an object creation software design pattern with the intentions of finding a solution to the telescoping constructor anti-pattern.

Having said that let me add a bit about what telescoping constructor anti-pattern is. At one point or the other we have all seen a constructor like below:

public Pizza(int size, bool cheese = true, bool pepperoni = true, bool tomato = false, bool lettuce = true)
{
    // Constructor logic here
}

As you can see; the number of constructor parameters can quickly get out of hand and it might become difficult to understand the arrangement of parameters. Plus this parameter list could keep on growing if you would want to add more options in future. This is called telescoping constructor anti-pattern.

Programmatic Example

The sane alternative is to use the builder pattern. First of all we have our burger that we want to make

public class Burger
{
    protected int size;

    protected bool cheese = false;
    protected bool pepperoni = false;
    protected bool lettuce = false;
    protected bool tomato = false;

    public Burger(BurgerBuilder builder)
    {
        this.size = builder.Size;
        this.cheese = builder.Cheese;
        this.pepperoni = builder.Pepperoni;
        this.lettuce = builder.Lettuce;
        this.tomato = builder.Tomato;
    }
}

And then we have the builder

public class BurgerBuilder
{
    public int Size { get; }
    public bool Cheese { get; private set; } = false;
    public bool Pepperoni { get; private set; } = false;
    public bool Lettuce { get; private set; } = false;
    public bool Tomato { get; private set; } = false;

    public BurgerBuilder(int size)
    {
        this.Size = size;
    }

    public BurgerBuilder AddPepperoni()
    {
        this.Pepperoni = true;
        return this;
    }

    public BurgerBuilder AddLettuce()
    {
        this.Lettuce = true;
        return this;
    }

    public BurgerBuilder AddCheese()
    {
        this.Cheese = true;
        return this;
    }

    public BurgerBuilder AddTomato()
    {
        this.Tomato = true;
        return this;
    }

    public Burger Build()
    {
        return new Burger(this);
    }
}

And then it can be used as:

var burger = new BurgerBuilder(14)
    .AddPepperoni()
    .AddLettuce()
    .AddTomato()
    .Build();

When to use?

When there could be several flavors of an object and to avoid the constructor telescoping. The key difference from the factory pattern is that; factory pattern is to be used when the creation is a one step process while builder pattern is to be used when the creation is a multi step process.

🐑 Prototype

Real world example

Remember dolly? The sheep that was cloned! Lets not get into the details but the key point here is that it is all about cloning

In plain words

Create object based on an existing object through cloning.

Wikipedia says

The prototype pattern is a creational design pattern in software development. It is used when the type of objects to create is determined by a prototypical instance, which is cloned to produce new objects.

In short, it allows you to create a copy of an existing object and modify it to your needs, instead of going through the trouble of creating an object from scratch and setting it up.

Programmatic Example

In PHP, it can be easily done using clone

public class Sheep
{
    public string Name { get; private set; }
    public string Category { get; private set; }

    public Sheep(string name, string category = "Mountain Sheep")
    {
        Name = name;
        Category = category;
    }

    public void SetName(string name)
    {
        Name = name;
    }

    public void SetCategory(string category)
    {
        Category = category;
    }
}

Then it can be cloned like below

using System;

public class Program
{
    public static void Main(string[] args)
    {
        // Creating an original Sheep
        Sheep original = new Sheep("Jolly");
        Console.WriteLine(original.GetName()); // Jolly
        Console.WriteLine(original.GetCategory()); // Mountain Sheep

        // Cloning the original Sheep
        Sheep cloned = (Sheep)original.Clone();
        cloned.SetName("Dolly");
        Console.WriteLine(cloned.GetName()); // Dolly
        Console.WriteLine(cloned.GetCategory()); // Mountain sheep
    }
}

using System;

public class Sheep : ICloneable
{
    public string Name { get; set; }
    public string Category { get; set; }

    // Constructor
    public Sheep(string name, string category = "Mountain Sheep")
    {
        Name = name;
        Category = category;
    }

    // Implementing the Clone method
    public object Clone()
    {
        // Shallow copy
        return this.MemberwiseClone();
    }
}

When to use?

When an object is required that is similar to existing object or when the creation would be expensive as compared to cloning.

💍 Singleton

Real world example

There can only be one president of a country at a time. The same president has to be brought to action, whenever duty calls. President here is singleton.

In plain words

Ensures that only one object of a particular class is ever created.

Wikipedia says

In software engineering, the singleton pattern is a software design pattern that restricts the instantiation of a class to one object. This is useful when exactly one object is needed to coordinate actions across the system.

Singleton pattern is actually considered an anti-pattern and overuse of it should be avoided. It is not necessarily bad and could have some valid use-cases but should be used with caution because it introduces a global state in your application and change to it in one place could affect in the other areas and it could become pretty difficult to debug. The other bad thing about them is it makes your code tightly coupled plus mocking the singleton could be difficult.

Programmatic Example

To create a singleton, make the constructor private, disable cloning, disable extension and create a static variable to house the instance

public sealed class President
{
    private static President instance;

    private President()
    {
        // Hide the constructor
    }

    public static President GetInstance()
    {
        if (instance == null)
        {
            instance = new President();
        }
        return instance;
    }

    private President(President other)
    {
        // Disable cloning
    }

    private void OnDeserialization(object sender)
    {
        // Disable deserialization
    }
}

Then in order to use

class Program
{
    static void Main(string[] args)
    {
        // Getting instances of President
        President president1 = President.GetInstance();
        President president2 = President.GetInstance();

        // Comparing instances
        Console.WriteLine(president1 == president2); // true
    }
}

Structural Design Patterns

In plain words

Structural patterns are mostly concerned with object composition or in other words how the entities can use each other. Or yet another explanation would be, they help in answering "How to build a software component?"

Wikipedia says

In software engineering, structural design patterns are design patterns that ease the design by identifying a simple way to realize relationships between entities.

🔌 Adapter

Real world example

Consider that you have some pictures in your memory card and you need to transfer them to your computer. In order to transfer them you need some kind of adapter that is compatible with your computer ports so that you can attach memory card to your computer. In this case card reader is an adapter. Another example would be the famous power adapter; a three legged plug can't be connected to a two pronged outlet, it needs to use a power adapter that makes it compatible with the two pronged outlet. Yet another example would be a translator translating words spoken by one person to another

In plain words

Adapter pattern lets you wrap an otherwise incompatible object in an adapter to make it compatible with another class.

Wikipedia says

In software engineering, the adapter pattern is a software design pattern that allows the interface of an existing class to be used as another interface. It is often used to make existing classes work with others without modifying their source code.

Programmatic Example

Consider a game where there is a hunter and he hunts lions.

First we have an interface Lion that all types of lions have to implement

using System;

public interface ILion
{
    void Roar();
}

public class AfricanLion : ILion
{
    public void Roar()
    {
        // Implementation of roar for AfricanLion
    }
}

public class AsianLion : ILion
{
    public void Roar()
    {
        // Implementation of roar for AsianLion
    }
}

And hunter expects any implementation of Lion interface to hunt.

using System;

public class Hunter
{
    public void Hunt(ILion lion)
    {
        lion.Roar();
    }
}

Now let's say we have to add a WildDog in our game so that hunter can hunt that also. But we can't do that directly because dog has a different interface. To make it compatible for our hunter, we will have to create an adapter that is compatible

// This needs to be added to the game
using System;

public class WildDog
{
    public void Bark()
    {
        // Implementation of bark for WildDog
    }
}


// Adapter around wild dog to make it compatible with our game
using System;

public class WildDogAdapter : ILion
{
    private readonly WildDog dog;

    public WildDogAdapter(WildDog dog)
    {
        this.dog = dog;
    }

    public void Roar()
    {
        this.dog.Bark();
    }
}

And now the WildDog can be used in our game using WildDogAdapter.

class Program
{
    static void Main(string[] args)
    {
        // Creating a WildDog instance
        WildDog wildDog = new WildDog();
        
        // Creating a WildDogAdapter instance
        WildDogAdapter wildDogAdapter = new WildDogAdapter(wildDog);
        
        // Creating a Hunter instance
        Hunter hunter = new Hunter();
        
        // Calling the hunt method of Hunter with WildDogAdapter
        hunter.Hunt(wildDogAdapter);
    }
}

🚡 Bridge

Real world example

Consider you have a website with different pages and you are supposed to allow the user to change the theme. What would you do? Create multiple copies of each of the pages for each of the themes or would you just create separate theme and load them based on the user's preferences? Bridge pattern allows you to do the second i.e.

In Plain Words

Bridge pattern is about preferring composition over inheritance. Implementation details are pushed from a hierarchy to another object with a separate hierarchy.

Wikipedia says

The bridge pattern is a design pattern used in software engineering that is meant to "decouple an abstraction from its implementation so that the two can vary independently"

Programmatic Example

Translating our WebPage example from above. Here we have the WebPage hierarchy

using System;

public interface IWebPage
{
    void SetTheme(ITheme theme);
    string GetContent();
}

public class About : IWebPage
{
    private ITheme theme;

    public void SetTheme(ITheme theme)
    {
        this.theme = theme;
    }

    public string GetContent()
    {
        return "About page in " + this.theme.GetColor();
    }
}

public class Careers : IWebPage
{
    private ITheme theme;

    public void SetTheme(ITheme theme)
    {
        this.theme = theme;
    }

    public string GetContent()
    {
        return "Careers page in " + this.theme.GetColor();
    }
}

And the separate theme hierarchy

using System;

public interface ITheme
{
    string GetColor();
}

public class DarkTheme : ITheme
{
    public string GetColor()
    {
        return "Dark Black";
    }
}

public class LightTheme : ITheme
{
    public string GetColor()
    {
        return "Off white";
    }
}

public class AquaTheme : ITheme
{
    public string GetColor()
    {
        return "Light blue";
    }
}

And both the hierarchies

class Program
{
    static void Main(string[] args)
    {
        // Creating a DarkTheme instance
        ITheme darkTheme = new DarkTheme();

        // Creating About and Careers instances with DarkTheme
        IWebPage about = new About();
        about.SetTheme(darkTheme);

        IWebPage careers = new Careers();
        careers.SetTheme(darkTheme);

        // Getting content
        Console.WriteLine(about.GetContent()); // "About page in Dark Black"
        Console.WriteLine(careers.GetContent()); // "Careers page in Dark Black"
    }
}

🌿 Composite

Real world example

Every organization is composed of employees. Each of the employees has the same features i.e. has a salary, has some responsibilities, may or may not report to someone, may or may not have some subordinates etc.

In plain words

Composite pattern lets clients treat the individual objects in a uniform manner.

Wikipedia says

In software engineering, the composite pattern is a partitioning design pattern. The composite pattern describes that a group of objects is to be treated in the same way as a single instance of an object. The intent of a composite is to "compose" objects into tree structures to represent part-whole hierarchies. Implementing the composite pattern lets clients treat individual objects and compositions uniformly.

Programmatic Example

Taking our employees example from above. Here we have different employee types

using System;

public interface IEmployee
{
    string Name { get; }
    float Salary { get; set; }
    string[] Roles { get; }
}

public class Developer : IEmployee
{
    public string Name { get; }
    public float Salary { get; set; }
    public string[] Roles { get; }

    public Developer(string name, float salary)
    {
        Name = name;
        Salary = salary;
    }
}

public class Designer : IEmployee
{
    public string Name { get; }
    public float Salary { get; set; }
    public string[] Roles { get; }

    public Designer(string name, float salary)
    {
        Name = name;
        Salary = salary;
    }
}

Then we have an organization which consists of several different types of employees

using System;
using System.Collections.Generic;

public class Organization
{
    private List<Employee> employees;

    public Organization()
    {
        employees = new List<Employee>();
    }

    public void AddEmployee(Employee employee)
    {
        employees.Add(employee);
    }

    public float GetNetSalaries()
    {
        float netSalary = 0;

        foreach (Employee employee in employees)
        {
            netSalary += employee.GetSalary();
        }

        return netSalary;
    }
}

And then it can be used as

using System;

class Program
{
    static void Main(string[] args)
    {
        // Prepare the employees
        Employee john = new Developer("John Doe", 12000);
        Employee jane = new Designer("Jane Doe", 15000);

        // Add them to organization
        Organization organization = new Organization();
        organization.AddEmployee(john);
        organization.AddEmployee(jane);

        Console.WriteLine("Net salaries: " + organization.GetNetSalaries()); // Net Salaries: 27000
    }
}

☕ Decorator

Real world example

Imagine you run a car service shop offering multiple services. Now how do you calculate the bill to be charged? You pick one service and dynamically keep adding to it the prices for the provided services till you get the final cost. Here each type of service is a decorator.

In plain words

Decorator pattern lets you dynamically change the behavior of an object at run time by wrapping them in an object of a decorator class.

Wikipedia says

In object-oriented programming, the decorator pattern is a design pattern that allows behavior to be added to an individual object, either statically or dynamically, without affecting the behavior of other objects from the same class. The decorator pattern is often useful for adhering to the Single Responsibility Principle, as it allows functionality to be divided between classes with unique areas of concern.

Programmatic Example

Lets take coffee for example. First of all we have a simple coffee implementing the coffee interface

using System;

public interface ICoffee
{
    float GetCost();
    string GetDescription();
}

public class SimpleCoffee : ICoffee
{
    public float GetCost()
    {
        return 10;
    }

    public string GetDescription()
    {
        return "Simple coffee";
    }
}

We want to make the code extensible to allow options to modify it if required. Lets make some add-ons (decorators)

using System;

public class MilkCoffee : ICoffee
{
    private readonly ICoffee coffee;

    public MilkCoffee(ICoffee coffee)
    {
        this.coffee = coffee;
    }

    public float GetCost()
    {
        return this.coffee.GetCost() + 2;
    }

    public string GetDescription()
    {
        return this.coffee.GetDescription() + ", milk";
    }
}

public class WhipCoffee : ICoffee
{
    private readonly ICoffee coffee;

    public WhipCoffee(ICoffee coffee)
    {
        this.coffee = coffee;
    }

    public float GetCost()
    {
        return this.coffee.GetCost() + 5;
    }

    public string GetDescription()
    {
        return this.coffee.GetDescription() + ", whip";
    }
}

public class VanillaCoffee : ICoffee
{
    private readonly ICoffee coffee;

    public VanillaCoffee(ICoffee coffee)
    {
        this.coffee = coffee;
    }

    public float GetCost()
    {
        return this.coffee.GetCost() + 3;
    }

    public string GetDescription()
    {
        return this.coffee.GetDescription() + ", vanilla";
    }
}

Lets make a coffee now

using System;

public class Program
{
    public static void Main(string[] args)
    {
        ICoffee someCoffee = new SimpleCoffee();
        Console.WriteLine(someCoffee.GetCost()); // 10
        Console.WriteLine(someCoffee.GetDescription()); // Simple Coffee

        someCoffee = new MilkCoffee(someCoffee);
        Console.WriteLine(someCoffee.GetCost()); // 12
        Console.WriteLine(someCoffee.GetDescription()); // Simple Coffee, milk

        someCoffee = new WhipCoffee(someCoffee);
        Console.WriteLine(someCoffee.GetCost()); // 17
        Console.WriteLine(someCoffee.GetDescription()); // Simple Coffee, milk, whip

        someCoffee = new VanillaCoffee(someCoffee);
        Console.WriteLine(someCoffee.GetCost()); // 20
        Console.WriteLine(someCoffee.GetDescription()); // Simple Coffee, milk, whip, vanilla
    }
}

📦 Facade

Real world example

How do you turn on the computer? "Hit the power button" you say! That is what you believe because you are using a simple interface that computer provides on the outside, internally it has to do a lot of stuff to make it happen. This simple interface to the complex subsystem is a facade.

In plain words

Facade pattern provides a simplified interface to a complex subsystem.

Wikipedia says

A facade is an object that provides a simplified interface to a larger body of code, such as a class library.

Programmatic Example

Taking our computer example from above. Here we have the computer class

using System;

public class Computer
{
    public void GetElectricShock()
    {
        Console.WriteLine("Ouch!");
    }

    public void MakeSound()
    {
        Console.WriteLine("Beep beep!");
    }

    public void ShowLoadingScreen()
    {
        Console.WriteLine("Loading..");
    }

    public void Bam()
    {
        Console.WriteLine("Ready to be used!");
    }

    public void CloseEverything()
    {
        Console.WriteLine("Bup bup bup buzzzz!");
    }

    public void Sooth()
    {
        Console.WriteLine("Zzzzz");
    }

    public void PullCurrent()
    {
        Console.WriteLine("Haaah!");
    }
}

Here we have the facade

using System;

public class ComputerFacade
{
    private Computer computer;

    public ComputerFacade(Computer computer)
    {
        this.computer = computer;
    }

    public void TurnOn()
    {
        this.computer.GetElectricShock();
        this.computer.MakeSound();
        this.computer.ShowLoadingScreen();
        this.computer.Bam();
    }

    public void TurnOff()
    {
        this.computer.CloseEverything();
        this.computer.PullCurrent();
        this.computer.Sooth();
    }
}

Now to use the facade

using System;

public class Program
{
    public static void Main(string[] args)
    {
        ComputerFacade computer = new ComputerFacade(new Computer());
        computer.TurnOn(); // Ouch! Beep beep! Loading.. Ready to be used!
        computer.TurnOff(); // Bup bup buzzzz! Haaah! Zzzzz
    }
}

🍃 Flyweight

Real world example

Did you ever have fresh tea from some stall? They often make more than one cup that you demanded and save the rest for any other customer so to save the resources e.g. gas etc. Flyweight pattern is all about that i.e. sharing.

In plain words

It is used to minimize memory usage or computational expenses by sharing as much as possible with similar objects.

Wikipedia says

In computer programming, flyweight is a software design pattern. A flyweight is an object that minimizes memory use by sharing as much data as possible with other similar objects; it is a way to use objects in large numbers when a simple repeated representation would use an unacceptable amount of memory.

Programmatic example

Translating our tea example from above. First of all we have tea types and tea maker

using System;
using System.Collections.Generic;

// Anything that will be cached is flyweight.
// Types of tea here will be flyweights.
class KarakTea
{
}

// Acts as a factory and saves the tea
class TeaMaker
{
    private Dictionary<string, KarakTea> availableTea = new Dictionary<string, KarakTea>();

    public KarakTea Make(string preference)
    {
        if (!availableTea.ContainsKey(preference))
        {
            availableTea[preference] = new KarakTea();
        }

        return availableTea[preference];
    }
}

Then we have the TeaShop which takes orders and serves them

using System;
using System.Collections.Generic;

class TeaShop
{
    private Dictionary<int, KarakTea> orders = new Dictionary<int, KarakTea>();
    private TeaMaker teaMaker;

    public TeaShop(TeaMaker teaMaker)
    {
        this.teaMaker = teaMaker;
    }

    public void TakeOrder(string teaType, int table)
    {
        orders[table] = teaMaker.Make(teaType);
    }

    public void Serve()
    {
        foreach (var order in orders)
        {
            Console.WriteLine("Serving tea to table# " + order.Key);
        }
    }
}

And it can be used as below

using System;

public class Program
{
    public static void Main(string[] args)
    {
        TeaMaker teaMaker = new TeaMaker();
        TeaShop shop = new TeaShop(teaMaker);

        shop.TakeOrder("less sugar", 1);
        shop.TakeOrder("more milk", 2);
        shop.TakeOrder("without sugar", 5);

        shop.Serve();
        // Serving tea to table# 1
        // Serving tea to table# 2
        // Serving tea to table# 5
    }
}

🎱 Proxy

Real world example

Have you ever used an access card to go through a door? There are multiple options to open that door i.e. it can be opened either using access card or by pressing a button that bypasses the security. The door's main functionality is to open but there is a proxy added on top of it to add some functionality. Let me better explain it using the code example below.

In plain words

Using the proxy pattern, a class represents the functionality of another class.

Wikipedia says

A proxy, in its most general form, is a class functioning as an interface to something else. A proxy is a wrapper or agent object that is being called by the client to access the real serving object behind the scenes. Use of the proxy can simply be forwarding to the real object, or can provide additional logic. In the proxy extra functionality can be provided, for example caching when operations on the real object are resource intensive, or checking preconditions before operations on the real object are invoked.

Programmatic Example

Taking our security door example from above. Firstly we have the door interface and an implementation of door

using System;

public interface IDoor
{
    void Open();
    void Close();
}

public class LabDoor : IDoor
{
    public void Open()
    {
        Console.WriteLine("Opening lab door");
    }

    public void Close()
    {
        Console.WriteLine("Closing the lab door");
    }
}

Then we have a proxy to secure any doors that we want

using System;

public class SecuredDoor : Door
{
    private Door _door;

    public SecuredDoor(Door door)
    {
        _door = door;
    }

    public void Open(string password)
    {
        if (Authenticate(password))
        {
            _door.Open();
        }
        else
        {
            Console.WriteLine("Big no! It ain't possible.");
        }
    }

    public bool Authenticate(string password)
    {
        return password == "$ecr@t";
    }

    public void Close()
    {
        _door.Close();
    }
}

And here is how it can be used

using System;

public class Program
{
    public static void Main(string[] args)
    {
        // Create an instance of LabDoor (or any other door implementation)
        Door labDoor = new LabDoor();

        // Create a secured door using the LabDoor
        SecuredDoor securedDoor = new SecuredDoor(labDoor);

        // Attempt to open the secured door with different passwords
        securedDoor.Open("invalid"); // Big no! It ain't possible.
        securedDoor.Open("$ecr@t"); // Opening lab door

        // Close the door
        securedDoor.Close(); // Closing lab door
    }
}

Yet another example would be some sort of data-mapper implementation. For example, I recently made an ODM (Object Data Mapper) for MongoDB using this pattern where I wrote a proxy around mongo classes while utilizing the magic method __call(). All the method calls were proxied to the original mongo class and result retrieved was returned as it is but in case of find or findOne data was mapped to the required class objects and the object was returned instead of Cursor.

Behavioral Design Patterns

In plain words

It is concerned with assignment of responsibilities between the objects. What makes them different from structural patterns is they don't just specify the structure but also outline the patterns for message passing/communication between them. Or in other words, they assist in answering "How to run a behavior in software component?"

Wikipedia says

In software engineering, behavioral design patterns are design patterns that identify common communication patterns between objects and realize these patterns. By doing so, these patterns increase flexibility in carrying out this communication.

🔗 Chain of Responsibility

Real world example

For example, you have three payment methods (A, B and C) setup in your account; each having a different amount in it. A has 100 USD, B has 300 USD and C having 1000 USD and the preference for payments is chosen as A then B then C. You try to purchase something that is worth 210 USD. Using Chain of Responsibility, first of all account A will be checked if it can make the purchase, if yes purchase will be made and the chain will be broken. If not, request will move forward to account B checking for amount if yes chain will be broken otherwise the request will keep forwarding till it finds the suitable handler. Here A, B and C are links of the chain and the whole phenomenon is Chain of Responsibility.

In plain words

It helps building a chain of objects. Request enters from one end and keeps going from object to object till it finds the suitable handler.

Wikipedia says

In object-oriented design, the chain-of-responsibility pattern is a design pattern consisting of a source of command objects and a series of processing objects. Each processing object contains logic that defines the types of command objects that it can handle; the rest are passed to the next processing object in the chain.

Programmatic Example

Translating our account example above. First of all we have a base account having the logic for chaining the accounts together and some accounts

using System;

public abstract class Account
{
    protected Account successor;
    protected float balance;

    public void SetNext(Account account)
    {
        successor = account;
    }

    public void Pay(float amountToPay)
    {
        if (CanPay(amountToPay))
        {
            Console.WriteLine($"Paid {amountToPay} using {GetType().Name}");
        }
        else if (successor != null)
        {
            Console.WriteLine($"Cannot pay using {GetType().Name}. Proceeding ..");
            successor.Pay(amountToPay);
        }
        else
        {
            throw new Exception("None of the accounts have enough balance");
        }
    }

    public bool CanPay(float amount)
    {
        return balance >= amount;
    }
}

public class Bank : Account
{
    public Bank(float balance)
    {
        this.balance = balance;
    }
}

public class Paypal : Account
{
    public Paypal(float balance)
    {
        this.balance = balance;
    }
}

public class Bitcoin : Account
{
    public Bitcoin(float balance)
    {
        this.balance = balance;
    }
}

Now let's prepare the chain using the links defined above (i.e. Bank, Paypal, Bitcoin)

using System;

public class Program
{
    public static void Main(string[] args)
    {
        Bank bank = new Bank(100);          // Bank with balance 100
        Paypal paypal = new Paypal(200);    // Paypal with balance 200
        Bitcoin bitcoin = new Bitcoin(300); // Bitcoin with balance 300

        bank.SetNext(paypal);
        paypal.SetNext(bitcoin);

        // Let's try to pay using the first priority i.e. bank
        bank.Pay(259);
    }
}

👮 Command

Real world example

A generic example would be you ordering food at a restaurant. You (i.e. Client) ask the waiter (i.e. Invoker) to bring some food (i.e. Command) and waiter simply forwards the request to Chef (i.e. Receiver) who has the knowledge of what and how to cook. Another example would be you (i.e. Client) switching on (i.e. Command) the television (i.e. Receiver) using a remote control (Invoker).

In plain words

Allows you to encapsulate actions in objects. The key idea behind this pattern is to provide the means to decouple client from receiver.

Wikipedia says

In object-oriented programming, the command pattern is a behavioral design pattern in which an object is used to encapsulate all information needed to perform an action or trigger an event at a later time. This information includes the method name, the object that owns the method and values for the method parameters.

Programmatic Example

First of all we have the receiver that has the implementation of every action that could be performed

using System;

class Bulb
{
    public void TurnOn()
    {
        Console.WriteLine("Bulb has been lit");
    }

    public void TurnOff()
    {
        Console.WriteLine("Darkness!");
    }
}

then we have an interface that each of the commands are going to implement and then we have a set of commands

using System;

public interface ICommand
{
    void Execute();
    void Undo();
    void Redo();
}

public class TurnOn : ICommand
{
    private Bulb _bulb;

    public TurnOn(Bulb bulb)
    {
        _bulb = bulb;
    }

    public void Execute()
    {
        _bulb.TurnOn();
    }

    public void Undo()
    {
        _bulb.TurnOff();
    }

    public void Redo()
    {
        Execute();
    }
}

public class TurnOff : ICommand
{
    private Bulb _bulb;

    public TurnOff(Bulb bulb)
    {
        _bulb = bulb;
    }

    public void Execute()
    {
        _bulb.TurnOff();
    }

    public void Undo()
    {
        _bulb.TurnOn();
    }

    public void Redo()
    {
        Execute();
    }
}

Then we have an Invoker with whom the client will interact to process any commands

// Invoker
public class RemoteControl
{
    public void Submit(ICommand command)
    {
        command.Execute();
    }
}

Finally let's see how we can use it in our client

using System;

public class Program
{
    public static void Main(string[] args)
    {
        Bulb bulb = new Bulb();

        TurnOn turnOn = new TurnOn(bulb);
        TurnOff turnOff = new TurnOff(bulb);

        RemoteControl remote = new RemoteControl();
        remote.Submit(turnOn); // Bulb has been lit!
        remote.Submit(turnOff); // Darkness!
    }
}

Command pattern can also be used to implement a transaction based system. Where you keep maintaining the history of commands as soon as you execute them. If the final command is successfully executed, all good otherwise just iterate through the history and keep executing the undo on all the executed commands.

➿ Iterator

Real world example

An old radio set will be a good example of iterator, where user could start at some channel and then use next or previous buttons to go through the respective channels. Or take an example of MP3 player or a TV set where you could press the next and previous buttons to go through the consecutive channels or in other words they all provide an interface to iterate through the respective channels, songs or radio stations.

In plain words

It presents a way to access the elements of an object without exposing the underlying presentation.

Wikipedia says

In object-oriented programming, the iterator pattern is a design pattern in which an iterator is used to traverse a container and access the container's elements. The iterator pattern decouples algorithms from containers; in some cases, algorithms are necessarily container-specific and thus cannot be decoupled.

Programmatic example

In PHP it is quite easy to implement using SPL (Standard PHP Library). Translating our radio stations example from above. First of all we have RadioStation

using System;

public class RadioStation
{
    private float _frequency;

    public RadioStation(float frequency)
    {
        _frequency = frequency;
    }

    public float GetFrequency()
    {
        return _frequency;
    }
}

Then we have our iterator

using System;
using System.Collections.Generic;

public class StationList : IEnumerable<RadioStation>
{
    private List<RadioStation> _stations = new List<RadioStation>();
    private int _counter;

    public void AddStation(RadioStation station)
    {
        _stations.Add(station);
    }

    public void RemoveStation(RadioStation toRemove)
    {
        _stations.RemoveAll(station => station.GetFrequency() == toRemove.GetFrequency());
    }

    public int Count => _stations.Count;

    public RadioStation Current => _stations[_counter];

    public int Key => _counter;

    public void Next()
    {
        _counter++;
    }

    public void Rewind()
    {
        _counter = 0;
    }

    public bool IsValid => _counter < _stations.Count;

    // public IEnumerator<RadioStation> GetEnumerator()
    // {
    //     return _stations.GetEnumerator();
    // }

    // IEnumerator IEnumerable.GetEnumerator()
    // {
    //     return GetEnumerator();
    // }
}

And then it can be used as

using System;
using System.Collections.Generic;

public class Program
{
    public static void Main(string[] args)
    {
        StationList stationList = new StationList();

        stationList.AddStation(new RadioStation(89));
        stationList.AddStation(new RadioStation(101));
        stationList.AddStation(new RadioStation(102));
        stationList.AddStation(new RadioStation(103.2));

        foreach (RadioStation station in stationList)
        {
            Console.WriteLine(station.GetFrequency());
        }

        stationList.RemoveStation(new RadioStation(89)); // Will remove station 89
    }
}

👽 Mediator

Real world example

A general example would be when you talk to someone on your mobile phone, there is a network provider sitting between you and them and your conversation goes through it instead of being directly sent. In this case network provider is mediator.

In plain words

Mediator pattern adds a third party object (called mediator) to control the interaction between two objects (called colleagues). It helps reduce the coupling between the classes communicating with each other. Because now they don't need to have the knowledge of each other's implementation.

Wikipedia says

In software engineering, the mediator pattern defines an object that encapsulates how a set of objects interact. This pattern is considered to be a behavioral pattern due to the way it can alter the program's running behavior.

Programmatic Example

Here is the simplest example of a chat room (i.e. mediator) with users (i.e. colleagues) sending messages to each other.

First of all, we have the mediator i.e. the chat room

using System;

public interface IChatRoomMediator
{
    void ShowMessage(User user, string message);
}

public class ChatRoom : IChatRoomMediator
{
    public void ShowMessage(User user, string message)
    {
        string time = DateTime.Now.ToString("MMM dd, yy HH:mm");
        string sender = user.GetName();

        Console.WriteLine($"{time} [{sender}]: {message}");
    }
}

Then we have our users i.e. colleagues

public class User
{
    private string name;
    private IChatRoomMediator chatMediator;

    public User(string name, IChatRoomMediator chatMediator)
    {
        this.name = name;
        this.chatMediator = chatMediator;
    }

    public string GetName()
    {
        return name;
    }

    public void Send(string message)
    {
        chatMediator.ShowMessage(this, message);
    }
}

And the usage

class Program
{
    static void Main(string[] args)
    {
        IChatRoomMediator mediator = new ChatRoom();

        User john = new User("John Doe", mediator);
        User jane = new User("Jane Doe", mediator);

        john.Send("Hi there!");
        jane.Send("Hey!");
    }
}

💾 Memento

Real world example

Take the example of calculator (i.e. originator), where whenever you perform some calculation the last calculation is saved in memory (i.e. memento) so that you can get back to it and maybe get it restored using some action buttons (i.e. caretaker).

In plain words

Memento pattern is about capturing and storing the current state of an object in a manner that it can be restored later on in a smooth manner.

Wikipedia says

The memento pattern is a software design pattern that provides the ability to restore an object to its previous state (undo via rollback).

Usually useful when you need to provide some sort of undo functionality.

Programmatic Example

Lets take an example of text editor which keeps saving the state from time to time and that you can restore if you want.

First of all we have our memento object that will be able to hold the editor state

public class EditorMemento
{
    private string content;

    public EditorMemento(string content)
    {
        this.content = content;
    }

    public string GetContent()
    {
        return content;
    }
}

Then we have our editor i.e. originator that is going to use memento object

public class Editor
{
    private string content = "";

    public void Type(string words)
    {
        content += " " + words;
    }

    public string GetContent()
    {
        return content;
    }

    public EditorMemento Save()
    {
        return new EditorMemento(content);
    }

    public void Restore(EditorMemento memento)
    {
        content = memento.GetContent();
    }
}

And then it can be used as

class Program
{
    static void Main(string[] args)
    {
        // Create editor instance
        Editor editor = new Editor();

        // Type some stuff
        editor.Type("This is the first sentence.");
        editor.Type("This is second.");

        // Save the state to restore to : This is the first sentence. This is second.
        EditorMemento saved = editor.Save();

        // Type some more
        editor.Type("And this is third.");

        // Output: Content before Saving
        Console.WriteLine(editor.GetContent()); // This is the first sentence. This is second. And this is third.

        // Restoring to last saved state
        editor.Restore(saved);

        Console.WriteLine(editor.GetContent()); // This is the first sentence. This is second.
    }
}

😎 Observer

Real world example

A good example would be the job seekers where they subscribe to some job posting site and they are notified whenever there is a matching job opportunity.

In plain words

Defines a dependency between objects so that whenever an object changes its state, all its dependents are notified.

Wikipedia says

The observer pattern is a software design pattern in which an object, called the subject, maintains a list of its dependents, called observers, and notifies them automatically of any state changes, usually by calling one of their methods.

Programmatic example

Translating our example from above. First of all we have job seekers that need to be notified for a job posting

using System;

public interface Observer
{
    void OnJobPosted(JobPost job);
}

public class JobPost
{
    protected string title;

    public JobPost(string title)
    {
        this.title = title;
    }

    public string GetTitle()
    {
        return title;
    }
}

public class JobSeeker : Observer
{
    protected string name;

    public JobSeeker(string name)
    {
        this.name = name;
    }

    public void OnJobPosted(JobPost job)
    {
        // Do something with the job posting
        Console.WriteLine($"Hi {name}! New job posted: {job.GetTitle()}");
    }
}

Then we have our job postings to which the job seekers will subscribe

using System;
using System.Collections.Generic;

public interface Observable
{
    void Attach(Observer observer);
    void AddJob(JobPost jobPosting);
}

public class EmploymentAgency : Observable
{
    protected List<Observer> observers = new List<Observer>();

    protected void Notify(JobPost jobPosting)
    {
        foreach (var observer in observers)
        {
            observer.OnJobPosted(jobPosting);
        }
    }

    public void Attach(Observer observer)
    {
        observers.Add(observer);
    }

    public void AddJob(JobPost jobPosting)
    {
        Notify(jobPosting);
    }
}

Then it can be used as

class Program
{
    static void Main(string[] args)
    {
        // Create subscribers
        var johnDoe = new JobSeeker("John Doe");
        var janeDoe = new JobSeeker("Jane Doe");

        // Create publisher and attach subscribers
        var jobPostings = new EmploymentAgency();
        jobPostings.Attach(johnDoe);
        jobPostings.Attach(janeDoe);

        // Add a new job and see if subscribers get notified
        jobPostings.AddJob(new JobPost("Software Engineer"));

        // Output
        // Hi John Doe! New job posted: Software Engineer
        // Hi Jane Doe! New job posted: Software Engineer
    }
}

🏃 Visitor

Real world example

Consider someone visiting Dubai. They just need a way (i.e. visa) to enter Dubai. After arrival, they can come and visit any place in Dubai on their own without having to ask for permission or to do some leg work in order to visit any place here; just let them know of a place and they can visit it. Visitor pattern lets you do just that, it helps you add places to visit so that they can visit as much as they can without having to do any legwork.

In plain words

Visitor pattern lets you add further operations to objects without having to modify them.

Wikipedia says

In object-oriented programming and software engineering, the visitor design pattern is a way of separating an algorithm from an object structure on which it operates. A practical result of this separation is the ability to add new operations to existing object structures without modifying those structures. It is one way to follow the open/closed principle.

Programmatic example

Let's take an example of a zoo simulation where we have several different kinds of animals and we have to make them Sound. Let's translate this using visitor pattern

// Visitee
interface IAnimal
{
    void Accept(IAnimalOperation operation);
}

// Visitor
interface IAnimalOperation
{
    void VisitMonkey(Monkey monkey);
    void VisitLion(Lion lion);
    void VisitDolphin(Dolphin dolphin);
}

Then we have our implementations for the animals

class Monkey : IAnimal
{
    public void Shout()
    {
        Console.WriteLine("Ooh oo aa aa!");
    }

    public void Accept(IAnimalOperation operation)
    {
        operation.VisitMonkey(this);
    }
}

class Lion : IAnimal
{
    public void Roar()
    {
        Console.WriteLine("Roaaar!");
    }

    public void Accept(IAnimalOperation operation)
    {
        operation.VisitLion(this);
    }
}

class Dolphin : IAnimal
{
    public void Speak()
    {
        Console.WriteLine("Tuut tuttu tuutt!");
    }

    public void Accept(IAnimalOperation operation)
    {
        operation.VisitDolphin(this);
    }
}

Let's implement our visitor

class Speak : IAnimalOperation
{
    public void VisitMonkey(Monkey monkey)
    {
        monkey.Shout();
    }

    public void VisitLion(Lion lion)
    {
        lion.Roar();
    }

    public void VisitDolphin(Dolphin dolphin)
    {
        dolphin.Speak();
    }
}

And then it can be used as

class Program
{
    static void Main(string[] args)
    {
        Monkey monkey = new Monkey();
        Lion lion = new Lion();
        Dolphin dolphin = new Dolphin();

        Speak speak = new Speak();

        monkey.Accept(speak);    // Ooh oo aa aa!    
        lion.Accept(speak);      // Roaaar!
        dolphin.Accept(speak);   // Tuut tuttu tuutt!
    }
}

We could have done this simply by having an inheritance hierarchy for the animals but then we would have to modify the animals whenever we would have to add new actions to animals. But now we will not have to change them. For example, let's say we are asked to add the jump behavior to the animals, we can simply add that by creating a new visitor i.e.

public class Jump : AnimalOperation
{
    public void VisitMonkey(Monkey monkey)
    {
        Console.WriteLine("Jumped 20 feet high! on to the tree!");
    }

    public void VisitLion(Lion lion)
    {
        Console.WriteLine("Jumped 7 feet! Back on the ground!");
    }

    public void VisitDolphin(Dolphin dolphin)
    {
        Console.WriteLine("Walked on water a little and disappeared");
    }
}

And for the usage

Jump jump = new Jump();

monkey.Accept(speak);   // Ooh oo aa aa!
monkey.Accept(jump);    // Jumped 20 feet high! on to the tree!

lion.Accept(speak);     // Roaaar!
lion.Accept(jump);      // Jumped 7 feet! Back on the ground!

dolphin.Accept(speak);  // Tuut tutt tuutt!
dolphin.Accept(jump);   // Walked on water a little and disappeared

💡 Strategy

Real world example

Consider the example of sorting, we implemented bubble sort but the data started to grow and bubble sort started getting very slow. In order to tackle this we implemented Quick sort. But now although the quick sort algorithm was doing better for large datasets, it was very slow for smaller datasets. In order to handle this we implemented a strategy where for small datasets, bubble sort will be used and for larger, quick sort.

In plain words

Strategy pattern allows you to switch the algorithm or strategy based upon the situation.

Wikipedia says

In computer programming, the strategy pattern (also known as the policy pattern) is a behavioural software design pattern that enables an algorithm's behavior to be selected at runtime.

Programmatic example

Translating our example from above. First of all we have our strategy interface and different strategy implementations

using System;

// Strategy interface
interface SortStrategy
{
    int[] Sort(int[] dataset);
}

// Concrete strategy: Bubble Sort
class BubbleSortStrategy : SortStrategy
{
    public int[] Sort(int[] dataset)
    {
        Console.WriteLine("Sorting using bubble sort");

        // Do sorting
        return dataset;
    }
}

// Concrete strategy: Quick Sort
class QuickSortStrategy : SortStrategy
{
    public int[] Sort(int[] dataset)
    {
        Console.WriteLine("Sorting using quick sort");

        // Do sorting
        return dataset;
    }
}

And then we have our client that is going to use any strategy

using System;

class Sorter
{
    private SortStrategy sorterSmall;
    private SortStrategy sorterBig;

    public Sorter(SortStrategy sorterSmall, SortStrategy sorterBig)
    {
        this.sorterSmall = sorterSmall;
        this.sorterBig = sorterBig;
    }

    public int[] Sort(int[] dataset)
    {
        if (dataset.Length > 5)
        {
            return sorterBig.Sort(dataset);
        }
        else
        {
            return sorterSmall.Sort(dataset);
        }
    }
}

And it can be used as

using System;

class Program
{
    static void Main(string[] args)
    {
        int[] smallDataset = { 1, 3, 4, 2 };
        int[] bigDataset = { 1, 4, 3, 2, 8, 10, 5, 6, 9, 7 };

        Sorter sorter = new Sorter(new BubbleSortStrategy(), new QuickSortStrategy());

        sorter.Sort(smallDataset); // Output: Sorting using bubble sort

        sorter.Sort(bigDataset); // Output: Sorting using quick sort
    }
}

💢 State

Real world example

Imagine you are using some drawing application, you choose the paint brush to draw. Now the brush changes its behavior based on the selected color i.e. if you have chosen red color it will draw in red, if blue then it will be in blue etc.

In plain words

It lets you change the behavior of a class when the state changes.

Wikipedia says

The state pattern is a behavioral software design pattern that implements a state machine in an object-oriented way. With the state pattern, a state machine is implemented by implementing each individual state as a derived class of the state pattern interface, and implementing state transitions by invoking methods defined by the pattern's superclass. The state pattern can be interpreted as a strategy pattern which is able to switch the current strategy through invocations of methods defined in the pattern's interface.

Programmatic example

Let's take an example of a phone. First of all we have our state interface and some state implementations

using System;

// Interface
interface IPhoneState
{
    IPhoneState PickUp();
    IPhoneState HangUp();
    IPhoneState Dial();
}

// States implementation
class PhoneStateIdle : IPhoneState
{
    public IPhoneState PickUp()
    {
        return new PhoneStatePickedUp();
    }

    public IPhoneState HangUp()
    {
        throw new InvalidOperationException("Already idle");
    }

    public IPhoneState Dial()
    {
        throw new InvalidOperationException("Unable to dial in idle state");
    }
}

class PhoneStatePickedUp : IPhoneState
{
    public IPhoneState PickUp()
    {
        throw new InvalidOperationException("Already picked up");
    }

    public IPhoneState HangUp()
    {
        return new PhoneStateIdle();
    }

    public IPhoneState Dial()
    {
        return new PhoneStateCalling();
    }
}

class PhoneStateCalling : IPhoneState
{
    public IPhoneState PickUp()
    {
        throw new InvalidOperationException("Already picked up");
    }

    public IPhoneState HangUp()
    {
        return new PhoneStateIdle();
    }

    public IPhoneState Dial()
    {
        throw new InvalidOperationException("Already dialing");
    }
}

Then we have our Phone class that changes the state on different behavior calls

using System;

class Phone
{
    private IPhoneState state;

    public Phone()
    {
        this.state = new PhoneStateIdle();
    }

    public void PickUp()
    {
        this.state = this.state.PickUp();
    }

    public void HangUp()
    {
        this.state = this.state.HangUp();
    }

    public void Dial()
    {
        this.state = this.state.Dial();
    }
}

And then it can be used as follows and it will call the relevant state methods:

class Program
{
    static void Main(string[] args)
    {
        Phone phone = new Phone();

        phone.PickUp();
        phone.Dial();
    }
}

📒 Template Method

Real world example

Suppose we are getting some house built. The steps for building might look like

Prepare the base of house

Build the walls

Add roof

Add other floors

The order of these steps could never be changed i.e. you can't build the roof before building the walls etc but each of the steps could be modified for example walls can be made of wood or polyester or stone.

In plain words

Template method defines the skeleton of how a certain algorithm could be performed, but defers the implementation of those steps to the children classes.

Wikipedia says

In software engineering, the template method pattern is a behavioral design pattern that defines the program skeleton of an algorithm in an operation, deferring some steps to subclasses. It lets one redefine certain steps of an algorithm without changing the algorithm's structure.

Programmatic Example

Imagine we have a build tool that helps us test, lint, build, generate build reports (i.e. code coverage reports, linting report etc) and deploy our app on the test server.

First of all we have our base class that specifies the skeleton for the build algorithm

using System;

abstract class Builder
{
    // Template method
    public void Build()
    {
        Test();
        Lint();
        Assemble();
        Deploy();
    }

    public abstract void Test();
    public abstract void Lint();
    public abstract void Assemble();
    public abstract void Deploy();
}

Then we can have our implementations

using System;

class AndroidBuilder : Builder
{
    public override void Test()
    {
        Console.WriteLine("Running Android tests");
    }

    public override void Lint()
    {
        Console.WriteLine("Linting the Android code");
    }

    public override void Assemble()
    {
        Console.WriteLine("Assembling the Android build");
    }

    public override void Deploy()
    {
        Console.WriteLine("Deploying Android build to server");
    }
}

class IosBuilder : Builder
{
    public override void Test()
    {
        Console.WriteLine("Running iOS tests");
    }

    public override void Lint()
    {
        Console.WriteLine("Linting the iOS code");
    }

    public override void Assemble()
    {
        Console.WriteLine("Assembling the iOS build");
    }

    public override void Deploy()
    {
        Console.WriteLine("Deploying iOS build to server");
    }
}

And then it can be used as

class Program
{
    static void Main(string[] args)
    {
        AndroidBuilder androidBuilder = new AndroidBuilder();
        androidBuilder.Build();

        // Output:
        // Running android tests
        // Linting the android code
        // Assembling the android build
        // Deploying android build to server

        IosBuilder iosBuilder = new IosBuilder();
        iosBuilder.Build();

        // Output:
        // Running ios tests
        // Linting the ios code
        // Assembling the ios build
        // Deploying ios build to server
    }
}

🚦 Wrap Up Folks

And that about wraps it up. I will continue to improve this, so you might want to watch/star this repository to revisit. Also, I have plans on writing the same about the architectural patterns, stay tuned for it.

👬 Contribution

Report issues
Open pull request with improvements
Spread the word
Reach out with any feedback

Name		Name	Last commit message	Last commit date
Latest commit History 143 Commits
.github		.github
readme.md		readme.md

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Introduction

⚠️ Be Careful

Types of Design Patterns

Creational Design Patterns

🏠 Simple Factory

🏭 Factory Method

🔨 Abstract Factory

👷 Builder

🐑 Prototype

💍 Singleton

Structural Design Patterns

🔌 Adapter

🚡 Bridge

🌿 Composite

☕ Decorator

📦 Facade

🍃 Flyweight

🎱 Proxy

Behavioral Design Patterns

🔗 Chain of Responsibility

👮 Command

➿ Iterator

👽 Mediator

💾 Memento

😎 Observer

🏃 Visitor

💡 Strategy

💢 State

📒 Template Method

🚦 Wrap Up Folks

👬 Contribution

License

About

Releases

Packages

Ewerton/design-patterns-for-humans

Folders and files

Latest commit

History

Repository files navigation

Introduction

⚠️ Be Careful

Types of Design Patterns

Creational Design Patterns

🏠 Simple Factory

🏭 Factory Method

🔨 Abstract Factory

👷 Builder

🐑 Prototype

💍 Singleton

Structural Design Patterns

🔌 Adapter

🚡 Bridge

🌿 Composite

☕ Decorator

📦 Facade

🍃 Flyweight

🎱 Proxy

Behavioral Design Patterns

🔗 Chain of Responsibility

👮 Command

➿ Iterator

👽 Mediator

💾 Memento

😎 Observer

🏃 Visitor

💡 Strategy

💢 State

📒 Template Method

🚦 Wrap Up Folks

👬 Contribution

License

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Packages