Odwrócenie zależności w .NET. Jak wyznaczyć dobrą granicę?

Radosław Krajewski • 18 listopada 2026
Mężczyzna pracuje przy laptopie, stosując zasadę odwrócenia zależności. Obok stoi doniczka z rośliną i filiżanka kawy.

Spis treści

Testy usługi zamówień wywracają się, bo przy każdym wywołaniu kod tworzy nowy kontekst Entity Framework albo sięga po statyczny klient płatności. Zasada odwrócenia zależności podpowiada, by logika zamówień znała potrzebną operację, a nie konkretny sposób jej wykonania, choć sama obecność interfejsu jeszcze tego nie gwarantuje.

Diagram zależności projektów SpaceDotNet. Pokazuje, jak moduły zależą od siebie, ilustrując zasadę odwrócenia zależności (dependency inversion).

Logika aplikacji powinna wskazywać na abstrakcje, a szczegóły mają się do nich dopasować

  • DIP zmienia kierunek zależności w kodzie źródłowym, nie kolejność wywołań w czasie działania.
  • Interfejs powinien należeć do kodu, który określa potrzebę, na przykład warstwy aplikacyjnej.
  • DI dostarcza implementację; kontener DI jest jednym ze sposobów jej składania.
  • Nie każda klasa potrzebuje interfejsu. Abstrakcja przydaje się tam, gdzie chroni logikę przed zmiennym szczegółem.

Odwróć zależność kodu, nie przebieg działania programu

Wyobraź sobie usługę, która zatwierdza zamówienie i zapisuje je przez SqlOrderRepository. Gdy usługa odwołuje się bezpośrednio do tej klasy, zmiana sposobu zapisu przenika do kodu biznesowego; przy DIP oba elementy zależą od abstrakcji opisującej zapis zamówienia.

W praktyce kontrakt definiuje warstwa, która potrzebuje operacji, a warstwa techniczna go implementuje. Zależność kompilacyjna biegnie wtedy od infrastruktury ku abstrakcji, choć podczas działania usługa nadal wywołuje repozytorium i zapisuje dane. Ten rozdźwięk między kierunkiem zależności a przepływem wywołań bywa źródłem nieporozumień.

public interface IOrderRepository
{
    Task SaveAsync(Order order, CancellationToken ct);
}

public sealed class PlaceOrder
{
    private readonly IOrderRepository _orders;

    public PlaceOrder(IOrderRepository orders) => _orders = orders;

    public Task Handle(Order order, CancellationToken ct) =>
        _orders.SaveAsync(order, ct);
}

public sealed class SqlOrderRepository : IOrderRepository
{
    public Task SaveAsync(Order order, CancellationToken ct)
    {
        // Zapis przez wybraną technologię bazodanową
        return Task.CompletedTask;
    }
}

Sam interfejs nie wystarczy, jeśli projekt z logiką nadal musi referować projekt infrastruktury, żeby go załadować. W artykule o architekturze .NET Microsoft Learn opisuje układ, w którym interfejsy operacji infrastrukturalnych znajdują się w Application Core, a ich implementacje w Infrastructure. To położenie kontraktu decyduje, w którą stronę skierowane są zależności projektów.

Interfejs należy do kodu, który zgłasza potrzebę

Repozytorium może należeć do infrastruktury, ale opis tego, czego wymaga przypadek użycia, powinien być blisko samego przypadku użycia. W przeciwnym razie abstrakcja staje się tylko cienką kopią klasy technicznej, a zmiana potrzeby biznesowej wymaga uzgadniania jej z warstwą, która miała pozostać szczegółem.

W aplikacji .NET warstwa Application Core może zawierać IOrderRepository, a projekt Infrastructure dostarcza SqlOrderRepository z użyciem EF Core i DbContext. W Program.cs rejestrujesz mapowanie implementacji na interfejs przez IServiceCollection. Microsoft Learn opisuje również composition root, czyli miejsce składania aplikacji, w którym konkretne typy łączy się z kontraktami.

Granica przebiega więc przez właściciela kontraktu, nie przez nazwę folderu. Jeśli Application Core importuje typy EF Core, sama deklaracja interfejsu nie odizolowała logiki od infrastruktury.

DIP, DI i IoC odpowiadają na różne pytania

Podobne skróty łatwo zlać w jedno, bo często występują obok siebie. Prawdę mówiąc, zamieszanie znika, gdy rozdzieli się projekt zależności od sposobu dostarczenia obiektu.

PojęcieNa jakie pytanie odpowiadaPrzykład w .NET
DIP, odwrócenie zależnościOd czego powinien zależeć kod?PlaceOrder zależy od IOrderRepository.
DI, wstrzykiwanie zależnościJak obiekt otrzymuje współpracownika?Konstruktor PlaceOrder przyjmuje repozytorium.
Kontener DIKto tworzy i łączy obiekty?Rejestracja interfejsu i implementacji w IServiceCollection.
IoC, odwrócenie sterowaniaKto kontroluje wybrany fragment tworzenia lub przepływu?Host .NET składa zarejestrowane usługi.

Dependency injection jest popularnym sposobem realizacji DIP, ale te pojęcia nie są synonimami. Możesz przekazać zależność ręcznie w kodzie, bez kontenera, a nadal sprawić, że wyższy moduł nie zna klasy infrastrukturalnej. Różnicę tę podkreśla też artykuł Roberta C. Martina The Dependency Inversion Principle: sednem jest układ zależności wobec abstrakcji.

Dodaj abstrakcję przy zmiennym szczególe, nie przy każdej klasie

Jeśli każda klasa dostaje własny interfejs, rozwiązanie szybko rozrasta się w pliki bez rzeczywistej granicy. Z drugiej strony klasa, która tworzy własny klient zewnętrznej usługi, utrudnia testowanie i wymianę tej usługi. Rozstrzygaj na podstawie kosztu sprzężenia, nie liczby klas w projekcie.

SytuacjaPrawdopodobny skutekCo zrobić
Przypadek użycia wywołuje new SqlOrderRepository().Logika zna technologię zapisu i trudno zastąpić ją w teście.Wprowadź kontrakt po stronie przypadku użycia i przekaż implementację z zewnątrz.
Klasa wywołuje statyczny klient płatności z efektem sieciowym.Test wymaga prawdziwej integracji albo trudnego obejścia globalnego stanu.Owiń operację płatności kontraktem, który opisuje potrzebę aplikacji.
Klasa formatująca lokalny tekst zależy od stabilnej biblioteki.Interfejs może dodać pliki i konfigurację bez odizolowania zmiennego elementu.Pozostaw bezpośrednią zależność, jeśli nie ma sensownego wariantu do podmiany.
Do konstruktora trafia wiele niezależnych usług.Klasa może łączyć zbyt wiele odpowiedzialności.Sprawdź, czy przypadek użycia da się podzielić według osobnych zadań.

Moja reguła jest prosta: twórz abstrakcję, gdy chroni stabilną logikę przed zmiennym albo zewnętrznym szczegółem. Jeśli interfejs jedynie powtarza publiczne metody jednej klasy, a jej podmiana nie jest realnym scenariuszem, na początek zostawiłbym konkretny typ.

Najpierw sprawdź granicę, potem wybieraj wzorzec

Gdy test wymaga bazy danych tylko po to, by sprawdzić regułę biznesową, zależność prawdopodobnie przekracza właściwą granicę. Gdy test dotyczy mapowania EF Core albo zapytania SQL, integracja z bazą może być dokładnie tym, co trzeba sprawdzić.

Rozdziel te przypadki: jednostkowy test logiki powinien podmienić port aplikacji, a test repozytorium powinien potwierdzić zachowanie adaptera infrastruktury. Takie podejście utrzymuje zależności czytelne i pozwala dobrać rodzaj testu do pytania, które naprawdę zadaje.

Wróć do usługi zamówień z początku: jeśli potrafi działać na kontrakcie, możesz zmienić sposób zapisu bez przepisywania reguł zatwierdzania. Odwrócenie zależności jest więc decyzją o granicy odpowiedzialności, a interfejs czy kontener są tylko narzędziami, które pomagają tę granicę utrzymać.

FAQ - Najczęstsze pytania

Umieść kontrakt, taki jak IOrderRepository, w warstwie Application Core, która potrzebuje zapisu zamówienia. Implementację, na przykład SqlOrderRepository korzystającą z EF Core i DbContext, umieść w Infrastructure i połącz oba typy w composition root, na przykład przez rejestrację w IServiceCollection.

DIP określa, że logika powinna zależeć od abstrakcji, takiej jak IOrderRepository, zamiast od konkretnego repozytorium. Wstrzykiwanie zależności opisuje sposób przekazania współpracownika, na przykład przez konstruktor. Kontener DI tworzy i łączy obiekty na podstawie rejestracji, ale można przekazać zależność ręcznie i zachować DIP bez kontenera.

Dodaj abstrakcję, gdy chroni logikę przed zmiennym lub zewnętrznym szczegółem, takim jak zapis przez bazę albo klient płatności wywołujący sieć. Stabilna klasa formatująca tekst zwykle nie potrzebuje własnego interfejsu, jeśli nie ma realnego wariantu do podmiany. Test jednostkowy logiki może podstawić port aplikacji, a test repozytorium powinien sprawdzić adapter i jego zachowanie z bazą.

Oceń artykuł

Ocena: 0.00 Liczba głosów: 0

Tagi

odwrócenie zależności
wstrzykiwanie zależności
testy jednostkowe
entity framework
Autor Radosław Krajewski
Radosław Krajewski
Nazywam się Radosław Krajewski i od 6 lat zgłębiam tajniki programowania .NET, chmury Azure oraz sztucznej inteligencji. Moja przygoda z tymi technologiami zaczęła się od fascynacji tym, jak złożone problemy można rozwiązywać za pomocą kodu i innowacyjnych narzędzi. Staram się przekazywać tę wiedzę w sposób zrozumiały, dzieląc się swoimi doświadczeniami i spostrzeżeniami na kursdotnet.pl. W moich artykułach skupiam się na praktycznych aspektach, porównuję różne rozwiązania i analizuję najnowsze trendy, aby dostarczyć Wam rzetelne i aktualne informacje, które pomogą Wam rozwijać się w tej dynamicznie zmieniającej się dziedzinie.

Udostępnij artykuł

Napisz komentarz