CodeGym /행동 /C# SELF /실용적인 시나리오 및 모범 사례

실용적인 시나리오 및 모범 사례

C# SELF
레벨 53, 레슨 4
사용 가능

1. 이벤트의 실용적 사용 시나리오

이벤트는 단순한 이론이 아니다. 실무에서는 거의 모든 애플리케이션에 필요하고, 특히 UI나 네트워크 서비스를 다루면 대부분의 경우에 쓰인다.

몇 가지 전형적인 실제 시나리오를 살펴보자. 동시에 표준과 모범 사례가 흔한 실수를 어떻게 피하게 해 주는지도 보자.

사용자 동작에 반응하기 (UI처럼)

아마도 가장 빈번한 시나리오가 사용자가 뭔가를 했을 때(버튼 클릭, 리스트에서 항목 선택 등) 애플리케이션이 반응해야 하는 경우다. Windows Forms, WPF, UWP, Avalonia, MAUI 같은 UI 프레임워크가 바로 이렇게 동작한다.

미니 예제 (UI 없이 버튼을 흉내):


public class Button
{
    public event EventHandler? Click; // 표준 델리게이트

    public void SimulateClick()
    {
        Click?.Invoke(this, EventArgs.Empty); // "버튼"이 "클릭"됨
    }
}

class Program
{
    static void Main()
    {
        var button = new Button();
        button.Click += (sender, e) => Console.WriteLine("버튼이 눌렸습니다!");
        button.SimulateClick(); // > 버튼이 눌렸습니다!
    }
}

실제 UI 프레임워크에서는 Click 이벤트가 사용자가 마우스로 누르거나 터치할 때 발생한다. 이벤트에 구독한 모든 것은 알림을 받고 그에 따라 동작한다 — 애플리케이션 로직이 이렇게 동작한다.

진행 상황, 완료, 오류 알림

파일 다운로드, 데이터 처리, 긴 계산 같은 작업을 생각해보자. 진행 상황이나 오류를 알려야 한다. 보통 "진행 단계" 이벤트와 "완료" 또는 "오류" 이벤트를 따로 둔다.

파일 다운로더 예제:


public class FileDownloader
{
    public event EventHandler<int>? ProgressChanged;
    public event EventHandler? DownloadCompleted;
    public event EventHandler<string>? DownloadFailed;

    public void Download()
    {
        for (int i = 1; i <= 100; i += 10)
        {
            Thread.Sleep(50); // 지연 시뮬레이션
            ProgressChanged?.Invoke(this, i);
        }
        DownloadCompleted?.Invoke(this, EventArgs.Empty);
    }
}

var downloader = new FileDownloader();
downloader.ProgressChanged += (s, progress) => Console.WriteLine($"다운로드: {progress}%");
downloader.DownloadCompleted += (s, e) => Console.WriteLine("다운로드 완료.");
downloader.Download();

여기서는 여러 이벤트가 있다: 필요한 것만 구독하거나 전부 구독할 수 있다. .NET의 많은 표준 클래스(스레드, 파일 다운로드, HTTP 등)도 비슷하게 작동한다.

도메인 객체의 생명주기 반응(예: "저장됨", "삭제됨")

도메인 모델이 있을 때, 사용자가 객체를 저장하거나 삭제하면 캐시 업데이트, 로깅, 메시지 전송 등 다른 프로세스가 반응하길 원할 수 있다.


public class UserRepository
{
    public event EventHandler<UserEventArgs>? UserSaved;
    public event EventHandler<UserEventArgs>? UserDeleted;

    public void Save(User user)
    {
        //... 사용자 저장
        UserSaved?.Invoke(this, new UserEventArgs(user));
    }

    public void Delete(User user)
    {
        //... 사용자 삭제
        UserDeleted?.Invoke(this, new UserEventArgs(user));
    }
}

public class UserEventArgs : EventArgs
{
    public User User { get; }
    public UserEventArgs(User user) => User = user;
}

이제 서로 다른 모듈들이 구독해서—직접적인 결합 없이—사용자 변경을 받아볼 수 있다. 리포지토리는 누가 구독했는지 알 필요가 없다.

비동기 이벤트와 멀티스레딩

가끔 이벤트가 메인(UI) 스레드가 아닌 곳에서 발생한다 — 백그라운드 작업, 타이머, 비동기 연산 등에서. 이 경우 핸들러 코드는 "다른" 스레드에서 실행될 수 있다는 점을 기억해야 한다. 만약 핸들러가 다른 스레드에서 직접 UI를 업데이트하려 하면 예외가 난다.

마샬링이란? 마샬링은 코드 실행을 한 스레드에서 다른 스레드로 전달하는 것, 보통 백그라운드에서 UI 스레드로 전달해서 안전하게 UI를 업데이트하도록 하는 걸 말한다. UI 앱(WinForms, WPF)에서는 SynchronizationContext나 Dispatcher 같은 메커니즘을 써서 호출을 적절한 스레드로 "보내" 준다.

이렇게 하지 마라:


// 이벤트가 백그라운드 스레드에서 호출되는데, 핸들러가 UI를 직접 업데이트하면 예외가 난다!

권장: 실행 중인 스레드를 확인하고 필요하면 UI 스레드로 마샬링하라 (SynchronizationContext나 Dispatcher를 통해). 콘솔이나 서버 앱에서는 대개 이런 제약이 없다.

Event Aggregator / Messaging

큰 앱에서는 중앙 이벤트 애그리게이터(Event Aggregator)를 자주 쓴다. 결합도를 낮춰서 발행자와 구독자가 서로 모르는 채 중앙을 통해 메시지를 주고받게 해 준다.


public class EventAggregator
{
    public event EventHandler<SomeEventArgs>? SomeEvent;

    public void Publish(SomeEventArgs args)
    {
        SomeEvent?.Invoke(this, args);
    }
}

2. 모범 패턴과 실무 팁

[CallerMemberName] 속성 사용

인프라 코드를 만들 때(예: 로거, 트레이서), 이벤트의 소스 메서드 이름을 CallerMemberName로 기록하면 진단이 훨씬 쉬워진다.

필요하면 이벤트를 thread-safe 하게 만들자

이벤트는 멀티캐스트고 여러 스레드에서 접근할 수 있으니 주의해야 한다: 호출 전에 델리게이트를 로컬 변수에 복사하라.


var handler = MyEvent;
if (handler != null) handler(this, args);

C# 6+에서는 안전 호출을 사용하자: MyEvent?.Invoke(this, args).

사용자 정의 EventArgs는 immutable로

자신의 EventArgs 타입은 읽기 전용 프로퍼티만 갖게 하라 — 구독자가 상태를 실수로 변경하는 것을 막는다.


public class WorkCompletedEventArgs : EventArgs
{
    public string Message { get; }
    public WorkCompletedEventArgs(string message) => Message = message;
}

public event와 캡슐화

이벤트는 public event로 선언하고, 호출은 protected virtual 메서드 OnEventName로 캡슐화하라. 이렇게 하면 상속해서 동작을 재정의할 수 있고 외부에서 직접 이벤트를 호출하지 못하게 된다.

생명주기 순서를 깨지 마라

긴 체인의 핸들러를 호출할 때 누군가 내부 로직을 변경하려 할 수 있다. 언제 어디서 이벤트가 발생하는지 문서화하고, 이벤트가 여러 번 발생할 수 있는지 명확히 하라.

여러 이벤트와 구성

하나의 객체가 여러 소스를 구독할 때는 구독과 구독 해제를 한 곳에 모아라(예: Subscribe/Unsubscribe 메서드). 필요하면 편한 구독 해제를 위해 private 델리게이트 필드를 보관하라.

3. 이벤트를 잘못 사용하는 방법: 흔한 실수

실수 №1: 표준 이벤트 패턴 무시하기.
각 클래스가 모든 이벤트에 대해 자체 델리게이트를 만들면 금방 난장판이 된다. 가능하면 표준 델리게이트 EventHandler 또는 EventHandler<T>(여기서 T는 EventArgs를 상속)를 사용하라. .NET 개발자에게 익숙하고 코드가 더 읽기 쉬워진다.

실수 №2: 외부 코드에서 이벤트를 잘못 호출.
이벤트를 발행자 클래스 밖에서 직접 호출하지 마라. 이벤트는 보통 클래스 내부에서, 보호된 메서드 OnEventName를 통해만 발행된다. 구독자는 구독(+=)과 해제(-=)만 할 수 있다.

나쁜 예:


foo.MyEvent(); // 오류! 외부에서 이벤트를 직접 호출하면 안 된다

좋은 예:


// foo 내부에서만:
// protected virtual void OnMyEvent()
// {
//     MyEvent?.Invoke(this, EventArgs.Empty);
// }

실수 №3: 구독자 유무(null) 체크 없이 이벤트 호출.
구독자가 없는 이벤트를 호출하면 NullReferenceException이 날 수 있다. C# 6.0+에서는 ?.Invoke(...)를 사용하면 구독자가 있을 때만 호출된다.

실수 №4: 구독 해제를 잊어버려 메모리 누수 발생.
객체가 이벤트에 구독했는데 파괴되기 전에 구독을 취소하지 않으면 발행자가 구독자를 참조하게 되어 GC로 수거되지 못한다. 장수명 발행자와 단수명 구독자(예: ViewModel, 폼) 조합에서 특히 문제가 된다. 명시적 구독 해제나 상황에 맞게 WeakReference를 사용하는 것이 좋다.

실수 №5: 보호된 가상 메서드 OnEvent 없이 이벤트를 직접 호출.
이벤트를 직접 호출하면 상속자가 동작을 올바르게 재정의할 수 없게 된다. 표준 패턴은 이벤트를 호출하는 protected virtual 메서드를 제공하는 것이다.

표준 예제:


protected virtual void OnSomething(EventArgs e)
{
    Something?.Invoke(this, e);
}
2
과제
C# SELF, 레벨 53, 레슨 4
잠금
객체의 생명주기 관리를 이벤트로 제어하기
객체의 생명주기 관리를 이벤트로 제어하기
1
설문조사/퀴즈
이벤트 생명주기, 레벨 53, 레슨 4
사용 불가능
이벤트 생명주기
이벤트 구독에 대한 자세한 분석
코멘트
TO VIEW ALL COMMENTS OR TO MAKE A COMMENT,
GO TO FULL VERSION