성태의 닷넷 이야기
홈 주인
모아 놓은 자료
프로그래밍
질문/답변
사용자 관리
사용자
메뉴
아티클
외부 아티클
유용한 코드
온라인 기능
MathJax 입력기
최근 덧글
[정성태] Detecting blocking calls using asyn...
[정성태] 아쉽게도, 커뮤니티는 아니고 개인 블로그입니다. ^^
[정성태] 질문이 잘 이해가 안 됩니다. 우선, 해당 소스코드에서 ILis...
[양승조
] var대신 dinamic으로 선언해서 해결은 했습니다. 맞는 해...
[양승조
] 또 막혔습니다. ㅠㅠ var list = props[i].Ge...
[양승조
] 아. 감사합니다. 어제는 안됐던것 같은데....정신을 차려야겠네...
[정성태] "props[i].GetValue(props[i])" 코드에서 ...
[정성태] 저렇게 조각 코드 말고, 실제로 재현이 되는 예제 프로젝트를 압...
[정성태] Modules 창(Ctrl+Shift+U)을 띄워서, 해당 Op...
[정성태] 만드실 수 있습니다. 단지, Unity 엔진 내의 스크립트와 W...
글쓰기
제목
이름
암호
전자우편
HTML
홈페이지
유형
제니퍼 .NET
닷넷
COM 개체 관련
스크립트
VC++
VS.NET IDE
Windows
Team Foundation Server
디버깅 기술
오류 유형
개발 환경 구성
웹
기타
Linux
Java
DDK
Math
Phone
Graphics
사물인터넷
부모글 보이기/감추기
내용
<div style='display: inline'> <h1 style='font-family: Malgun Gothic, Consolas; font-size: 20pt; color: #006699; text-align: center; font-weight: bold'>C# -Version 1 Source Generator 실습</h1> <p> 예전 글에서 "Soruce Generator"를 소개했는데요,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > C# - Source Generator 소개 ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/12223'>https://www.sysnet.pe.kr/2/0/12223</a> C# - Source Generator를 적용한 XmlCodeGenerator ; <a target='tab' href='https://www.sysnet.pe.kr/2/0/12228'>https://www.sysnet.pe.kr/2/0/12228</a> </pre> <br /> 그때와 살짝 달라진 면이 있어서 다시 정리를 했습니다.<br /> <br /> <hr style='width: 50%' /><br /> <br /> 실습을 위해 프로젝트(이 글에서는 "PropertySrcGenerator")를 다음과 같이 설정하고,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <span style='color: blue; font-weight: bold'><TargetFramework>netstandard2.0</TargetFramework></span> <ImplicitUsings>enable</ImplicitUsings> <LangVersion>10.0</LangVersion> <Nullable>enable</Nullable> </PropertyGroup> <span style='color: blue; font-weight: bold'><ItemGroup> <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.3" /> <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="3.11.0" /> </ItemGroup></span> </Project> </pre> <br /> 소스 생성기의 뼈대도 다음과 같이 구성하면 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > using Microsoft.CodeAnalysis; namespace V1Generator { <span style='color: blue; font-weight: bold'>[Generator]</span> public class PropertySrcGenerator : <span style='color: blue; font-weight: bold'>ISourceGenerator</span> { public void Initialize(GeneratorInitializationContext context) { } public void Execute(GeneratorExecutionContext context) { } } } </pre> <br /> 자, 이 상태에서 우리가 하고 싶은 것은 사용자가 작성한 클래스가 "partial"이면서 "[AutoProp]" 속성을 적용했다면,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > <span style='color: blue; font-weight: bold'>[AutoProp]</span> public <span style='color: blue; font-weight: bold'>partial</span> class Book { string writer; } </pre> <br /> 자동으로 그 클래스가 소유한 필드에 대해 다음과 같은 코드를 만들어 주는 것입니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > <span style='color: blue; font-weight: bold'>partial</span> class Book { string writer; <span style='color: blue; font-weight: bold'>public string Writer { get => writer; set => writer = value; }</span> } </pre> <br /> 그리고 개발의 편의를 위해 Source Generator를 그때그때 동작을 확인하는 용도로 PropertySrcGenerator 프로젝트를 참조하는 예제 프로젝트를 하나 만들고,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > <Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>netcoreapp3.1</TargetFramework> <Nullable>enable</Nullable> </PropertyGroup> <ItemGroup> <span style='color: blue; font-weight: bold'><ProjectReference Include="..\PropertySrcGenerator\PropertySrcGenerator.csproj" OutputItemType="Analyzer" ReferenceOutputAssembly="false" /></span> </ItemGroup> </Project> </pre> <br /> 다음과 같이 코드를 추가합니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > using System; internal class Program { static void Main(string[] args) { Console.WriteLine("Hello World!"); } } <span style='color: blue; font-weight: bold'>[AutoProp]</span> public <span style='color: blue; font-weight: bold'>partial</span> class Book { <span style='color: blue; font-weight: bold'>string writer</span> = ""; } </pre> <br /> 자, 이제 여기서 첫 번째 목표가 나왔군요. 위의 코드가 오류 없이 컴파일되려면, 소스 코드 생성기에서 우선 AutoProp 특성을 사용자가 고정적으로 사용할 수 있게 만들어야 하는데요, 이를 위해 Initialize 단계에서 아래와 같은 코드를 포함하면 됩니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > [Generator] public class PropertySrcGenerator : ISourceGenerator { public const string AutoPropAttribute = @" namespace System { [System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct)] public class AutoPropAttribute : System.Attribute { } }"; public void Initialize(GeneratorInitializationContext context) { <span style='color: blue; font-weight: bold'>context.RegisterForPostInitialization((ctx) => { ctx.AddSource("AutoPropAttribute.g.cs", SourceText.From(AutoPropAttribute, Encoding.UTF8)); });</span> } public void Execute(GeneratorExecutionContext context) { } } </pre> <br /> 그다음, 사용자가 작성한 클래스의 필드에 대해 get/set 속성을 생성하는 코드를 만들어야 하는데요, 이것이 가능하게 만들려면 사용자가 만든 클래스가 우리가 원하는 조건에 맞는 코드인지를 먼저 판정을 할 수 있어야 합니다. 즉, "자동 생성할" 대상 클래스를 먼저 식별해야 하는데요, 이 작업을 구현하기 위한 2가지 선택이 있습니다.<br /> <br /> 첫 번째로, Execute 코드에 1) 대상 식별과 2) 소스 코드 생성을 모두 넣는 것입니다. 당연히 이렇게 하면 Execute 코드 작업이 무거워질 것입니다. 테스트를 해보시면 알겠지만, Execute 코드는 Visual Studio IDE가 소스 코드에 변경이 가해질 때마다 수시로 불리는 구조입니다. 의미인즉, Execute 코드에서 하는 일이 많을 수록 코드 편집 창의 반응 속도는 점점 악화될 수 있다는 것입니다. 그래서, 첫 번째 방식처럼 Execute에서 모든 작업을 담당하는 구조는 <a target='tab' href='https://www.sysnet.pe.kr/2/0/12228'>XmlSrcGenerator</a>처럼 구문 분석이 필요 없는 경우에 적합합니다.<br /> <br /> 두 번째로, Initialize 단계에서 RegisterForSyntaxNotifications을 등록해 Visual Studio IDE가 코드 수정 중 발생하는 구문 분석 단계에서 콜백을 발생시켜 Execute 코드의 대상 식별 단계를 분리해 내는 것입니다. 방법도 어렵지 않은데, 단순히 ISyntaxReceiver를 구현한 클래스의 인스턴스 생성을 하는 델리게이트를 전달해 두면,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > public void Initialize(GeneratorInitializationContext context) { context.RegisterForPostInitialization((ctx) => { ctx.AddSource("AutoPropAttribute.g.cs", SourceText.From(AutoPropAttribute, Encoding.UTF8)); }); <span style='color: blue; font-weight: bold'>context.RegisterForSyntaxNotifications(() => new AutoPropSyntaxReceiver());</span> } </pre> <br /> 이후 비주얼 스튜디오는 코드 편집기에서 구문 분석을 수행할 때마다 콜백을 호출하므로,<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > class AutoPropSyntaxReceiver : <span style='color: blue; font-weight: bold'>ISyntaxReceiver</span> { public void <span style='color: blue; font-weight: bold'>OnVisitSyntaxNode</span>(SyntaxNode syntaxNode) { } } </pre> <br /> 단지 개발자는 OnVisitSyntaxNode에서 대상 코드가 자동 생성될 조건을 만족하는지 식별을 해주면 됩니다. 그리고, 이후 Execute 단계에서는 OnVisitSyntaxNode에서 식별해 두었던 노드 정보를 바탕으로 소스 코드만 생성해 주면 끝입니다.<br /> <br /> 정리해 보면 이렇게 뼈대를 구성할 수 있습니다.<br /> <br /> <pre style='margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > // ...[생략]... namespace V1Generator { [Generator] public class PropertySrcGenerator : ISourceGenerator { // ...[생략]... public void Initialize(GeneratorInitializationContext context) { // ...[생략]... context.RegisterForSyntaxNotifications(() => new AutoPropSyntaxReceiver()); } <span style='color: blue; font-weight: bold'>public void Execute(GeneratorExecutionContext context) { AutoPropSyntaxReceiver? recv = context.SyntaxReceiver as AutoPropSyntaxReceiver; // 미리 대상 클래스를 식별해 보관해 두었던 AutoPropSyntaxReceiver.AutoPropClasses로부터 소스 코드 자동 생성 }</span> } class AutoPropSyntaxReceiver : ISyntaxReceiver { <span style='color: blue; font-weight: bold'>public List<ClassDeclarationSyntax> AutoPropClasses = new List<ClassDeclarationSyntax>();</span> <span style='color: blue; font-weight: bold'>public void OnVisitSyntaxNode(SyntaxNode syntaxNode) { // [AutoProp] 특성이 적용됐고, partial 클래스라면 AutoPropClasses 목록에 추가 }</span> } } </pre> <br /> 간단하게 언급하긴 했지만, 구분 분석에 따른 자잘한 코드가 많아 생각보다 꽤 코딩 분량이 많아집니다. 아래는 위의 내용을 구현한 전체 소스 코드입니다.<br /> <br /> <pre style='height: 400px; margin: 10px 0px 10px 10px; padding: 10px 0px 10px 10px; background-color: #fbedbb; overflow: auto; font-family: Consolas, Verdana;' > using Microsoft.CodeAnalysis; using Microsoft.CodeAnalysis.CSharp.Syntax; using Microsoft.CodeAnalysis.Text; using PropertySrcGenerator; using System.Text; namespace V1Generator { [Generator] public class PropertySrcGenerator : ISourceGenerator { public const string AutoPropAttribute = @" namespace System { [System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Struct)] public class AutoPropAttribute : System.Attribute { } }"; public void Initialize(GeneratorInitializationContext context) { context.RegisterForPostInitialization((ctx) => { ctx.AddSource("AutoPropAttribute.g.cs", SourceText.From(AutoPropAttribute, Encoding.UTF8)); }); context.RegisterForSyntaxNotifications(() => new AutoPropSyntaxReceiver()); } public void Execute(GeneratorExecutionContext context) { AutoPropSyntaxReceiver? recv = context.SyntaxReceiver as AutoPropSyntaxReceiver; if (recv == null) { return; } if (recv.AutoPropClasses.Count == 0) { return; } foreach (var cls in recv.AutoPropClasses) { List<AutoFieldInfo> fieldList = GetFieldList(context.Compilation, cls); if (fieldList.Count == 0) { continue; } string clsNamespace = GetNamespace(context.Compilation, cls); string src = GenerateSource(clsNamespace, cls.Identifier.ValueText, fieldList); context.AddSource($"{cls.Identifier.ValueText}.g.cs", SourceText.From(src, Encoding.UTF8)); } } private string GetNamespace(Compilation compilation, ClassDeclarationSyntax cls) { var model = compilation.GetSemanticModel(cls.SyntaxTree); foreach (NamespaceDeclarationSyntax ns in cls.Ancestors().OfType<NamespaceDeclarationSyntax>()) { return ns.Name.ToString(); } return ""; } private string GenerateSource(string clsNamespace, string className, List<AutoFieldInfo> fieldList) { IndentText sb = new IndentText(); bool hasNamespace = string.IsNullOrEmpty(clsNamespace) == false; if (hasNamespace) { sb.AppendLine($"namespace {clsNamespace}"); sb.AppendLine("{"); } using (sb.Indent(hasNamespace)) { sb.AppendLine(@$"partial class {className}"); sb.AppendLine("{"); using (sb.Indent()) { sb.Append($"public {className}(", true); int count = 0; foreach (var field in fieldList) { sb.Append($"{(count == 0 ? "" : ", ")}{field.TypeName} {field.Identifier}"); count++; } sb.AppendLine(")", false); sb.AppendLine("{"); using (sb.Indent()) { foreach (var field in fieldList) { sb.AppendLine($"this.{field.Identifier} = {field.Identifier};"); } } sb.AppendLine("}"); foreach (var field in fieldList) { sb.AppendLine($"public {field.TypeName} {GetSafeFieldName(field.Identifier)} {{ get => {field.Identifier}; set => {field.Identifier} = value; }}"); } } sb.AppendLine("}"); } if (string.IsNullOrEmpty(clsNamespace) == false) { sb.AppendLine("}"); } return sb.ToString(); } private string GetSafeFieldName(string identifier) { if (identifier[0] == '_') { return identifier.Substring(0); } if (char.IsLower(identifier[0])) { return identifier[0].ToString().ToUpper() + identifier.Substring(1); } return identifier.ToUpper(); } private List<AutoFieldInfo> GetFieldList(Compilation compilation, ClassDeclarationSyntax cls) { List<AutoFieldInfo> fieldList = new List<AutoFieldInfo>(); var model = compilation.GetSemanticModel(cls.SyntaxTree); foreach (FieldDeclarationSyntax field in cls.DescendantNodes().OfType<FieldDeclarationSyntax>()) { foreach (var item in field.Declaration.Variables) { AutoFieldInfo info = new AutoFieldInfo { Identifier = item.Identifier.ValueText, TypeName = field.Declaration.Type.ToString() }; fieldList.Add(info); } } return fieldList; } } public struct AutoFieldInfo { public string Identifier; public string TypeName; } class AutoPropSyntaxReceiver : ISyntaxReceiver { public List<ClassDeclarationSyntax> AutoPropClasses = new List<ClassDeclarationSyntax>(); public void OnVisitSyntaxNode(SyntaxNode syntaxNode) { if (syntaxNode is not ClassDeclarationSyntax cds) { return; } foreach (var item in cds.AttributeLists) { foreach (var attr in item.Attributes) { string attrName = attr.Name.ToString(); switch (attrName) { case "AutoProp": case "System.AutoProp": case "AutoPropAttribute": case "System.AutoPropAttribute": foreach (var mod in cds.Modifiers) { if (mod.ValueText == "partial") { AutoPropClasses.Add(cds); return; } } break; } } } } } } </pre> <br /> 이렇게 해서 Source Generator의 Version 1 규약을 이용해 자동 소스 코드 생성을 해봤습니다. ^^<br /> <br /> (이 글의 소스 생성기 프로젝트는 <a target='tab' href='https://github.com/stjeong/SampleSrcGen/tree/master/PropertySrcGenerator'>PropertySrcGenerator</a>이고, 그것을 적용한 예제 프로젝트는 <a target='tab' href='https://github.com/stjeong/SampleSrcGen/tree/master/PropertySrcSample'>PropertySrcSample</a>입니다.)<br /> </p><br /> <br /><hr /><span style='color: Maroon'>[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]</span> </div>
첨부파일
스팸 방지용 인증 번호
1367
(왼쪽의 숫자를 입력해야 합니다.)