Learning Builder Pattern using C#

Introduction

Design patterns are very useful and helps in resolving many real time issues, In this article we will try to understand Builder Pattern with the help of a Sample C# Program.

Background

Builder Pattern belongs to Creational Pattern as it deals with object creation, this pattern is used multiple times in .NET Framework. One example would be ConnectionStringBuilder. Builder Pattern comes into picture when we need to create a product using a series of complex process where each process can be separated , that means we can separate each step of object creation and the same object mechanism can be used for creating similar products or objects.

GoF describes Builder Pattern as Separate the construction of a complex object from its representation so that the same construction process can create different representations. Builder Pattern consists of below items.

Director: Director is responsible for creation of object using Builder interface or base class.

Builder: Base class or Interface which has different steps mentioned for creating a Product.

ConcreteBuilder: Defines the concrete builder which is an implementation of above Builder. Concrete Builder will help us to create and get the below Product using series of steps mentioned in Builder.

Product: The final Product, which will be created through many complex steps.

BuilderPattern

Using the code

To start with th sample program, I have created a Television (Product) class as below, this Product will be constructed by the Builder. Added different properties to show the different parts of product.

///
<summary>
/// Television - Product
/// </summary>

class Television
{
    public string Code { get; set; }
    public string DisplayTechnology { get; set; }
    public string HDFormat { get; set; }
    public string ScreenType { get; set; }
    public string Size { get; set; }
    public string Feature { get; set; }
}

Now we will create the TelevisionBuilder (Builder), which will define the complex steps for creating the Product. We can create the Builder as an Interface or Base Class. If you look at the below class definition, you can see the steps for creating the Product and Property or Method to access the created Product.

///
<summary>
/// TelevisionBuilder - Builder
/// </summary>

abstract class TelevisionBuilder
{
    protected Television television;

    public abstract void SetCode();//ProductCode
    public abstract void SetDisplayTechnology(); //LCD, LED, OLED, Plasma, CRT
    public abstract void SetHDFormat(); // Full HD, HD Ready, Ultra HD, None
    public abstract void SetScreenType(); //Curved, Flat, Standard
    public abstract void SetSize(); // 22, 32, 40, 42, 54
    public abstract void SetFeature(); //3D, Smart, Standard , HDMI Ports, USB Ports, Built in WIFI, Ethernet, Remote

    //GetProduct
    public Television Television
    {
        get { return television; }
    }

}

Defining FullHD40TVBuilder (ConcreteBuilder1) with respective implementation.

///
<summary>
/// FullHD40TVBuilder - ConcreteBuilder1
/// </summary>

class FullHD40TVBuilder : TelevisionBuilder
{

    public FullHD40TVBuilder()
    {
        television = new Television();
    }

    public override void SetCode()
    {
        television.Code = "FullHD40TV";
    }

    public override void SetDisplayTechnology()
    {
        television.DisplayTechnology = "LCD";
    }

    public override void SetHDFormat()
    {
        television.HDFormat = "FullHD";
    }

    public override void SetScreenType()
    {
        television.ScreenType="Flat";
    }

    public override void SetSize()
    {
        television.Size="40";
    }

    public override void SetFeature()
    {
        television.Feature = "1 HDMI Ports, 1 USB Ports, Remote";
    }
}

Defining SMARTLED54TVBuilder (ConcreteBuilder2) with respective implementation.

///
<summary>
/// SMARTLED54TVBuilder - ConcreteBuilder2
/// </summary>

class SMARTLED54TVBuilder : TelevisionBuilder
{
    public SMARTLED54TVBuilder()
    {
        television = new Television();
    }

    public override void SetCode()
    {
        television.Code = "SMARTLED54TV";
    }

    public override void SetDisplayTechnology()
    {
        television.DisplayTechnology = "LED";
    }

    public override void SetHDFormat()
    {
        television.HDFormat =   "FullHD";
    }

    public override void SetScreenType()
    {
        television.ScreenType="Flat";
    }

    public override void SetSize()
    {
        television.Size="54";
    }

    public override void SetFeature()
    {
        television.Feature="2 HDMI Ports, 2 USB Ports, Built in WIFI, Ethernet, Remote";
    }
}

Defining Curved4K65LEDTVBuilder (ConcreteBuilder3) with respective implementation.

///
<summary>
/// Curved4K65LEDTVBuilder - ConcreteBuilder3
/// </summary>

class Curved4K65LEDTVBuilder : TelevisionBuilder
{
    public Curved4K65LEDTVBuilder()
    {
        television = new Television();
    }

    public override void SetCode()
    {
        television.Code = "Curved4K65LEDTV";
    }

    public override void SetDisplayTechnology()
    {
        television.DisplayTechnology = "LED";
    }

    public override void SetHDFormat()
    {
        television.HDFormat =   "4K Ultra HD";
    }

    public override void SetScreenType()
    {
        television.ScreenType="Curved";
    }

    public override void SetSize()
    {
        television.Size="65";
    }

    public override void SetFeature()
    {
        television.Feature="3 HDMI Ports, 2 USB Ports, Built in WIFI, Ethernet, Smart Remote";
    }
}

Defining LCD22TVBuilder (ConcreteBuilder4) with respective implementation.

///
<summary>
/// LCD22TVBuilder - ConcreteBuilder4
/// </summary>

class LCD22TVBuilder : TelevisionBuilder
{
    public LCD22TVBuilder()
    {
        television = new Television();
    }

    public override void SetCode()
    {
        television.Code = "LCD22TV";
    }

    public override void SetDisplayTechnology()
    {
        television.DisplayTechnology = "LCD";
    }

    public override void SetHDFormat()
    {
        television.HDFormat = "None";
    }

    public override void SetScreenType()
    {
        television.ScreenType = "Flat";
    }

    public override void SetSize()
    {
        television.Size = "22";
    }

    public override void SetFeature()
    {
        television.Feature = "Remote";
    }
}

As of now we have defined Product, Builder and ConcreteBuilder, Now lets create TelevisionManufacturer as the Director, here the argument is Builder, and the Director takes care of calling the steps based on the requirement.

///
<summary>
/// TelevisionManufacturer - Director
/// </summary>

class TelevisionManufacturer
{
    //Constructing Product
    public void Construct(TelevisionBuilder televisionBuilder)
    {
        //Series of Complex Process
        televisionBuilder.SetCode();
        televisionBuilder.SetDisplayTechnology();
        televisionBuilder.SetHDFormat();
        televisionBuilder.SetScreenType();
        televisionBuilder.SetSize();
        televisionBuilder.SetFeature();
    }
}

Have created a console Program to test the Builder Pattern Sample, here the end clinet is not at all worried about the complex object creation.

///
/// Program class which demonstrates the builder usage
///

class Program
{
///
/// Main method of Program.cs
///

///static void Main(string[] args)
{
TelevisionBuilder builder;

TelevisionManufacturer director = new TelevisionManufacturer();

builder = new FullHD40TVBuilder();
director.Construct(builder);
Television product1 = builder.Television;

Console.WriteLine("Code:{0}", product1.Code);

builder = new SMARTLED54TVBuilder();
director.Construct(builder);
Television product2 = builder.Television;

Console.WriteLine("Code:{0}", product2.Code);

builder = new Curved4K65LEDTVBuilder();
director.Construct(builder);
Television product3 = builder.Television;

Console.WriteLine("Code:{0}", product3.Code);

builder = new LCD22TVBuilder();
director.Construct(builder);
Television product4 = builder.Television;

Console.WriteLine("Code:{0}", product4.Code);
//Wait for UserInteraction
Console.ReadKey();

}
}

Output

Some codes are removed from above Console.Writeline to look the code simple. You can refer the Program.cs file in the attached project to see the final version.

BuilderPatternSampleOutput.png

To explore this sample yourself you can download the attached code or create a console project named “BuilderPatternSample” and replace the content of Program.cs with below code block.

Program.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace BuilderPatternSample
{
    ///
<summary>
    /// Program class which demonstrates the builder usage
    /// </summary>

    class Program
    {
        ///
<summary>
        /// Main method of Program.cs
        /// </summary>

        /// <param name="args"></param>
        static void Main(string[] args)
        {
            TelevisionBuilder builder;

            TelevisionManufacturer director = new TelevisionManufacturer();

            builder = new FullHD40TVBuilder();
            director.Construct(builder);
            Television product1 = builder.Television;

            Console.WriteLine("     ┌───────────────────────────────────Code:{0}───────────────────────────────┐", product1.Code);
            Console.WriteLine("     │                         DisplayTechnology:{0}                                   │", product1.DisplayTechnology);
            Console.WriteLine("     │                         HDFormat:{0}                                         │", product1.HDFormat);
            Console.WriteLine("     │                         ScreenType:{0}                                         │", product1.ScreenType);
            Console.WriteLine("     │                         Size:{0}                                                 │", product1.Size);
            Console.WriteLine("     │                         Feature:{0}               │", product1.Feature);
            Console.WriteLine("     └─────────────────────────────────────────────────────────────────────────────────┘");

            builder = new SMARTLED54TVBuilder();
            director.Construct(builder);
            Television product2 = builder.Television;

            Console.WriteLine("     ┌──────────────────────────────────Code:{0}──────────────────────────────┐", product2.Code);
            Console.WriteLine("     │        DisplayTechnology:{0}                                                    │", product2.DisplayTechnology);
            Console.WriteLine("     │        HDFormat:{0}                                                          │", product2.HDFormat);
            Console.WriteLine("     │        ScreenType:{0}                                                          │", product2.ScreenType);
            Console.WriteLine("     │        Size:{0}                                                                  │", product2.Size);
            Console.WriteLine("     │        Feature:{0}       │", product2.Feature);
            Console.WriteLine("     └─────────────────────────────────────────────────────────────────────────────────┘");

            builder = new Curved4K65LEDTVBuilder();
            director.Construct(builder);
            Television product3 = builder.Television;

            Console.WriteLine("     ┌─────────────────────────────────Code:{0}────────────────────────────┐", product3.Code);
            Console.WriteLine("     │       DisplayTechnology:{0}                                                     │", product3.DisplayTechnology);
            Console.WriteLine("     │       HDFormat:{0}                                                      │", product3.HDFormat);
            Console.WriteLine("     │       ScreenType:{0}                                                         │", product3.ScreenType);
            Console.WriteLine("     │       Size:{0}                                                                   │", product3.Size);
            Console.WriteLine("     │       Feature:{0}  │", product3.Feature);
            Console.WriteLine("     └─────────────────────────────────────────────────────────────────────────────────┘");

            builder = new LCD22TVBuilder();
            director.Construct(builder);
            Television product4 = builder.Television;

            Console.WriteLine("     ┌────────────────────────────────────Code:{0}─────────────────────────────────┐", product4.Code);
            Console.WriteLine("     │                         DisplayTechnology:{0}                                   │", product4.DisplayTechnology);
            Console.WriteLine("     │                         HDFormat:{0}                                           │", product4.HDFormat);
            Console.WriteLine("     │                         ScreenType:{0}                                         │", product4.ScreenType);
            Console.WriteLine("     │                         Size:{0}                                                 │", product4.Size);
            Console.WriteLine("     │                         Feature:{0}                                          │", product4.Feature);
            Console.WriteLine("     └─────────────────────────────────────────────────────────────────────────────────┘");

            //Wait for UserInteraction
            Console.ReadKey();

        }
    }

    ///
<summary>
    /// Television - Product
    /// </summary>

    class Television
    {
        public string Code { get; set; }
        public string DisplayTechnology { get; set; }
        public string HDFormat { get; set; }
        public string ScreenType { get; set; }
        public string Size { get; set; }
        public string Feature { get; set; }
    }

    ///
<summary>
    /// TelevisionBuilder - Builder
    /// </summary>

    abstract class TelevisionBuilder
    {
        protected Television television;

        public abstract void SetCode();//ProductCode
        public abstract void SetDisplayTechnology(); //LCD, LED, OLED, Plasma, CRT
        public abstract void SetHDFormat(); // Full HD, HD Ready, Ultra HD, None
        public abstract void SetScreenType(); //Curved, Flat, Standard
        public abstract void SetSize(); // 22, 32, 40, 42, 54
        public abstract void SetFeature(); //3D, Smart, Standard , HDMI Ports, USB Ports, Built in WIFI, Ethernet, Remote

        //GetProduct
        public Television Television
        {
            get { return television; }
        }

    }

    ///
<summary>
    /// FullHD40TVBuilder - ConcreteBuilder1
    /// </summary>

    class FullHD40TVBuilder : TelevisionBuilder
    {

        public FullHD40TVBuilder()
        {
            television = new Television();
        }

        public override void SetCode()
        {
            television.Code = "FullHD40TV";
        }

        public override void SetDisplayTechnology()
        {
            television.DisplayTechnology = "LCD";
        }

        public override void SetHDFormat()
        {
            television.HDFormat = "FullHD";
        }

        public override void SetScreenType()
        {
            television.ScreenType = "Flat";
        }

        public override void SetSize()
        {
            television.Size = "40";
        }

        public override void SetFeature()
        {
            television.Feature = "1 HDMI Ports, 1 USB Ports, Remote";
        }
    }

    ///
<summary>
    /// SMARTLED54TVBuilder - ConcreteBuilder2
    /// </summary>

    class SMARTLED54TVBuilder : TelevisionBuilder
    {
        public SMARTLED54TVBuilder()
        {
            television = new Television();
        }

        public override void SetCode()
        {
            television.Code = "SMARTLED54TV";
        }

        public override void SetDisplayTechnology()
        {
            television.DisplayTechnology = "LED";
        }

        public override void SetHDFormat()
        {
            television.HDFormat = "FullHD";
        }

        public override void SetScreenType()
        {
            television.ScreenType = "Flat";
        }

        public override void SetSize()
        {
            television.Size = "54";
        }

        public override void SetFeature()
        {
            television.Feature = "2 HDMI Ports, 2 USB Ports, Built in WIFI, Ethernet, Remote";
        }
    }

    ///
<summary>
    /// Curved4K65LEDTVBuilder - ConcreteBuilder3
    /// </summary>

    class Curved4K65LEDTVBuilder : TelevisionBuilder
    {
        public Curved4K65LEDTVBuilder()
        {
            television = new Television();
        }

        public override void SetCode()
        {
            television.Code = "Curved4K65LEDTV";
        }

        public override void SetDisplayTechnology()
        {
            television.DisplayTechnology = "LED";
        }

        public override void SetHDFormat()
        {
            television.HDFormat = "4K Ultra HD";
        }

        public override void SetScreenType()
        {
            television.ScreenType = "Curved";
        }

        public override void SetSize()
        {
            television.Size = "65";
        }

        public override void SetFeature()
        {
            television.Feature = "3 HDMI Ports, 2 USB Ports, Built in WIFI, Ethernet, Smart Remote";
        }
    }

    ///
<summary>
    /// LCD22TVBuilder - ConcreteBuilder4
    /// </summary>

    class LCD22TVBuilder : TelevisionBuilder
    {
        public LCD22TVBuilder()
        {
            television = new Television();
        }

        public override void SetCode()
        {
            television.Code = "LCD22TV";
        }

        public override void SetDisplayTechnology()
        {
            television.DisplayTechnology = "LCD";
        }

        public override void SetHDFormat()
        {
            television.HDFormat = "None";
        }

        public override void SetScreenType()
        {
            television.ScreenType = "Flat";
        }

        public override void SetSize()
        {
            television.Size = "22";
        }

        public override void SetFeature()
        {
            television.Feature = "Remote";
        }
    }

    ///
<summary>
    /// TelevisionManufacturer - Director
    /// </summary>

    class TelevisionManufacturer
    {
        //Constructing Product
        public void Construct(TelevisionBuilder televisionBuilder)
        {
            //Series of Complex Process
            televisionBuilder.SetCode();
            televisionBuilder.SetDisplayTechnology();
            televisionBuilder.SetHDFormat();
            televisionBuilder.SetScreenType();
            televisionBuilder.SetSize();
            televisionBuilder.SetFeature();
        }
    }
}

Summary

In this article I have explained Builder Pattern with a simple C# application. I hope you have enjoyed this article and got some value addition to your knowledge. Please don’t forget to mark your votes, suggestions and feedback to improve the quality of this and upcoming articles.

Click here to Download Builder Pattern Sample – 10.2 KB

Advertisements