DI 컨테이너 기초
제어의 역전과 서비스 등록을 이해하고 .NET DI 컨테이너가 의존성을 확인하는 방식을 배웁니다.
DI 컨테이너 기초은(는) CoddyKit의 무료 C# Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C# Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
의존성 주입이란 무엇인가요?
의존성 주입(DI)은 클래스가 의존성을 직접 만들지 않고 외부 원본에서 받는 설계 패턴입니다.
클래스 내부에 var repo = new UserRepository();를 작성하는 대신, 클래스가 필요한 항목을 선언하면 DI 컨테이너가 이를 제공합니다.
제어의 역전
DI는 제어의 역전(IoC) 원칙을 구체적으로 구현한 것입니다. 의존성을 만드는 제어권이 의존하는 클래스에서 외부 컨테이너로 넘어갑니다.
따라서 클래스를 더 쉽게 테스트하고 교체할 수 있습니다.
.NET DI 컨테이너 설정하기
.NET app에서는 Program.cs의 IServiceCollection을 통해 DI 컨테이너를 구성합니다. 서비스가 등록되면 런타임에서 이를 확인하고 가져옵니다.
var builder = WebApplication.CreateBuilder(args);
// Register services
builder.Services.AddScoped<IUserRepository, UserRepository>();
builder.Services.AddScoped<UserService>();
var app = builder.Build();
app.Run();인터페이스 및 구현 정의
DI는 인터페이스를 대상으로 프로그래밍할 때 가장 효과적입니다. 서비스 계약을 위한 인터페이스와 이를 구현하는 구체 클래스를 정의하십시오.
public interface IUserRepository
{
User? GetById(int id);
}
public class UserRepository : IUserRepository
{
public User? GetById(int id)
{
// fetch from database
return new User { Id = id, Name = "Alice" };
}
}생성자를 통한 서비스 해결
컨테이너는 등록된 서비스를 생성자에 자동으로 주입합니다. 클래스는 필요한 인터페이스만 선언하면 되므로 new 키워드가 필요하지 않습니다.
public class UserService
{
private readonly IUserRepository _repo;
public UserService(IUserRepository repo)
{
_repo = repo;
}
public User? FindUser(int id) => _repo.GetById(id);
}여러 서비스 등록
필요한 만큼 서비스를 등록할 수 있습니다. 일반적인 확장 메서드는 AddTransient, AddScoped, AddSingleton이며, 각각 서로 다른 수명을 정의합니다.
builder.Services.AddSingleton<IConfig, AppConfig>();
builder.Services.AddScoped<IUserRepository, UserRepository>();
builder.Services.AddTransient<IEmailService, SmtpEmailService>();
builder.Services.AddScoped<UserService>();IServiceProvider 직접 사용
드문 경우에는 명령형 방식으로 서비스를 해결해야 할 수 있습니다. IServiceProvider를 사용하면 GetRequiredService<T>()를 호출하여 서비스를 해결할 수 있지만, 대부분의 상황에서는 생성자 주입을 우선하십시오.
// Anti-pattern (service locator) — use sparingly
public class ManualResolver
{
private readonly IServiceProvider _sp;
public ManualResolver(IServiceProvider sp) => _sp = sp;
public void DoWork()
{
var svc = _sp.GetRequiredService<UserService>();
svc.FindUser(1);
}
}열린 제네릭 등록
.NET DI는 열린 제네릭 등록을 지원합니다. IRepository<>를 한 번 등록하면 모든 엔터티 형식에 대해 Repository<T>로 해결할 수 있습니다.
builder.Services.AddScoped(typeof(IRepository<>), typeof(Repository<>));
// Resolves as:
// IRepository<User> -> Repository<User>
// IRepository<Order> -> Repository<Order>시작 시 유효성 검사
ValidateOnStart() 또는 ValidateScopes = true를 사용하면 컨테이너가 잘못 구성된 등록(예: 싱글턴 내부에서 범위 지정 서비스를 캡처하는 경우)을 실행 시점이 아니라 애플리케이션 시작 시 감지할 수 있습니다.
builder.Services.AddScoped<IMyService, MyService>();
// Detect scope violations at startup
builder.Host.UseDefaultServiceProvider(options =>
{
options.ValidateScopes = true;
options.ValidateOnBuild = true;
});서비스에 데코레이터 적용
원래 클래스를 수정하지 않고 데코레이터로 서비스를 감쌀 수 있습니다. 먼저 내부 서비스를 등록한 다음, 이를 감싸는 데코레이터를 등록하십시오.
builder.Services.AddScoped<IUserRepository, UserRepository>();
// Decorator pattern
builder.Services.Decorate<IUserRepository, CachedUserRepository>();
// Requires Scrutor NuGet package실전 예제: DI를 사용하는 미니멀 API
미니멀 API에서는 경로 처리기의 매개변수에 서비스를 직접 주입합니다. 컨테이너가 서비스를 자동으로 해결합니다.
app.MapGet("/users/{id}", (int id, UserService svc) =>
{
var user = svc.FindUser(id);
return user is null ? Results.NotFound() : Results.Ok(user);
});빠른 확인
대부분의 클래스에서 의존성을 얻을 때 어떤 방법을 우선해야 할까요?
복습: DI 컨테이너 기초
핵심 요점:
- DI는 의존성 생성을 역전합니다. 클래스 자체가 아니라 컨테이너가 객체를 만듭니다
- AddTransient / AddScoped / AddSingleton으로 서비스를 등록합니다
- 생성자 주입이 표준이며 권장되는 방법입니다
- 열린 제네릭, 데코레이터, ValidateOnBuild는 강력한 고급 기능입니다
자주 묻는 질문
“DI 컨테이너 기초” 강의는 무료인가요?
네 — “DI 컨테이너 기초” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C# Academy 강의 전체를 잠금 해제할 수 있습니다. C# Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“DI 컨테이너 기초”에서 뭘 배우나요?
제어의 역전과 서비스 등록을 이해하고 .NET DI 컨테이너가 의존성을 확인하는 방식을 배웁니다. 브라우저에서 직접 실행하는 실습 코드로 C# Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
C# Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 C# Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“DI 컨테이너 기초” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 C# Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 C# Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.