Repository navigation
Messaging
VM은 IRecipient<TMessage>로 수신 코드를 작성하고, 발신할 메신저로 수신 기간을 선택합니다.
| 메신저 | 수신 기간 |
|---|---|
Messenger |
활성화 → 비활성화 |
LongMessenger |
최초 활성화 시작 → 닫기. 비활성 탭에서도 수신 |
AlwaysMessenger |
생성된 인스턴스가 살아 있는 동안. 닫힌 뒤에도 수신 |
세 메신저는 서로 독립적이며 메시지를 서로 전달하지 않습니다. 같은 수신 코드를 사용해도 한 메신저로 보낸 메시지는 그 메신저의 구독자에게만 전달됩니다.
using CommunityToolkit.Mvvm.Messaging;
using Gyedo;
public sealed record SettingsChanged(string Theme);
public class SettingsViewModel : Screen
{
public void ChangeTheme(string theme)
{
// 한 번 열린 뒤 아직 닫히지 않은 VM에게 전달
this.LongMessenger.Send(new SettingsChanged(theme));
}
}
public class EditorViewModel : Screen, IRecipient<SettingsChanged>
{
public void Receive(SettingsChanged message)
{
// message.Theme 반영
}
}활성 VM에만 보내려면 this.Messenger.Send(...), 생성되어 살아 있는 VM 모두에게 보내려면 this.AlwaysMessenger.Send(...)로 바꿉니다. IRecipient<T>는 자동 등록되므로 같은 수신자를 다시 수동 등록하지 않습니다.
-
Messenger: 활성 상태 설정 후 등록, 비활성화 훅 전에 해제합니다. -
LongMessenger:OnInitialActivatedAsync전에 등록,OnClosedAsync전에 해제합니다. 초기화 실패·취소와 비활성화에서는 유지합니다. 재시도·재활성화로 중복 등록하지 않고, 닫았다 다시 열면 다시 등록합니다. -
AlwaysMessenger: Screen 생성자에서 등록합니다. 닫힌 VM도 앱이 참조를 보관하면 수신합니다. 직접 끝내려면AlwaysMessenger.UnregisterAll(this)를 호출합니다.
기본 메신저는 약한 참조를 사용하므로 구독만으로 VM을 살려 두지 않습니다. Long·Always는 모든 Screen이 공유하는 별도의 인스턴스입니다. Screen 직접 상속 VM의 base(validator, messenger)는 활성 상태용 Messenger만 교체합니다. 발신자와 수신자는 같은 인스턴스를 사용해야 합니다.
수신은 발신한 스레드에서 실행됩니다. UI 갱신은 필요한 경우 Execute.Run로 전달합니다. Receive는 void이며 Send가 수신자의 비동기 작업 완료까지 기다리지는 않습니다.
Toolkit은 메시지의 기반 타입 구독자에게 파생 메시지를 자동 전달하지 않습니다. 토큰 채널도 지원하지만 자동 등록은 기본 채널입니다. 특정 채널은 명시적으로 등록·해제해야 합니다.
일반 Receive를 async void로 바꾸면 발신자가 완료를 기다릴 수 없습니다. 단일 응답에는 AsyncRequestMessage<T>, 여러 수신자의 응답에는 AsyncCollectionRequestMessage<T>를 사용합니다.
RedditBrowser는 화면을 여는 요청에 탐색 Task로 응답합니다. 발신 명령은 다음처럼 모든 결과를 기다립니다.
var request = new OpenSubredditRequest(this.Subreddit, this.SelectedSortMode);
var results = await this.AlwaysMessenger.Send(request).GetResponsesAsync();OpenSubredditRequest는 샘플의 AsyncCollectionRequestMessage<bool> 파생 타입입니다. Shell은 Receive에서 request.Reply(this.OpenSubredditAsync(request))로 응답하며, 탐색 실패·취소는 false로 반환합니다. 생성자 구독과 같은 수신 기간을 유지하려고 AlwaysMessenger를 사용합니다. 발신 · 수신
호스트는 IMessenger를 Singleton으로 등록하며 기본값은 WeakReferenceMessenger.Default입니다. 앱이 먼저 등록한 구현은 유지합니다. 사용자 지정 활성 메신저는 VM에 주입해 base(validator, messenger)로 전달합니다. LongMessenger·AlwaysMessenger에는 영향을 주지 않습니다.
기존 EventAggregator API는 제거했습니다. 이전표에서 수신 기간·메시지 타입·채널·UI 전달 차이를 확인하세요.