DEV Community

# 🌟 Design Principles of Software 🌟

Introduction πŸš€

Software design principles are fundamental guidelines that help developers create robust, maintainable, and scalable software systems. Applying these principles leads to code that is easier to understand, test, and evolve over time. This article explores several key design principles and illustrates them with a practical example using Go.

Key Design Principles πŸ’‘

Here's a breakdown of some essential design principles:

  • SOLID: A cornerstone of object-oriented design, SOLID represents five principles:
    • Single Responsibility Principle: A class should have only one reason to change.
    • Open/Closed Principle: Software entities (classes, modules, functions, etc.) should be open for extension, but closed for modification.
    • Liskov Substitution Principle: Subtypes should be substitutable for their base types without altering the correctness of the program.
    • Interface Segregation Principle: Clients should not be forced to depend on methods they do not use.
    • Dependency Inversion Principle: High-level modules should not depend on low-level modules. Both should depend on abstractions.
  • DRY (Don't Repeat Yourself): Avoid code duplication. Extract common logic into reusable components.
  • KISS (Keep It Simple, Stupid): Favor simplicity over complexity.
  • YAGNI (You Ain't Gonna Need It): Don't implement features until they are actually needed.
  • Law of Demeter (LoD): An object should only talk to its immediate neighbors.

Real-World Example: Order Processing System (Go) πŸ’»

Let's consider a simplified order processing system. We'll demonstrate the Single Responsibility Principle and Dependency Inversion Principle.

Bad Design (Violating SRP & DIP):

package main

import "fmt"

type Order struct {
    OrderID    int
    CustomerID int
    Items      []string
    TotalAmount float64
}

type OrderProcessor struct{}

func (o *OrderProcessor) ProcessOrder(order *Order) error {
    // Validate order
    if order.TotalAmount <= 0 {
        return fmt.Errorf("invalid order amount")
    }

    // Calculate shipping cost
    shippingCost := 5.0

    // Apply discount
    discount := 0.0
    if order.CustomerID == 123 {
        discount = 0.1 // 10% discount for customer 123
    }

    // Save order to database
    // ... (database saving logic here) ...

    // Send confirmation email
    // ... (email sending logic here) ...

    fmt.Println("Order processed successfully!")
    return nil
}

func main() {
    order := &Order{
        OrderID:       1,
        CustomerID:    123,
        Items:         []string{"Product A", "Product B"},
        TotalAmount:   100.0,
    }

    processor := &OrderProcessor{}
    err := processor.ProcessOrder(order)
    if err != nil {
        fmt.Println("Error:", err)
    }
}
Enter fullscreen mode Exit fullscreen mode

In this bad design, the OrderProcessor class handles order validation, shipping cost calculation, discount application, database saving, and email sending. This violates the Single Responsibility Principle because it has too many responsibilities. It also violates the Dependency Inversion Principle because it directly depends on concrete implementations (database, email service).

Good Design (Applying SRP & DIP):

package main

import (
    "fmt"
)

type Order struct {
    OrderID    int
    CustomerID int
    Items      []string
    TotalAmount float64
}

// OrderValidator interface
type OrderValidator interface {
    ValidateOrder(order *Order) error
}

// OrderSaver interface
type OrderSaver interface {
    SaveOrder(order *Order) error
}

// EmailService interface
type EmailService interface {
    SendConfirmationEmail(order *Order) error
}

type OrderValidatorImpl struct{}

func (o *OrderValidatorImpl) ValidateOrder(order *Order) error {
    if order.TotalAmount <= 0 {
        return fmt.Errorf("invalid order amount")
    }
    return nil
}

type OrderSaverImpl struct{}

func (o *OrderSaverImpl) SaveOrder(order *Order) error {
    // Simulate saving to database
    fmt.Println("Saving order to database...")
    return nil
}

type EmailServiceImpl struct{}

func (e *EmailServiceImpl) SendConfirmationEmail(order *Order) error {
    // Simulate sending email
    fmt.Println("Sending confirmation email...")
    return nil
}

type OrderProcessor struct {
    validator OrderValidator
    saver     OrderSaver
    emailService EmailService
}

func NewOrderProcessor(validator OrderValidator, saver OrderSaver, emailService EmailService) *OrderProcessor {
    return &OrderProcessor{validator: validator, saver: saver, emailService: emailService}
}

func (o *OrderProcessor) ProcessOrder(order *Order) error {
    if err := o.validator.ValidateOrder(order); err != nil {
        return err
    }

    // Calculate shipping cost, apply discount, etc. (simplified)

    if err := o.saver.SaveOrder(order); err != nil {
        return err
    }

    if err := o.emailService.SendConfirmationEmail(order); err != nil {
        return err
    }

    fmt.Println("Order processed successfully!")
    return nil
}

func main() {
    order := &Order{
        OrderID:       1,
        CustomerID:    123,
        Items:         []string{"Product A", "Product B"},
        TotalAmount:   100.0,
    }

    validator := &OrderValidatorImpl{}
    saver := &OrderSaverImpl{}
    emailService := &EmailServiceImpl{}

    processor := NewOrderProcessor(validator, saver, emailService)
    err := processor.ProcessOrder(order)
    if err != nil {
        fmt.Println("Error:", err)
    }
}
Enter fullscreen mode Exit fullscreen mode

In this improved design:

  • We've introduced interfaces (OrderValidator, OrderSaver, EmailService) to abstract the dependencies.
  • The OrderProcessor now depends on these interfaces instead of concrete implementations.
  • Each responsibility (validation, saving, email sending) is handled by a separate class, adhering to the Single Responsibility Principle.
  • This design is more flexible and testable because we can easily swap out different implementations of the interfaces.

Conclusion πŸŽ‰

Applying design principles is crucial for building maintainable and scalable software. By adhering to principles like SOLID, DRY, KISS, and YAGNI, developers can create code that is easier to understand, test, and evolve. The example demonstrates how the Single Responsibility Principle and Dependency Inversion Principle can significantly improve the structure and flexibility of a software system. Remember to always prioritize clarity and simplicity in your designs.

πŸ‘‰ Design well, code effectively! ✨

Top comments (0)