DreamineEntryAttribute가 적용된 WPF 엔트리 클래스를 분석하고 Dreamine 부트스트랩 코드를 생성하는 증분 생성기입니다. 더 자세히 ...

Dreamine.MVVM.Generators.DreamineEntryGenerator에 대한 상속 다이어그램 :

Dreamine.MVVM.Generators.DreamineEntryGenerator에 대한 협력 다이어그램:

Public 멤버 함수
void	Initialize (IncrementalGeneratorInitializationContext context)
	증분 생성기 파이프라인을 초기화합니다.

정적 Private 멤버 함수
static bool	IsCandidateSyntax (SyntaxNode node)
	엔트리 후보가 될 수 있는 구문인지 확인합니다.
static ? EntryCandidateModel	TryCreateCandidate (GeneratorSyntaxContext context, INamedTypeSymbol? entryAttributeSymbol, INamedTypeSymbol? applicationSymbol)
	구문/시맨틱 정보를 기반으로 엔트리 후보 모델을 생성합니다.
static void	Emit (SourceProductionContext context, ImmutableArray< EntryCandidateModel > candidates)
	수집된 엔트리 후보를 진단하고 소스를 생성합니다.
static bool	IsPartial (ClassDeclarationSyntax classDeclaration)
	클래스 선언이 partial인지 확인합니다.
static bool	InheritsFrom (INamedTypeSymbol symbol, INamedTypeSymbol baseTypeSymbol)
	대상 클래스가 지정한 기반 타입을 상속하는지 확인합니다.
static string	BuildEntrySource (string namespaceName, string className)
	엔트리 부트스트랩 소스 코드를 생성합니다.

정적 Private 속성
const string	EntryAttributeMetadataName = "Dreamine.MVVM.Attributes.DreamineEntryAttribute"
const string	WpfApplicationMetadataName = "System.Windows.Application"
static readonly DiagnosticDescriptor	EntryMustBePartialDescriptor
static readonly DiagnosticDescriptor	EntryMustInheritApplicationDescriptor
static readonly DiagnosticDescriptor	DuplicateEntryDescriptor

상세한 설명

DreamineEntryAttribute가 적용된 WPF 엔트리 클래스를 분석하고 Dreamine 부트스트랩 코드를 생성하는 증분 생성기입니다.

DreamineEntryGenerator.cs 파일의 15 번째 라인에서 정의되었습니다.

멤버 함수 문서화

◆ BuildEntrySource()

string Dreamine.MVVM.Generators.DreamineEntryGenerator.BuildEntrySource	(	string	namespaceName,
		string	className )

inlinestaticprivate

엔트리 부트스트랩 소스 코드를 생성합니다.

매개변수

namespaceName	대상 네임스페이스입니다.
className	대상 클래스 이름입니다.

반환값: 생성된 C# 소스 코드 문자열입니다.

DreamineEntryGenerator.cs 파일의 243 번째 라인에서 정의되었습니다.

        {
            string namespaceBlockStart = string.IsNullOrWhiteSpace(namespaceName)
                ? string.Empty
                : $"namespace {namespaceName}\r\n{{";
 
            string namespaceBlockEnd = string.IsNullOrWhiteSpace(namespaceName)
                ? string.Empty
                : "}";
 
            return $$"""
// <auto-generated />
#nullable enable
using System.Windows;
using Dreamine.MVVM.Wpf;
 
{{namespaceBlockStart}}
    public partial class {{className}}
    {
        protected override void OnStartup(StartupEventArgs e)
        {
            base.OnStartup(e);
 
            var rootAssembly = typeof({{className}}).Assembly;
 
            RegisterBefore();
 
            DreamineWpfOptions options = DreamineWpfOptions.CreateDefault();
            ConfigureDreamine(options);
 
            DreamineAppBuilder.Initialize(rootAssembly, options);
 
            ShowMainWindow();
            Dispatcher.InvokeAsync(() => RegisterAfter());
        }
        static partial void RegisterBefore();
        static partial void ConfigureDreamine(DreamineWpfOptions options);
        static partial void RegisterAfter();
        static partial void ShowMainWindow();
    }
{{namespaceBlockEnd}}
""";
        }

다음에 의해서 참조됨 : Emit().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Emit()

void Dreamine.MVVM.Generators.DreamineEntryGenerator.Emit	(	SourceProductionContext	context,
		ImmutableArray< EntryCandidateModel >	candidates )

inlinestaticprivate

수집된 엔트리 후보를 진단하고 소스를 생성합니다.

매개변수

context	소스 출력 컨텍스트입니다.
candidates	수집된 엔트리 후보 목록입니다.

DreamineEntryGenerator.cs 파일의 146 번째 라인에서 정의되었습니다.

        {
            if (candidates.IsDefaultOrEmpty)
            {
                return;
            }
 
            foreach (EntryCandidateModel candidate in candidates)
            {
                if (!candidate.IsPartial)
                {
                    context.ReportDiagnostic(Diagnostic.Create(
                        EntryMustBePartialDescriptor,
                        candidate.ClassDeclaration.Identifier.GetLocation(),
                        candidate.ClassName));
                }
 
                if (!candidate.IsApplicationDerived)
                {
                    context.ReportDiagnostic(Diagnostic.Create(
                        EntryMustInheritApplicationDescriptor,
                        candidate.ClassDeclaration.Identifier.GetLocation(),
                        candidate.ClassName));
                }
            }
 
            ImmutableArray<EntryCandidateModel> validCandidates = candidates
                .Where(static candidate => candidate.IsPartial && candidate.IsApplicationDerived)
                .ToImmutableArray();
 
            if (validCandidates.Length == 0)
            {
                return;
            }
 
            if (validCandidates.Length > 1)
            {
                foreach (EntryCandidateModel candidate in validCandidates)
                {
                    context.ReportDiagnostic(Diagnostic.Create(
                        DuplicateEntryDescriptor,
                        candidate.ClassDeclaration.Identifier.GetLocation(),
                        candidate.ClassName));
                }
 
                return;
            }
 
            EntryCandidateModel entryCandidate = validCandidates[0];
            string source = BuildEntrySource(entryCandidate.Namespace, entryCandidate.ClassName);
 
            context.AddSource(
                $"{entryCandidate.ClassName}.DreamineEntry.g.cs",
                SourceText.From(source, Encoding.UTF8));
        }

다음을 참조함 : BuildEntrySource(), DuplicateEntryDescriptor, EntryMustBePartialDescriptor, EntryMustInheritApplicationDescriptor.

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ InheritsFrom()

bool Dreamine.MVVM.Generators.DreamineEntryGenerator.InheritsFrom	(	INamedTypeSymbol	symbol,
		INamedTypeSymbol	baseTypeSymbol )

inlinestaticprivate

대상 클래스가 지정한 기반 타입을 상속하는지 확인합니다.

매개변수

symbol	검사할 클래스 심볼입니다.
baseTypeSymbol	기준 기반 타입 심볼입니다.

반환값: 상속 관계가 있으면 true이고, 아니면 false입니다.

DreamineEntryGenerator.cs 파일의 220 번째 라인에서 정의되었습니다.

        {
            INamedTypeSymbol? current = symbol;
 
            while (current is not null)
            {
                if (SymbolEqualityComparer.Default.Equals(current, baseTypeSymbol))
                {
                    return true;
                }
 
                current = current.BaseType;
            }
 
            return false;
        }

다음에 의해서 참조됨 : TryCreateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ Initialize()

void Dreamine.MVVM.Generators.DreamineEntryGenerator.Initialize ( IncrementalGeneratorInitializationContext context )

inline

증분 생성기 파이프라인을 초기화합니다.

매개변수

context 생성기 초기화 컨텍스트입니다.

DreamineEntryGenerator.cs 파일의 48 번째 라인에서 정의되었습니다.

        {
            IncrementalValueProvider<INamedTypeSymbol?> entryAttributeSymbolProvider =
                context.CompilationProvider.Select(
                    static (compilation, _) => compilation.GetTypeByMetadataName(EntryAttributeMetadataName));
 
            IncrementalValueProvider<INamedTypeSymbol?> applicationSymbolProvider =
                context.CompilationProvider.Select(
                    static (compilation, _) => compilation.GetTypeByMetadataName(WpfApplicationMetadataName));
 
            IncrementalValueProvider<(INamedTypeSymbol? EntryAttributeSymbol, INamedTypeSymbol? ApplicationSymbol)> symbolsProvider =
                entryAttributeSymbolProvider.Combine(applicationSymbolProvider);
 
            IncrementalValueProvider<ImmutableArray<EntryCandidateModel>> candidateProvider =
                context.SyntaxProvider
                    .CreateSyntaxProvider(
                        predicate: static (node, _) => IsCandidateSyntax(node),
                        transform: static (syntaxContext, _) => syntaxContext)
                    .Combine(symbolsProvider)
                    .Select(static (pair, _) => TryCreateCandidate(pair.Left, pair.Right.EntryAttributeSymbol, pair.Right.ApplicationSymbol))
                    .Where(static candidate => candidate is not null)
                    .Select(static (candidate, _) => candidate!)
                    .Collect();
 
            context.RegisterSourceOutput(candidateProvider, static (sourceProductionContext, candidates) =>
            {
                Emit(sourceProductionContext, candidates);
            });
        }

다음을 참조함 : Emit(), EntryAttributeMetadataName, IsCandidateSyntax(), TryCreateCandidate(), WpfApplicationMetadataName.

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ IsCandidateSyntax()

bool Dreamine.MVVM.Generators.DreamineEntryGenerator.IsCandidateSyntax ( SyntaxNode node )

inlinestaticprivate

엔트리 후보가 될 수 있는 구문인지 확인합니다.

매개변수

node	검사할 구문 노드입니다.

반환값: 후보가 될 수 있으면 true이고, 아니면 false입니다.

DreamineEntryGenerator.cs 파일의 83 번째 라인에서 정의되었습니다.

        {
            return node is ClassDeclarationSyntax classDeclaration &&
                   classDeclaration.AttributeLists.Count > 0;
        }

다음에 의해서 참조됨 : Initialize().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ IsPartial()

bool Dreamine.MVVM.Generators.DreamineEntryGenerator.IsPartial ( ClassDeclarationSyntax classDeclaration )

inlinestaticprivate

클래스 선언이 partial인지 확인합니다.

매개변수

classDeclaration 검사할 클래스 선언입니다.

반환값: partial이면 true이고, 아니면 false입니다.

DreamineEntryGenerator.cs 파일의 209 번째 라인에서 정의되었습니다.

        {
            return classDeclaration.Modifiers.Any(static modifier => modifier.IsKind(Microsoft.CodeAnalysis.CSharp.SyntaxKind.PartialKeyword));
        }

다음에 의해서 참조됨 : TryCreateCandidate().

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ TryCreateCandidate()

? EntryCandidateModel Dreamine.MVVM.Generators.DreamineEntryGenerator.TryCreateCandidate	(	GeneratorSyntaxContext	context,
		INamedTypeSymbol?	entryAttributeSymbol,
		INamedTypeSymbol?	applicationSymbol )

inlinestaticprivate

구문/시맨틱 정보를 기반으로 엔트리 후보 모델을 생성합니다.

매개변수

context	구문 분석 컨텍스트입니다.
entryAttributeSymbol	`DreamineEntryAttribute` 심볼입니다.
applicationSymbol	WPF `Application` 심볼입니다.

반환값: 엔트리 후보이면 EntryCandidateModel를 반환하고, 아니면 null을 반환합니다.

DreamineEntryGenerator.cs 파일의 99 번째 라인에서 정의되었습니다.

        {
            if (entryAttributeSymbol is null || applicationSymbol is null)
            {
                return null;
            }
 
            if (context.Node is not ClassDeclarationSyntax classDeclaration)
            {
                return null;
            }
 
            if (context.SemanticModel.GetDeclaredSymbol(classDeclaration) is not INamedTypeSymbol classSymbol)
            {
                return null;
            }
 
            bool hasEntryAttribute = classSymbol
                .GetAttributes()
                .Any(attribute => SymbolEqualityComparer.Default.Equals(attribute.AttributeClass, entryAttributeSymbol));
 
            if (!hasEntryAttribute)
            {
                return null;
            }
 
            string namespaceName = classSymbol.ContainingNamespace is { IsGlobalNamespace: false }
                ? classSymbol.ContainingNamespace.ToDisplayString()
                : string.Empty;
 
            return new EntryCandidateModel(
                classSymbol,
                classDeclaration,
                namespaceName,
                classSymbol.Name,
                IsPartial(classDeclaration),
                InheritsFrom(classSymbol, applicationSymbol));
        }

다음을 참조함 : InheritsFrom(), IsPartial().

다음에 의해서 참조됨 : Initialize().

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ DuplicateEntryDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineEntryGenerator.DuplicateEntryDescriptor

staticprivate

초기값:

                                                                  = new(
id: "DMG003",
title: "Only one entry class is allowed",
messageFormat: "Only one valid [DreamineEntry] class is allowed but '{0}' is also marked as an entry",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineEntryGenerator.cs 파일의 36 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Emit().

◆ EntryAttributeMetadataName

const string Dreamine.MVVM.Generators.DreamineEntryGenerator.EntryAttributeMetadataName = "Dreamine.MVVM.Attributes.DreamineEntryAttribute"

staticprivate

DreamineEntryGenerator.cs 파일의 17 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Initialize().

◆ EntryMustBePartialDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineEntryGenerator.EntryMustBePartialDescriptor

staticprivate

초기값:

                                                                      = new(
id: "DMG001",
title: "Entry class must be partial",
messageFormat: "Class '{0}' marked with [DreamineEntry] must be declared partial",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineEntryGenerator.cs 파일의 20 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Emit().

◆ EntryMustInheritApplicationDescriptor

readonly DiagnosticDescriptor Dreamine.MVVM.Generators.DreamineEntryGenerator.EntryMustInheritApplicationDescriptor

staticprivate

초기값:

                                                                               = new(
id: "DMG002",
title: "Entry class must inherit Application",
messageFormat: "Class '{0}' marked with [DreamineEntry] must inherit System.Windows.Application",
category: "Dreamine.MVVM.Generators",
defaultSeverity: DiagnosticSeverity.Error,
isEnabledByDefault: true)

DreamineEntryGenerator.cs 파일의 28 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Emit().

◆ WpfApplicationMetadataName

const string Dreamine.MVVM.Generators.DreamineEntryGenerator.WpfApplicationMetadataName = "System.Windows.Application"

staticprivate

DreamineEntryGenerator.cs 파일의 18 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : Initialize().

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

DreamineEntryGenerator.cs

Public 멤버 함수

정적 Private 멤버 함수

정적 Private 속성

상세한 설명

멤버 함수 문서화

◆ BuildEntrySource()

◆ Emit()

◆ InheritsFrom()

◆ Initialize()

◆ IsCandidateSyntax()

◆ IsPartial()

◆ TryCreateCandidate()

멤버 데이터 문서화

◆ DuplicateEntryDescriptor

◆ EntryAttributeMetadataName

◆ EntryMustBePartialDescriptor

◆ EntryMustInheritApplicationDescriptor

◆ WpfApplicationMetadataName