Skip to main content

Design Patterns: Builder

This is also, like a Singleton , one of the creational design patterns. It provides the way of creating complex objects step by step by simple chaining and every particular step is independent of other steps.

Let us dive into the real example of usage. For showing purpose we have created an example in C# which creates simple SQL queries using described pattern. 



using System;
using System.Text;

namespace BuilderPatternExample
{
    public interface ISqlQueryBuilder
    {
        ISqlQueryBuilder Select(string columns);
        ISqlQueryBuilder From(string table);
        ISqlQueryBuilder Where(string condition);
        ISqlQueryBuilder OrderBy(string columns);
        string Build();
    }

    public class SelectQueryBuilder : ISqlQueryBuilder
    {
        private readonly StringBuilder _queryBuilder;

        public SelectQueryBuilder()
        {
            _queryBuilder = new StringBuilder();
        }

        public ISqlQueryBuilder Select(string columns)
        {
            _queryBuilder.Append($"SELECT {columns} ");
            return this;
        }

        public ISqlQueryBuilder From(string table)
        {
            _queryBuilder.Append($"FROM {table} ");
            return this;
        }

        public ISqlQueryBuilder Where(string condition)
        {
            _queryBuilder.Append($"WHERE {condition} ");
            return this;
        }

        public ISqlQueryBuilder OrderBy(string columns)
        {
            _queryBuilder.Append($"ORDER BY {columns} ");
            return this;
        }

        public string Build()
        {
            return _queryBuilder.ToString().Trim();
        }
    }
    

    class Program
    {
        static void Main(string[] args)
        {
            ISqlQueryBuilder queryBuilder = new SelectQueryBuilder();

            string query = queryBuilder
                .Select("id, name, age")
                .From("Users")
                .Where("age > 18")
                .OrderBy("name ASC")
                .Build();

            Console.WriteLine("Generated SQL Query:");
            Console.WriteLine(query);
        }
    }
}
  
In this particular example we can see that we avoid to use hardcoded SQL strings and provide one flexible way of building the queries. Same example can be extended to other SQL commands. In the end, client that uses the builder interface does not need to care about the order of commands, or on spelling of SQL keywords.


When to use it?

  • When constructing a complex object requires many steps.
  • To create object with lot of optional parameters.
  • When constructing objects with immutable states.
  • To improve code readability and reduce the complexity of the object creation logic.

When not to use it?

  • When having simple objects with few properties.
  • High-performance systems with frequent object creation.
  • A singleton or a constant-like object.
  • If the codebase is unlikely to grow or change significantly.

Conclusion

The Builder pattern is ideal for creating complex objects step-by-step, especially when they have many configurable parts or require different variations. It improves code readability, ensures consistency, and simplifies object construction by separating the build logic from the object itself. However, it’s best suited for scenarios where complexity justifies its use—avoid it for simple objects or straightforward creation processes.

Comments

Popular posts from this blog

Design Patterns: Strategy

The Strategy Pattern is a behavioral design pattern that defines a family of algorithms, encapsulates each one, and makes them interchangeable. This pattern allows the algorithm to be selected at runtime, providing flexibility in designing software. It’s particularly useful when you have multiple ways of performing a task, and you want to choose the implementation dynamically without altering the client code. When To Use It? You Have Multiple Algorithms or Behaviors. Use it when you have a need for muplitple ways of performing a task, and you want to make these implementations interchangeable. Examples: Different sorting algorithms, payment methods, discount calculations... You Want to Eliminate Conditional Logic.  If you find yourself writing large if-else or switch statements to decide which algorithm to use, this pattern can simplify and clean up your code. Examples: A game character with different attack styles  You Need Runtime Flexibility.  Use this pattern if the ...

Design Patterns: Singleton

Tyipically the first design pattern most people learn, often wrongly ☺ To give an introduction, we can say that singleton is one of the creational design patterns which ensures only one class instance with single point of access thru entire application.  Because it is relatively simple to implement, the Singleton pattern is sometimes misapplied in situations where it is not the most suitable choice. When to use it? Here are the few examples of corrent usage of singleton: Configuration Management  Centralized configuration settings for consistent use thru entire application Caching Maintaning  Single istance of cached objects for easy and fast acces Logging  Ensure unified mechanism to avoid duplication of log files, formats, etc Global State Management  Centralized management of the state which is needed to be shared accross the application Resource sharing  Thread pools, database connection, I/O operations When not to use it? On the other hand, here are fe...