Integration Testing — Complete Guide

Introduction

Integration Testing — Complete Guide is essential for .NET developers building ShopNest Enterprise Clean Architecture Platform — Toolliyo's 100-article SOLID Design Principles master path covering SRP, OCP, LSP, ISP, DIP, refactoring, Clean Architecture, and enterprise projects. Every article includes minimum 2 detailed enterprise real-world examples with bad code before good code (banking, e-commerce, ERP, SaaS, healthcare).

In Indian delivery projects (TCS, Infosys, Wipro), interviewers expect integration testing with real HDFC-style banking SRP fixes, Flipkart OCP payment strategies, TCS ERP LSP, Freshworks ISP, or Apollo hospital refactoring examples — not toy animal demos. This article delivers two mandatory enterprise examples on Notifications.

After this article you will

• Explain Integration Testing in plain English and in SOLID principles and maintainable OOP terms
• Implement integration testing in ShopNest Enterprise Clean Architecture Platform (Notifications)
• Compare the wrong approach vs the production-ready enterprise approach
• Answer fresher, mid-level, and senior SOLID principles and clean architecture interview questions confidently
• Connect this lesson to Article 85 and the 100-article SOLID Principles roadmap

Prerequisites

• Software: .NET 8 SDK, VS 2022 or VS Code, SQL Server Express / LocalDB
• Knowledge: C# basics
• Previous: Article 83 — xUnit and Moq — Complete Guide
• Time: 28 min reading + 30–45 min hands-on

Concept deep-dive

Level 1 — Analogy

Integration Testing on ShopNest Clean Architecture teaches maintainable enterprise design using Uncle Bob SOLID principles.

Level 2 — Technical

Integration Testing integrates with the LINQ query layer: write queries against IEnumerable or IQueryable, understand deferred execution, project to DTOs for ShopNest Clean Architecture reports. On ShopNest Clean Architecture this powers Notifications without coupling UI to database internals.

Level 3 — Architecture

[Browser] → [HTTPS/Kestrel] → [Middleware Pipeline]
  → [Routing] → [Controller Action] → [Service Layer]
  → [EF Core / Identity] → [Razor View Engine] → [HTML Response]

Project structure

ShopNest Clean Architecture/
├── ShopNest Clean Architecture/
├── src/
│   ├── ShopNest Clean Architecture.Api/       ← ASP.NET Core Web API
│   ├── ShopNest Clean Architecture.Core/      ← Repository interfaces
│   ├── ShopNest Clean Architecture.AdoNet/    ← SqlConnection, SPs, transactions
│   ├── ShopNest Clean Architecture.Reports/   ← Streaming readers, GL reports
│   └── ShopNest Clean Architecture.Tests/     ← Integration tests (Testcontainers SQL)
├── sql/
│   ├── migrations/
│   └── stored-procedures/
└── docker-compose.yml                 ← SQL Server 2022 + Redis

Step-by-Step Implementation — ShopNest (Notifications)

Follow the prompt template: create project → core classes → interfaces → pattern implementation → client code → run → enterprise refactor.

Step 1 — The wrong way

// ❌ BAD — god class violates SRP, tight coupling, untestable
public class OrderService {
    public void PlaceOrder(Order o) {
        Validate(o);
        _context.Orders.Add(o);
        _context.SaveChanges();
        SendEmail(o.CustomerEmail);
        GenerateInvoicePdf(o);
    }
}

Step 2 — The right way

// ✅ CORRECT — Integration Testing on ShopNest (Notifications) — SOLID applied
public sealed class PlaceOrderHandler(IOrderRepository repo, INotificationService notify)
    : IRequestHandler
{
    public async Task Handle(PlaceOrderCommand cmd, CancellationToken ct) {
        var order = Order.Create(cmd.CustomerId, cmd.Items);
        await repo.AddAsync(order, ct);
        await notify.OrderPlacedAsync(order, ct);
        return Result.Success(order.Id);
    }
}

Step 3 — Apply Integration Testing

// Integration Testing — ShopNest Clean Architecture (Notifications)
builder.Services.AddScoped<IIntegrationTestingService, IntegrationTestingService>();

dotnet run --project ShopNest Clean Architecture.Api
# Verify Integration Testing — check Swagger UI and unit test pass rate and integration tests pass

The problem before SOLID

Without SOLID, ShopNest teams hit: tight coupling, god classes, untestable controllers, merge conflicts, and fear of refactoring. Indian IT projects (TCS, Infosys, Wipro) lose sprints when legacy code has no clear boundaries.

• Tight coupling — change SMS provider, break ledger posting
• Testing difficulty — cannot mock database from controller
• Scalability — monolith teams block each other
• Bug-prone — one class, five reasons to change

Real-World Example 1 — HDFC Core Banking — Transfer Service SRP Violation Fix

MANDATORY enterprise scenario (Indian Banking): Integration Testing applied in ShopNest Clean Architecture Notifications.

Business problem

A 2,400-line TransferService handled validation, ledger posting, SMS, fraud checks, and PDF receipts. One change to SMS template broke fund transfers in production. SRP split into ITransferValidator, ILedgerService, IFraudChecker, INotificationService.

Before SOLID — bad design

// ❌ GOD CLASS — violates SRP
public class TransferService {
    public void Transfer(Account from, Account to, decimal amount) {
        ValidateAccounts(from, to);
        CheckFraud(from, amount);
        UpdateLedger(from, to, amount);
        SendSms(from.CustomerPhone, "Transfer done");
        GeneratePdfReceipt(from, to, amount);
    }
}

After SOLID — production design

// ✅ SRP — each class one reason to change
public sealed class TransferOrchestrator {
    private readonly ITransferValidator _validator;
    private readonly ILedgerService _ledger;
    private readonly IFraudChecker _fraud;
    private readonly INotificationService _notify;

    public async Task<Result> ExecuteAsync(TransferRequest req, CancellationToken ct) {
        await _validator.ValidateAsync(req, ct);
        await _fraud.CheckAsync(req, ct);
        await _ledger.PostAsync(req, ct);
        await _notify.SendTransferConfirmationAsync(req, ct);
        return Result.Success();
    }
}

Outcome

Deployment frequency for transfer module increased 4x; unit test count from 12 to 89 isolated tests.

Real-World Example 2 — Flipkart Checkout — OCP with Payment Strategies

MANDATORY enterprise scenario (E-Commerce): Integration Testing applied in ShopNest Clean Architecture Notifications.

Business problem

Checkout had if/else for UPI, card, COD, wallet — every new payment method required editing CheckoutService. OCP: IPaymentStrategy + new strategy class per method; open for extension, closed for modification.

Before SOLID — bad design

public void Pay(Order order, string method) {
    if (method == "UPI") { /* 50 lines */ }
    else if (method == "CARD") { /* 60 lines */ }
    else if (method == "COD") { /* 40 lines */ }
}

After SOLID — production design

public interface IPaymentStrategy {
    Task<PaymentResult> PayAsync(Order order, CancellationToken ct);
}
public class UpiPaymentStrategy : IPaymentStrategy { /* ... */ }
public class CheckoutService(IPaymentStrategyFactory factory) {
    public Task PayAsync(Order o, PaymentMethod m, CancellationToken ct) =>
        factory.Get(m).PayAsync(o, ct);
}

Outcome

BNPL and EMI added in 2 sprints without touching CheckoutService core — zero regression on existing methods.

SOLID in ASP.NET Core — Integration Testing

Register abstractions in Program.cs as Scoped. Keep controllers thin — delegate to MediatR handlers or application services. ShopNest Clean Architecture: Domain → Application → Infrastructure → Api.

builder.Services.AddScoped<IOrderService, OrderService>();
builder.Services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(PlaceOrderHandler).Assembly));

SOLID and design patterns

SRP enables focused classes; OCP pairs with Strategy and Factory; LSP guards inheritance; ISP splits fat interfaces; DIP powers DI and Repository pattern. SOLID is the foundation — patterns are the tools.

Unit testing with SOLID

var mock = new Mock<IOrderRepository>();
mock.Setup(r => r.GetAsync(1, default)).ReturnsAsync(new Order(1, 100m));
var handler = new GetOrderHandler(mock.Object);
var result = await handler.Handle(new GetOrderQuery(1), default);
Assert.Equal(100m, result.Total);

Common errors & fixes

🔴 Mistake 1: God classes with 10+ responsibilities (SRP violation)
✅ Fix: Extract focused services — one reason to change per class.

🔴 Mistake 2: Adding if/else chains for every new feature (OCP violation)
✅ Fix: Use Strategy or Factory; extend via new classes, not edits.

🔴 Mistake 3: Subclass throws NotImplementedException (LSP violation)
✅ Fix: Prefer composition and role-specific interfaces over broken inheritance.

🔴 Mistake 4: Controllers new-ing concrete repositories (DIP violation)
✅ Fix: Inject interfaces via constructor DI in ASP.NET Core.

Best practices

• 🟢 Use async/await end-to-end for database and I/O calls
• 🟢 Register DbContext as Scoped; avoid capturing it in singletons
• 🟡 Use IQueryable until the last moment; avoid multiple enumeration; project with Select before ToList
• 🟡 Prefer method syntax for complex chains; use query syntax for joins when readability wins
• 🔴 Log structured data with Serilog — include OrderId, UserId, not passwords
• 🔴 Use HTTPS, secure cookies, and authorization policies in production

Interview questions

Fresher level

Q1: What is Integration Testing in ASP.NET Core MVC?
A: Integration Testing is a core MVC capability used in ShopNest Clean Architecture for Notifications. Explain in one sentence, then describe controller/view/service placement.

Q2: How would you implement Integration Testing on a TCS-style delivery project?
A: Deferred execution, IQueryable pipelines, Select projection, Skip/Take pagination, and SQL logging in development.

Q3: IEnumerable vs IQueryable — when to use which?
A: IEnumerable for in-memory collections; IQueryable for EF Core database queries that translate to SQL.

Mid / senior level

Q4: Explain LINQ deferred execution and query translation briefly.
A: LINQ → Expression Tree → IQueryProvider → SQL (EF) or Iterator (in-memory) → Results.

Q5: Common production mistake with this topic?
A: Skipping validation, exposing secrets in Git, or untested edge cases (null model, unauthorized user).

Q6: .NET LINQ vs SQL — when to push logic to database?
A: Core is cross-platform, faster, cloud-ready; Framework is maintenance mode on Windows/IIS.

Coding round

Implement Integration Testing for ShopNest Notifications: show interface, concrete class, DI registration, and xUnit test with mock.

public class IntegrationTestingPatternTests
{
    [Fact]
    public async Task ExecuteAsync_ReturnsSuccess()
    {
        var mock = new Mock();
        mock.Setup(s => s.ExecuteAsync(It.IsAny(), default))
            .ReturnsAsync(Result.Success("test-id"));
        var result = await mock.Object.ExecuteAsync(new Request("test-id"));
        Assert.True(result.IsSuccess);
    }
}

Summary & next steps

• Article 84: Integration Testing — Complete Guide
• Module: Module 9: Testing and Maintainability · Level: ADVANCED
• Applied to ShopNest Clean Architecture — Notifications

Previous: xUnit and Moq — Complete Guide
Next: Testable Architecture — Complete Guide

Practice: Add one small feature using today's pattern — commit with feat(solid): article-84.

FAQ