System Design (HLD)OCP Violations and Fixes

OCP Violations and Fixes

LevelIntermediate

Duration75 mins

TopicOCP Violations and Fixes

1 / 4

If-else Chains as OCP Violations

The Pattern That Predicts Technical Debt

Every experienced software engineer has encountered it: a seemingly innocent if-else chain that grows into a sprawling conditional monster. What begins as a simple two-branch decision evolves into dozens of conditions, each handling a different 'type' or 'variant' of behavior. Each new requirement adds another branch. Each bug fix touches the same monolithic method. Each developer fears making changes.

This pattern is so common that it deserves special attention. If-else chains that dispatch based on object type, category, or variant represent one of the most frequent and recognizable violations of the Open/Closed Principle. They are the canary in the coal mine—a signal that your design is fundamentally closed to extension and dangerously open to modification.

But what exactly makes these chains so problematic? Why do they violate OCP, and more importantly, how can we recognize them before they metastasize into unmaintainable code?

What You Will Learn

By the end of this page, you will understand the precise mechanics of how if-else chains violate OCP, develop pattern recognition skills to identify these violations in existing codebases, comprehend the long-term architectural costs of conditional complexity, and build the conceptual foundation for refactoring toward OCP-compliant designs.

Anatomy of a Conditional Chain

Before we can understand why if-else chains violate OCP, we must first examine their anatomy with surgical precision. Not all conditional logic is problematic—some conditions are perfectly appropriate and necessary. The distinction lies in what the condition is testing and why.

The Core Structure:

A typical OCP-violating if-else chain follows a recognizable pattern:

typical-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Classic if-else chain that violates OCP
class PaymentProcessor {
    processPayment(payment: Payment): PaymentResult {
        if (payment.type === 'credit_card') {
            // Credit card specific logic
            const cardDetails = payment.cardDetails;
            this.validateCardNumber(cardDetails.number);
            this.checkCardExpiry(cardDetails.expiry);
            return this.chargeCreditCard(cardDetails, payment.amount);
            
        } else if (payment.type === 'paypal') {
            // PayPal specific logic
            const paypalDetails = payment.paypalDetails;
            this.authenticatePayPal(paypalDetails.email);
            return this.chargePayPal(paypalDetails, payment.amount);
            
        } else if (payment.type === 'bank_transfer') {
            // Bank transfer specific logic
            const bankDetails = payment.bankDetails;
            this.validateRoutingNumber(bankDetails.routing);
            this.verifyAccountNumber(bankDetails.account);
            return this.initiateBankTransfer(bankDetails, payment.amount);
            
        } else if (payment.type === 'cryptocurrency') {
            // Crypto specific logic
            const cryptoDetails = payment.cryptoDetails;
            this.validateWalletAddress(cryptoDetails.wallet);
            return this.sendCryptoPayment(cryptoDetails, payment.amount);
            
        } else {
            throw new Error(`Unknown payment type: ${payment.type}`);
        }
    }
}

Identifying the Violation Pattern:

Notice the key characteristics that signal this is an OCP violation:

Type Discrimination: The condition checks a 'type' field, category, or identifier that determines which variant of behavior to execute.
Parallel Logic Blocks: Each branch contains self-contained logic appropriate for that specific variant—validation, processing, and response handling all bundled together.
Mutual Exclusivity: Only one branch executes per invocation, determined entirely by the type discriminator.
Growth Vector: New types or variants would require adding new branches to this exact method.

This structure creates a modification magnet—every new requirement that involves a new type must modify this method.

Not All Conditions Are Violations

Conditions that check business rules (e.g., 'if amount > 10000, require additional approval') or state transitions (e.g., 'if order.status === PENDING') are typically NOT OCP violations. The violation occurs specifically when conditions perform type-based dispatch—choosing different behavior based on what kind of thing something is.

Understanding the Violation Mechanics

To truly understand why if-else chains violate OCP, we need to examine the principle from both directions: what it means to be 'closed for modification' and what it means to be 'open for extension.'

The OCP Contract:

Recall that OCP states: Software entities should be open for extension but closed for modification. This means:

Closed for Modification: Once a module is tested and deployed, its source code should not need to change to accommodate new behaviors.
Open for Extension: New behaviors can be added by writing new code, not by changing existing code.

How If-Else Chains Break Both Halves:

Not Closed for Modification

•Adding a new payment type requires editing PaymentProcessor.processPayment()
•The method's tested, stable code must be reopened
•Existing branches risk accidental modification
•Merge conflicts arise when multiple developers add types
•Each change requires full regression testing

Not Open for Extension

•Cannot add new types without source code access
•Third parties cannot extend behavior
•Plugin/module architectures impossible
•Extension requires internal knowledge
•No seams for polymorphic behavior

The Modification Cascade:

What makes this particularly insidious is the cascade effect. If-else chains rarely appear in isolation. The same type discrimination that appears in processPayment() will inevitably appear elsewhere:

validatePayment() needs type-specific validation
refundPayment() has type-specific refund logic
getPaymentFees() calculates type-specific fees
formatPaymentReceipt() renders type-specific receipts

Each method develops its own parallel if-else chain. Adding a new payment type now requires modifications to every method that deals with payments. This is the shotgun surgery anti-pattern—a single conceptual change scattered across dozens of locations.

cascade-effect.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// The cascade effect: parallel if-else chains throughout the codebase
class PaymentService {
    processPayment(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // Must modify here for new types
    }
    
    validatePayment(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // AND here
    }
    
    refundPayment(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // AND here
    }
    
    calculateFees(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // AND here
    }
    
    // Every new payment type requires changes to ALL of these methods
}

The N×M Problem

If you have N payment types and M methods that handle payments, you have N×M pieces of type-specific logic scattered across your codebase. Adding one new type means modifying M methods. Adding one new operation means adding logic for N types. The complexity grows multiplicatively.

Recognition Patterns

Developing the ability to recognize OCP-violating conditionals is a crucial skill for any software engineer. These patterns often disguise themselves as 'necessary complexity' or 'straightforward logic.' Here are the telltale signs:

Primary Recognition Signals

•String-Based Type Fields: Conditions checking .type, .kind, .category, or .variant string properties
•Enum Type Switches: If-else chains that branch on enum values representing different behavioral variants
•Instanceof Cascades: Sequential instanceof checks testing for specific subclass types
•Class Name Checks: Conditions comparing getClass(), constructor.name, or similar type identifiers
•Discriminated Unions Without Exhaustive Handling: TypeScript discriminated unions with manually written switch logic
•Configuration-Driven Branching: Different behavior based on configuration keys that represent types
•Feature Flag Forests: Chains of feature flag checks that essentially implement type-based dispatch

The 'And If We Add Another' Test:

The most reliable way to identify an OCP violation is to ask: "What happens when we add another type/variant?"

If the answer involves:

Opening and modifying existing files
Adding branches to existing conditionals
Copying patterns from other branches
Potentially breaking existing, tested code

...then you've identified an OCP violation.

Structural Code Smells:

Beyond the conditional itself, look for these surrounding indicators:

Structural Indicators of OCP Violations
Indicator	What It Looks Like	Why It's Problematic
Parallel Conditionals	Same if-else chain repeated across multiple methods	Single type addition = multiple file changes
Type-Specific Fields	`creditCardNumber`, `paypalEmail`, `cryptoWallet` coexisting in one class	Object tries to be all types simultaneously
Null/Undefined Checks After Type	Using `?.` or null checks for type-specific properties	Wrong types have wrong properties, handled with nulls
Growth Comments	`// TODO: Add new payment types here`	Developers acknowledge the pattern will grow
Long Method Bodies	Hundreds of lines in a single conditional method	Each branch is essentially a separate algorithm
Copy-Paste Patterns	Similar structure repeated with type-specific changes	Abstraction opportunity missed

IDE Search Technique

Search your codebase for patterns like if.*\.type.*=== or switch.*\.type. These regex patterns will surface most type-discrimination conditionals. In TypeScript, searching for uses of discriminated union type fields can be particularly revealing.

Real-World Manifestations

Let's examine how if-else chain violations manifest across different domains. Understanding these real-world examples will sharpen your recognition skills and help you anticipate violations before they occur.

Example 1: Notification System

Almost every notification system begins with a simple if-else chain:

notification-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// OCP Violation: Notification dispatch via conditionals
class NotificationService {
    send(notification: Notification) {
        if (notification.channel === 'email') {
            const email = this.buildEmail(notification);
            this.smtpClient.send(email);
            this.logDelivery(notification, 'email');
            
        } else if (notification.channel === 'sms') {
            const sms = this.formatSMS(notification);
            this.twilioClient.sendSMS(sms);
            this.logDelivery(notification, 'sms');
            
        } else if (notification.channel === 'push') {
            const push = this.buildPushPayload(notification);
            this.firebaseClient.sendPush(push);
            this.logDelivery(notification, 'push');
            
        } else if (notification.channel === 'slack') {
            const slackMsg = this.formatSlackMessage(notification);
            this.slackWebhook.post(slackMsg);
            this.logDelivery(notification, 'slack');
            
        } else if (notification.channel === 'teams') {
            // Added 6 months later...
        } else if (notification.channel === 'discord') {
            // Added by another team...
        } else if (notification.channel === 'whatsapp') {
            // Added for international users...
        }
        // The chain keeps growing...
    }
}

Example 2: Document Rendering

Document processing systems are notorious for accumulating type-based conditionals:

document-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// OCP Violation: Document rendering by type
class DocumentRenderer {
    render(document: Document): Buffer {
        if (document.format === 'pdf') {
            const pdfLib = require('pdfkit');
            return this.renderPDF(document, pdfLib);
            
        } else if (document.format === 'docx') {
            const docx = require('docx');
            return this.renderDocx(document, docx);
            
        } else if (document.format === 'xlsx') {
            const xlsx = require('xlsx');
            return this.renderExcel(document, xlsx);
            
        } else if (document.format === 'html') {
            return this.renderHTML(document);
            
        } else if (document.format === 'markdown') {
            return this.renderMarkdown(document);
            
        } else if (document.format === 'csv') {
            return this.renderCSV(document);
        }
        
        throw new Error(`Unsupported format: ${document.format}`);
    }
    
    // Each of these also has the same pattern:
    preview(document: Document): string { /* same if-else chain */ }
    getMetadata(document: Document): Metadata { /* same if-else chain */ }
    validate(document: Document): ValidationResult { /* same if-else chain */ }
}

Example 3: API Request Handling

Backend services frequently develop conditional chains for handling different request types:

api-handling-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// OCP Violation: API version/feature handling
class APIRequestHandler {
    handle(request: APIRequest): Response {
        // Version-based branching
        if (request.apiVersion === 'v1') {
            return this.handleV1(request);
        } else if (request.apiVersion === 'v2') {
            return this.handleV2(request);
        } else if (request.apiVersion === 'v3') {
            return this.handleV3(request);
        }
        
        // Combined with feature-based branching within each
    }
    
    private handleV2(request: APIRequest): Response {
        // Further branching by resource type
        if (request.resource === 'users') {
            return this.handleV2Users(request);
        } else if (request.resource === 'orders') {
            return this.handleV2Orders(request);
        } else if (request.resource === 'products') {
            return this.handleV2Products(request);
        }
        // Nested conditionals compound the problem
    }
}

The Common Thread

Notice how every example shares the same structural flaw: behavioral variant dispatching through explicit conditionals. Whether it's notification channels, document formats, or API versions, the pattern remains identical—and so does the maintenance burden.

The Costs of Conditional Complexity

Understanding the theoretical OCP violation is important, but appreciating the practical costs is what drives real architectural change. Let's quantify the damage these patterns cause.

Engineering Costs of If-Else Chains

•Development Velocity Degradation: Each new type takes longer to add as the chain grows. What started as a 10-minute addition becomes a 2-hour investigation of existing branches, edge cases, and potential conflicts.
•Testing Complexity Explosion: Cyclomatic complexity grows linearly with branches. A 10-branch conditional requires testing 10 paths through that single method—plus interactions between conditions if they're nested.
•Merge Conflict Frequency: When multiple developers add types concurrently (common in larger teams), merge conflicts are guaranteed. The same file, same method, same region—every time.
•Regression Risk Accumulation: Modifying a 500-line conditional method to add type 11 risks breaking types 1-10. The 'safe' change becomes anything but.
•Knowledge Concentration: Only developers who understand all types can safely modify the method. New team members are excluded from contributing until they've internalized the entire chain.
•Code Review Burden: Reviewing changes to massive conditional methods is cognitively exhausting. Reviewers often miss issues in later branches due to fatigue.
•Debugging Complexity: When production issues occur, tracing through a giant conditional to find which branch failed—and why—adds significant incident response time.

Cost Comparison: If-Else Chains vs. Polymorphic Design
Metric	If-Else Chain (10 types)	Polymorphic Design (10 types)
Files modified to add type	5-15 (wherever chain exists)	1 (new type class only)
Lines changed to add type	50-200+ scattered lines	50-100 in new file
Risk of breaking existing types	High (shared method)	Near-zero (separate classes)
Parallel development possible	No (merge conflicts)	Yes (different files)
Third-party extension	Impossible without source	Trivial with interface
Unit testing per type	Complex mocking required	Simple isolated testing

The Hidden Cost: Architectural Rigidity

Perhaps the most significant cost is architectural lock-in. Once a codebase is littered with if-else chains, refactoring becomes exponentially difficult. Each chain must be addressed, each parallel chain discovered, and each dependent system updated. Teams often choose to 'live with' the problem rather than tackle the refactoring mountain—and the technical debt compounds year after year.

This is why recognizing and preventing if-else chain violations early is so critical. The cost of fixing them post-facto is orders of magnitude higher than designing correctly from the start.

The Boiling Frog Problem

If-else chains rarely start as 10-branch monsters. They begin as 2 branches—'just for now.' Then 3. Then 5. By the time someone notices the problem, refactoring feels too risky, too expensive. Watch for the second branch—that's when the pattern is being established.

When Conditionals Are Appropriate

It would be a mistake to conclude that all conditionals are harmful. The Open/Closed Principle doesn't prohibit if-else statements—it discourages using them for type-based behavioral dispatch. Many conditional patterns are perfectly appropriate and should not be refactored.

Legitimate Uses of Conditionals:

Appropriate Conditional Patterns

•Business Rule Enforcement: Checking if an order total exceeds a threshold for additional approval, or if a user's age meets minimum requirements—these are domain rules, not type dispatch.
•State-Based Logic: Handling different states in a state machine (if order.status === 'pending') is appropriate when states are finite and stable.
•Null/Error Handling: Guard clauses that check for null, undefined, or error conditions are essential defensive programming.
•Performance Optimization: Short-circuit evaluations or fast-path conditions (if (cache.has(key)) return cache.get(key)) are optimization patterns, not type discrimination.
•Configuration Flags: Simple boolean feature flags (if (featureFlags.isEnabled('darkMode'))) are appropriate when the flag space is stable and small.
•Edge Case Handling: Special-casing exceptional inputs (if (value === 0) return 0) in mathematical or algorithmic code.

The Distinguishing Question:

Ask yourself: "Is this condition selecting which algorithm/behavior to run based on what kind of thing this object is?"

If YES: This is likely an OCP violation. Consider polymorphism.
If NO: This is likely appropriate conditional logic.

The Stability Test:

Another useful heuristic: "How likely is it that a new branch will be added to this conditional?"

If the set of options is closed and stable (e.g., HTTP status code categories: success, redirect, client error, server error), conditionals may be fine.
If the set of options is open and growing (e.g., payment types, notification channels, document formats), polymorphism is strongly preferred.

This is why payment types should be polymorphic (new payment methods appear regularly) but HTTP status code handling can be conditional (new categories almost never appear).

appropriate-conditionals.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// APPROPRIATE: Business rule enforcement
function processOrder(order: Order): void {
    if (order.total > 10000) {
        requireManagerApproval(order);  // Business rule, not type dispatch
    }
    
    if (order.items.some(item => item.isHazardous)) {
        addHazmatDocumentation(order);  // Safety regulation
    }
    
    if (order.customer.isPremium) {
        applyPremiumDiscount(order);  // Customer benefit rule
    }
}
 
// APPROPRIATE: Guard clauses and error handling
function divideNumbers(a: number, b: number): number {
    if (b === 0) {
        throw new DivisionByZeroError();  // Guard clause
    }
    if (!Number.isFinite(a) || !Number.isFinite(b)) {
        throw new InvalidNumberError();  // Input validation
    }
    return a / b;
}
 
// APPROPRIATE: Stable, finite state transitions
function handleOrderState(order: Order): void {
    if (order.status === OrderStatus.PENDING) {
        // Finite state machine - states are closed and stable
    } else if (order.status === OrderStatus.PROCESSING) {
        // ...
    } else if (order.status === OrderStatus.SHIPPED) {
        // ...
    }
}

The Rule of Thumb

When in doubt, ask: 'If I add a new variant, do I need to touch this file?' If the answer is yes for type-based conditionals, it's an OCP violation. If the answer is no (because the conditional tests something orthogonal to types), it's probably fine.

Foundational Concepts for Resolution

Before we explore specific refactoring techniques in subsequent pages, let's establish the conceptual foundation for why polymorphism is the antidote to if-else chain violations.

The Core Insight: Replace Conditional with Polymorphism

The Gang of Four's seminal work on design patterns includes the principle: 'Replace Conditional with Polymorphism.' This principle recognizes that if-else chains based on type discrimination are often implementing polymorphism manually—and poorly.

Consider what an if-else chain actually does:

Receives an object with a type discriminator
Examines the discriminator
Routes to the appropriate algorithm/behavior
Executes that behavior

This is exactly what virtual dispatch (polymorphism) provides—automated by the language runtime, with type safety, extensibility, and separation of concerns built in.

If-Else Manual Dispatch

•Caller inspects type field
•Caller selects appropriate logic
•Caller executes that logic
•Adding types = modifying caller
•Type logic scattered across callers

Polymorphic Dispatch

•Caller invokes abstract method
•Runtime selects implementation
•Object executes its own logic
•Adding types = adding classes
•Type logic encapsulated in types

The Transformation Pattern:

The fundamental transformation from if-else to polymorphism follows this structure:

Extract Interface: Define an interface/abstract class with the method(s) that vary by type
Create Implementations: Each branch of the if-else becomes a class implementing the interface
Inject/Construct Polymorphically: Instead of passing a type discriminator, pass an instance of the appropriate implementation
Invoke Polymorphically: Call the interface method; the runtime dispatches to the correct implementation

This transformation is the subject of our later refactoring discussions, but understanding the concept is crucial: we're not just rearranging code—we're changing from explicit dispatch to implicit dispatch, moving responsibility from the caller to the objects themselves.

conceptual-transformation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// BEFORE: Explicit dispatch (if-else chain)
class PaymentProcessor {
    process(payment: Payment) {
        if (payment.type === 'credit_card') {
            // 50 lines of credit card logic
        } else if (payment.type === 'paypal') {
            // 40 lines of PayPal logic
        }
    }
}
 
// Usage: processor.process({ type: 'credit_card', ... });
 
// ------------------------------------------------------
 
// AFTER: Implicit dispatch (polymorphism)
interface PaymentMethod {
    process(amount: Money): PaymentResult;
}
 
class CreditCardPayment implements PaymentMethod {
    process(amount: Money): PaymentResult {
        // 50 lines of credit card logic, encapsulated
    }
}
 
class PayPalPayment implements PaymentMethod {
    process(amount: Money): PaymentResult {
        // 40 lines of PayPal logic, encapsulated
    }
}
 
// Usage: paymentMethod.process(amount);
// The caller never knows or cares what type it is

Key Insight

The goal is not to eliminate conditional logic—it's to move it to the construction phase (factory, dependency injection, configuration) rather than the execution phase. You still decide which type to use somewhere, but that decision happens once at object creation, not repeatedly throughout the codebase.

Summary and Looking Ahead

We've established a comprehensive understanding of how if-else chains violate the Open/Closed Principle. Let's consolidate the key insights:

Key Takeaways

•If-else chains that dispatch based on type/category violate OCP — They require modification to add new types and prevent extension without source access.
•The violation cascades — Type dispatch tends to appear in multiple locations, creating parallel chains throughout the codebase.
•Recognition is crucial — Look for type fields, enum branches, instanceof checks, and the 'add another type' modification pattern.
•Not all conditionals violate OCP — Business rules, state transitions, guard clauses, and stable finite option sets are appropriate uses.
•The costs are multiplicative — N types × M operations = N×M scattered pieces of type-specific logic.
•Polymorphism is the solution — Replace explicit dispatch with implicit dispatch through interfaces and implementations.
•Construction vs. Execution — Move type decisions from execution time to construction time.

What's Next:

In the next page, we'll examine another common OCP violation pattern: type checking with instanceof. While related to if-else chains, instanceof violations carry their own specific risks and recognition patterns. We'll explore how even in strongly-typed languages, runtime type checking often signals architectural flaws.

Page Complete

You now understand how if-else chains violate OCP, why they're architecturally costly, and the conceptual foundation for resolving them. Next, we'll examine instanceof type checking as an OCP anti-pattern.

1 / 4

Loading learning content...

If-else Chains as OCP Violations - OCP Violations and Fixes | OneNoughtOne

System Design (HLD)OCP Violations and Fixes

OCP Violations and Fixes

LevelIntermediate

Duration75 mins

TopicOCP Violations and Fixes

1 / 4

If-else Chains as OCP Violations

The Pattern That Predicts Technical Debt

But what exactly makes these chains so problematic? Why do they violate OCP, and more importantly, how can we recognize them before they metastasize into unmaintainable code?

What You Will Learn

Anatomy of a Conditional Chain

The Core Structure:

A typical OCP-violating if-else chain follows a recognizable pattern:

typical-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// Classic if-else chain that violates OCP
class PaymentProcessor {
    processPayment(payment: Payment): PaymentResult {
        if (payment.type === 'credit_card') {
            // Credit card specific logic
            const cardDetails = payment.cardDetails;
            this.validateCardNumber(cardDetails.number);
            this.checkCardExpiry(cardDetails.expiry);
            return this.chargeCreditCard(cardDetails, payment.amount);
            
        } else if (payment.type === 'paypal') {
            // PayPal specific logic
            const paypalDetails = payment.paypalDetails;
            this.authenticatePayPal(paypalDetails.email);
            return this.chargePayPal(paypalDetails, payment.amount);
            
        } else if (payment.type === 'bank_transfer') {
            // Bank transfer specific logic
            const bankDetails = payment.bankDetails;
            this.validateRoutingNumber(bankDetails.routing);
            this.verifyAccountNumber(bankDetails.account);
            return this.initiateBankTransfer(bankDetails, payment.amount);
            
        } else if (payment.type === 'cryptocurrency') {
            // Crypto specific logic
            const cryptoDetails = payment.cryptoDetails;
            this.validateWalletAddress(cryptoDetails.wallet);
            return this.sendCryptoPayment(cryptoDetails, payment.amount);
            
        } else {
            throw new Error(`Unknown payment type: ${payment.type}`);
        }
    }
}

Identifying the Violation Pattern:

Notice the key characteristics that signal this is an OCP violation:

Type Discrimination: The condition checks a 'type' field, category, or identifier that determines which variant of behavior to execute.
Parallel Logic Blocks: Each branch contains self-contained logic appropriate for that specific variant—validation, processing, and response handling all bundled together.
Mutual Exclusivity: Only one branch executes per invocation, determined entirely by the type discriminator.
Growth Vector: New types or variants would require adding new branches to this exact method.

This structure creates a modification magnet—every new requirement that involves a new type must modify this method.

Not All Conditions Are Violations

Understanding the Violation Mechanics

To truly understand why if-else chains violate OCP, we need to examine the principle from both directions: what it means to be 'closed for modification' and what it means to be 'open for extension.'

The OCP Contract:

Recall that OCP states: Software entities should be open for extension but closed for modification. This means:

Closed for Modification: Once a module is tested and deployed, its source code should not need to change to accommodate new behaviors.
Open for Extension: New behaviors can be added by writing new code, not by changing existing code.

How If-Else Chains Break Both Halves:

Not Closed for Modification

•Adding a new payment type requires editing PaymentProcessor.processPayment()
•The method's tested, stable code must be reopened
•Existing branches risk accidental modification
•Merge conflicts arise when multiple developers add types
•Each change requires full regression testing

Not Open for Extension

•Cannot add new types without source code access
•Third parties cannot extend behavior
•Plugin/module architectures impossible
•Extension requires internal knowledge
•No seams for polymorphic behavior

The Modification Cascade:

validatePayment() needs type-specific validation
refundPayment() has type-specific refund logic
getPaymentFees() calculates type-specific fees
formatPaymentReceipt() renders type-specific receipts

cascade-effect.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// The cascade effect: parallel if-else chains throughout the codebase
class PaymentService {
    processPayment(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // Must modify here for new types
    }
    
    validatePayment(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // AND here
    }
    
    refundPayment(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // AND here
    }
    
    calculateFees(payment: Payment) {
        if (payment.type === 'credit_card') { /* ... */ }
        else if (payment.type === 'paypal') { /* ... */ }
        else if (payment.type === 'bank_transfer') { /* ... */ }
        // AND here
    }
    
    // Every new payment type requires changes to ALL of these methods
}

The N×M Problem

Recognition Patterns

Primary Recognition Signals

•String-Based Type Fields: Conditions checking .type, .kind, .category, or .variant string properties
•Enum Type Switches: If-else chains that branch on enum values representing different behavioral variants
•Instanceof Cascades: Sequential instanceof checks testing for specific subclass types
•Class Name Checks: Conditions comparing getClass(), constructor.name, or similar type identifiers
•Discriminated Unions Without Exhaustive Handling: TypeScript discriminated unions with manually written switch logic
•Configuration-Driven Branching: Different behavior based on configuration keys that represent types
•Feature Flag Forests: Chains of feature flag checks that essentially implement type-based dispatch

The 'And If We Add Another' Test:

The most reliable way to identify an OCP violation is to ask: "What happens when we add another type/variant?"

If the answer involves:

Opening and modifying existing files
Adding branches to existing conditionals
Copying patterns from other branches
Potentially breaking existing, tested code

...then you've identified an OCP violation.

Structural Code Smells:

Beyond the conditional itself, look for these surrounding indicators:

Structural Indicators of OCP Violations
Indicator	What It Looks Like	Why It's Problematic
Parallel Conditionals	Same if-else chain repeated across multiple methods	Single type addition = multiple file changes
Type-Specific Fields	`creditCardNumber`, `paypalEmail`, `cryptoWallet` coexisting in one class	Object tries to be all types simultaneously
Null/Undefined Checks After Type	Using `?.` or null checks for type-specific properties	Wrong types have wrong properties, handled with nulls
Growth Comments	`// TODO: Add new payment types here`	Developers acknowledge the pattern will grow
Long Method Bodies	Hundreds of lines in a single conditional method	Each branch is essentially a separate algorithm
Copy-Paste Patterns	Similar structure repeated with type-specific changes	Abstraction opportunity missed

IDE Search Technique

Real-World Manifestations

Example 1: Notification System

Almost every notification system begins with a simple if-else chain:

notification-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// OCP Violation: Notification dispatch via conditionals
class NotificationService {
    send(notification: Notification) {
        if (notification.channel === 'email') {
            const email = this.buildEmail(notification);
            this.smtpClient.send(email);
            this.logDelivery(notification, 'email');
            
        } else if (notification.channel === 'sms') {
            const sms = this.formatSMS(notification);
            this.twilioClient.sendSMS(sms);
            this.logDelivery(notification, 'sms');
            
        } else if (notification.channel === 'push') {
            const push = this.buildPushPayload(notification);
            this.firebaseClient.sendPush(push);
            this.logDelivery(notification, 'push');
            
        } else if (notification.channel === 'slack') {
            const slackMsg = this.formatSlackMessage(notification);
            this.slackWebhook.post(slackMsg);
            this.logDelivery(notification, 'slack');
            
        } else if (notification.channel === 'teams') {
            // Added 6 months later...
        } else if (notification.channel === 'discord') {
            // Added by another team...
        } else if (notification.channel === 'whatsapp') {
            // Added for international users...
        }
        // The chain keeps growing...
    }
}

Example 2: Document Rendering

Document processing systems are notorious for accumulating type-based conditionals:

document-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
// OCP Violation: Document rendering by type
class DocumentRenderer {
    render(document: Document): Buffer {
        if (document.format === 'pdf') {
            const pdfLib = require('pdfkit');
            return this.renderPDF(document, pdfLib);
            
        } else if (document.format === 'docx') {
            const docx = require('docx');
            return this.renderDocx(document, docx);
            
        } else if (document.format === 'xlsx') {
            const xlsx = require('xlsx');
            return this.renderExcel(document, xlsx);
            
        } else if (document.format === 'html') {
            return this.renderHTML(document);
            
        } else if (document.format === 'markdown') {
            return this.renderMarkdown(document);
            
        } else if (document.format === 'csv') {
            return this.renderCSV(document);
        }
        
        throw new Error(`Unsupported format: ${document.format}`);
    }
    
    // Each of these also has the same pattern:
    preview(document: Document): string { /* same if-else chain */ }
    getMetadata(document: Document): Metadata { /* same if-else chain */ }
    validate(document: Document): ValidationResult { /* same if-else chain */ }
}

Example 3: API Request Handling

Backend services frequently develop conditional chains for handling different request types:

api-handling-violation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
// OCP Violation: API version/feature handling
class APIRequestHandler {
    handle(request: APIRequest): Response {
        // Version-based branching
        if (request.apiVersion === 'v1') {
            return this.handleV1(request);
        } else if (request.apiVersion === 'v2') {
            return this.handleV2(request);
        } else if (request.apiVersion === 'v3') {
            return this.handleV3(request);
        }
        
        // Combined with feature-based branching within each
    }
    
    private handleV2(request: APIRequest): Response {
        // Further branching by resource type
        if (request.resource === 'users') {
            return this.handleV2Users(request);
        } else if (request.resource === 'orders') {
            return this.handleV2Orders(request);
        } else if (request.resource === 'products') {
            return this.handleV2Products(request);
        }
        // Nested conditionals compound the problem
    }
}

The Common Thread

The Costs of Conditional Complexity

Understanding the theoretical OCP violation is important, but appreciating the practical costs is what drives real architectural change. Let's quantify the damage these patterns cause.

Engineering Costs of If-Else Chains

•Development Velocity Degradation: Each new type takes longer to add as the chain grows. What started as a 10-minute addition becomes a 2-hour investigation of existing branches, edge cases, and potential conflicts.
•Testing Complexity Explosion: Cyclomatic complexity grows linearly with branches. A 10-branch conditional requires testing 10 paths through that single method—plus interactions between conditions if they're nested.
•Merge Conflict Frequency: When multiple developers add types concurrently (common in larger teams), merge conflicts are guaranteed. The same file, same method, same region—every time.
•Regression Risk Accumulation: Modifying a 500-line conditional method to add type 11 risks breaking types 1-10. The 'safe' change becomes anything but.
•Knowledge Concentration: Only developers who understand all types can safely modify the method. New team members are excluded from contributing until they've internalized the entire chain.
•Code Review Burden: Reviewing changes to massive conditional methods is cognitively exhausting. Reviewers often miss issues in later branches due to fatigue.
•Debugging Complexity: When production issues occur, tracing through a giant conditional to find which branch failed—and why—adds significant incident response time.

Cost Comparison: If-Else Chains vs. Polymorphic Design
Metric	If-Else Chain (10 types)	Polymorphic Design (10 types)
Files modified to add type	5-15 (wherever chain exists)	1 (new type class only)
Lines changed to add type	50-200+ scattered lines	50-100 in new file
Risk of breaking existing types	High (shared method)	Near-zero (separate classes)
Parallel development possible	No (merge conflicts)	Yes (different files)
Third-party extension	Impossible without source	Trivial with interface
Unit testing per type	Complex mocking required	Simple isolated testing

The Hidden Cost: Architectural Rigidity

This is why recognizing and preventing if-else chain violations early is so critical. The cost of fixing them post-facto is orders of magnitude higher than designing correctly from the start.

The Boiling Frog Problem

When Conditionals Are Appropriate

Legitimate Uses of Conditionals:

Appropriate Conditional Patterns

•Business Rule Enforcement: Checking if an order total exceeds a threshold for additional approval, or if a user's age meets minimum requirements—these are domain rules, not type dispatch.
•State-Based Logic: Handling different states in a state machine (if order.status === 'pending') is appropriate when states are finite and stable.
•Null/Error Handling: Guard clauses that check for null, undefined, or error conditions are essential defensive programming.
•Performance Optimization: Short-circuit evaluations or fast-path conditions (if (cache.has(key)) return cache.get(key)) are optimization patterns, not type discrimination.
•Configuration Flags: Simple boolean feature flags (if (featureFlags.isEnabled('darkMode'))) are appropriate when the flag space is stable and small.
•Edge Case Handling: Special-casing exceptional inputs (if (value === 0) return 0) in mathematical or algorithmic code.

The Distinguishing Question:

Ask yourself: "Is this condition selecting which algorithm/behavior to run based on what kind of thing this object is?"

If YES: This is likely an OCP violation. Consider polymorphism.
If NO: This is likely appropriate conditional logic.

The Stability Test:

Another useful heuristic: "How likely is it that a new branch will be added to this conditional?"

If the set of options is closed and stable (e.g., HTTP status code categories: success, redirect, client error, server error), conditionals may be fine.
If the set of options is open and growing (e.g., payment types, notification channels, document formats), polymorphism is strongly preferred.

This is why payment types should be polymorphic (new payment methods appear regularly) but HTTP status code handling can be conditional (new categories almost never appear).

appropriate-conditionals.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// APPROPRIATE: Business rule enforcement
function processOrder(order: Order): void {
    if (order.total > 10000) {
        requireManagerApproval(order);  // Business rule, not type dispatch
    }
    
    if (order.items.some(item => item.isHazardous)) {
        addHazmatDocumentation(order);  // Safety regulation
    }
    
    if (order.customer.isPremium) {
        applyPremiumDiscount(order);  // Customer benefit rule
    }
}
 
// APPROPRIATE: Guard clauses and error handling
function divideNumbers(a: number, b: number): number {
    if (b === 0) {
        throw new DivisionByZeroError();  // Guard clause
    }
    if (!Number.isFinite(a) || !Number.isFinite(b)) {
        throw new InvalidNumberError();  // Input validation
    }
    return a / b;
}
 
// APPROPRIATE: Stable, finite state transitions
function handleOrderState(order: Order): void {
    if (order.status === OrderStatus.PENDING) {
        // Finite state machine - states are closed and stable
    } else if (order.status === OrderStatus.PROCESSING) {
        // ...
    } else if (order.status === OrderStatus.SHIPPED) {
        // ...
    }
}

The Rule of Thumb

Foundational Concepts for Resolution

Before we explore specific refactoring techniques in subsequent pages, let's establish the conceptual foundation for why polymorphism is the antidote to if-else chain violations.

The Core Insight: Replace Conditional with Polymorphism

Consider what an if-else chain actually does:

Receives an object with a type discriminator
Examines the discriminator
Routes to the appropriate algorithm/behavior
Executes that behavior

This is exactly what virtual dispatch (polymorphism) provides—automated by the language runtime, with type safety, extensibility, and separation of concerns built in.

If-Else Manual Dispatch

•Caller inspects type field
•Caller selects appropriate logic
•Caller executes that logic
•Adding types = modifying caller
•Type logic scattered across callers

Polymorphic Dispatch

•Caller invokes abstract method
•Runtime selects implementation
•Object executes its own logic
•Adding types = adding classes
•Type logic encapsulated in types

The Transformation Pattern:

The fundamental transformation from if-else to polymorphism follows this structure:

Extract Interface: Define an interface/abstract class with the method(s) that vary by type
Create Implementations: Each branch of the if-else becomes a class implementing the interface
Inject/Construct Polymorphically: Instead of passing a type discriminator, pass an instance of the appropriate implementation
Invoke Polymorphically: Call the interface method; the runtime dispatches to the correct implementation

conceptual-transformation.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
// BEFORE: Explicit dispatch (if-else chain)
class PaymentProcessor {
    process(payment: Payment) {
        if (payment.type === 'credit_card') {
            // 50 lines of credit card logic
        } else if (payment.type === 'paypal') {
            // 40 lines of PayPal logic
        }
    }
}
 
// Usage: processor.process({ type: 'credit_card', ... });
 
// ------------------------------------------------------
 
// AFTER: Implicit dispatch (polymorphism)
interface PaymentMethod {
    process(amount: Money): PaymentResult;
}
 
class CreditCardPayment implements PaymentMethod {
    process(amount: Money): PaymentResult {
        // 50 lines of credit card logic, encapsulated
    }
}
 
class PayPalPayment implements PaymentMethod {
    process(amount: Money): PaymentResult {
        // 40 lines of PayPal logic, encapsulated
    }
}
 
// Usage: paymentMethod.process(amount);
// The caller never knows or cares what type it is

Key Insight

Summary and Looking Ahead

We've established a comprehensive understanding of how if-else chains violate the Open/Closed Principle. Let's consolidate the key insights:

Key Takeaways

•If-else chains that dispatch based on type/category violate OCP — They require modification to add new types and prevent extension without source access.
•The violation cascades — Type dispatch tends to appear in multiple locations, creating parallel chains throughout the codebase.
•Recognition is crucial — Look for type fields, enum branches, instanceof checks, and the 'add another type' modification pattern.
•Not all conditionals violate OCP — Business rules, state transitions, guard clauses, and stable finite option sets are appropriate uses.
•The costs are multiplicative — N types × M operations = N×M scattered pieces of type-specific logic.
•Polymorphism is the solution — Replace explicit dispatch with implicit dispatch through interfaces and implementations.
•Construction vs. Execution — Move type decisions from execution time to construction time.

What's Next:

Page Complete

1 / 4