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.

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ęcie | Na jakie pytanie odpowiada | Przykład w .NET |
|---|---|---|
| DIP, odwrócenie zależności | Od czego powinien zależeć kod? | PlaceOrder zależy od IOrderRepository. |
| DI, wstrzykiwanie zależności | Jak obiekt otrzymuje współpracownika? | Konstruktor PlaceOrder przyjmuje repozytorium. |
| Kontener DI | Kto tworzy i łączy obiekty? | Rejestracja interfejsu i implementacji w IServiceCollection. |
| IoC, odwrócenie sterowania | Kto 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.
| Sytuacja | Prawdopodobny skutek | Co 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ć.
