Microsoft MVP성태의 닷넷 이야기
.NET Framework: 959. C# 9.0 - (9) 레코드(Records) [링크 복사], [링크+제목 복사]
조회: 12306
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
(연관된 글이 19개 있습니다.)

C# 9.0 - (9) 레코드(Records)

C# 9.0 - (1) 대상으로 형식화된 new 식(Target-typed new expressions)
; https://www.sysnet.pe.kr/2/0/12363

C# 9.0 - (2) localsinit 플래그 내보내기 무시(Suppress emitting localsinit flag)
; https://www.sysnet.pe.kr/2/0/12364

C# 9.0 - (3) 람다 메서드의 매개 변수 무시(Lambda discard parameters)
; https://www.sysnet.pe.kr/2/0/12365

C# 9.0 - (4) 원시 크기 정수(Native ints)
; https://www.sysnet.pe.kr/2/0/12366

C# 9.0 - (5) 로컬 함수에 특성 지정 가능(Attributes on local functions)
; https://www.sysnet.pe.kr/2/0/12372

C# 9.0 - (6) 함수 포인터(Function pointers)
; https://www.sysnet.pe.kr/2/0/12374

C# 9.0 - (7) 패턴 일치 개선 사항(Pattern matching enhancements)
; https://www.sysnet.pe.kr/2/0/12383

C# 9.0 - (8) 정적 익명 함수 (static anonymous functions)
; https://www.sysnet.pe.kr/2/0/12389

C# 9.0 - (9) 레코드 (Records)
; https://www.sysnet.pe.kr/2/0/12392

C# 9.0 - (10) 대상으로 형식화된 조건식(Target-typed conditional expressions)
; https://www.sysnet.pe.kr/2/0/12399

C# 9.0 - (11) 공변 반환 형식(Covariant return types)
; https://www.sysnet.pe.kr/2/0/12402

C# 9.0 - (12) foreach 루프에 대한 GetEnumerator 확장 메서드 지원(Extension GetEnumerator)
; https://www.sysnet.pe.kr/2/0/12403

C# 9.0 - (13) 모듈 이니셜라이저(Module initializers)
; https://www.sysnet.pe.kr/2/0/12404

C# 9.0 - (14) 부분 메서드에 대한 새로운 기능(New features for partial methods)
; https://www.sysnet.pe.kr/2/0/12405

C# 9.0 - (15) 최상위 문(Top-level statements)
; https://www.sysnet.pe.kr/2/0/12406

C# 9.0 - (16) 제약 조건이 없는 형식 매개변수 주석(Unconstrained type parameter annotations)
; https://www.sysnet.pe.kr/2/0/12423




(이번 실습은 - 오늘 기준 16.7.7의 Visual Studio 2019에서 컴파일은 가능하지만 정상 동작을 하지 않습니다. 따라서 Visual Studio Preview 버전으로 실습해야 합니다.)

record라는 예약어를 알아보기에 앞서, 우선 그동안 (예를 들어 DTO - Data Transfer Object 정도의) 값을 담는 타입을 만들기 위해 어떤 수고를 했는지 살펴보겠습니다.

단순한 예제로, x-y 좌표를 가지는 Point는 다음과 같이 정의를 하게 될 것입니다.

public class Point
{
    public int X;
    public int Y;
}

그런데, 값을 비교하거나 혹은 Dictionary 등의 자료 구조에 키값으로 사용하고 싶다면 Equals와 GetHashCode 메서드를 재정의해야 합니다.

public class Point
{
    // ...필드 정의 생략...

    public override int GetHashCode()
    {
        return X ^ Y; // 실제로는 좀 더 복잡한 hash 계산을 하겠지만!
    }

    public override bool Equals(object obj)
    {
        return this.Equals(obj as Point);
    }

    public virtual bool Equals(Point other)
    {
        if (object.ReferenceEquals(other, null))
        {
            return false;
        }

        return (this.X == other.X && this.Y == other.Y);
    }
}

아쉽게도 여기서 끝이 아닙니다. Equals를 재정의했다면 당연히 그에 준하는 ==, != 연산자도 제공해야 값을 비교한다는 의미가 맞습니다. 따라서 이제 코드는 다음과 같이 좀 더 복잡하게 진화(?)합니다.

public class Point
{
    // ...필드 정의 생략...

    // ...GetHashCode, Equals 생략...

    public static bool operator ==(Point r1, Point r2)
    {
        if (object.ReferenceEquals(r1, null))
        {
            if (object.ReferenceEquals(r2, null))
            {
                return true;
            }

            return false;
        }

        return r1.Equals(r2);
    }

    public static bool operator !=(Point r1, Point r2)
    {
        return !r1.Equals(r2);
    }
}

기왕 하는 김에, Debug 창에 값이 잘 표현이 되도록 ToString도 재정의하게 될 것입니다. ^^

public class Point
{
    // ...필드 정의 생략...

    // ...GetHashCode, Equals 생략...

    // ...==, != 생략...

    public override string ToString()
    {
        return $"{this.GetType().Name} {{ X = {X}, Y = {Y} }}";
    }
}

문제는, 프로젝트를 하면서 생성되는 저런 타입들마다 계속 ==, !=, GetHashCode, Equals, ToString을 만드는 것이 꽤나 지루한 작업이라는 점입니다.

이에 C# 9.0에서는 값을 담는 용도의 클래스에 대해 저런 기본적인 메서드들을 제공해주는 예약어를 하나 추가하게 되었고 바로 그것이 "record"입니다. 실제로 위에서 했던 모든 작업은 단순히 다음과 같이 정의하는 것과 동일한 효과를 갖습니다.

public record Point
{
    public int X;
    public int Y;
}

아주 간단해졌죠! ^^




자, 그럼 이렇게 값을 담는 class를 간단하게 만들 수 있게 되었으니, 이제 불변 타입으로 넘어가 보겠습니다. 예전에는, 이를 위해 속성을 이용한 정의를 지원했습니다.

public class Point
{
    // get / private set 조합으로 정의
    public int X { get; private set; }
    public int Y { get; private set; }

    /* 또는, 다음과 같이 정의
    int _x;
    int _y;

    public int X => _x;
    public int Y => _y;
    */

    public Point(int x, int y)
    {
       this.X = x;
       this.Y = y;
    }
}

하지만, "private set"의 단점으로는 반드시 생성자를 재정의해야 한다는 제약이 있습니다. 바로 이에 대한 보완으로 나온 것이 "init"입니다.

public class Point
{
    public int X { get; init; }
    public int Y { get; init; }
}

#if !NET5_0
// .NET 5.0 환경이 아닌 경우 IsExternalInit 클래스를 별도로 정의해서 컴파일 가능하게 만듦
namespace System.Runtime.CompilerServices
{
    public class IsExternalInit
    {
    }
}
#endif

init은 단 한번만 초기화할 수 있지만 그 초기화를 꼭 해당 타입의 멤버 메서드에서 할 필요가 없습니다. 그래서 다음과 같은 식으로 (생성자 없이도) 속성을 이용한 값 설정을 하는 것이 가능합니다.

Point p = new Point { X = 5, Y = 10 };

이렇게 새롭게 나온 init과 record를 합치면 불변 타입을 (기존 코드와 비교해) 매우 적은 양의 코드로 작성하는 것이 가능합니다.

public record Point
{
    public int X { get; init; }
    public int Y { get; init; }
}




마지막으로, 불변 타입 인스턴스의 값을 변경해 반환하는 코드를 살펴보겠습니다. 예전에는 생성자를 제공했으므로 그것을 이용하거나, 별도로 메서드를 작성하는 식으로 해결을 했습니다.

Point p1 = new Point(5, 10);

// 방법 1: 생성자를 이용
Point p2 = new Point(p1.X + 1, p1.Y + 2);

// 방법 2: 메서드를 이용
Point p3 = p1.Add(1, 2);

public class Point
{
    public int X { get; private set; }
    public int Y { get; private set; }

    public Point(int x, int y)
    {
       this.X = x;
       this.Y = y;
    }

    public Point Add(int x, int y)
    {
        return new Point(this.X + x, this.Y + y);
    }
}

하지만, record + init의 조합에서는 생성자를 굳이 정의하지 않을 수 있게 만들었기 때문에 속성만으로 처리할 수 있게 되었는데,

Point p1 = new Point(5, 10);

// 방법 1: 생성자를 이용
Point p2 = new Point { X = p1.X + 1, Y = p1.Y + 2 };

// 방법 2: 메서드를 이용
Point p3 = p1.Add(1, 2);

public record Point
{
    public int X { get; init; }
    public int Y { get; init; }

    public Point Add(int x, int y)
    {
        return new Point { X = this.X + x, Y = this.Y + y };
    }
}

저렇게 처리했을 때의 문제점이 하나 있다면, 경우에 따라 특정 값만을 변경하려 할 때에도 모든 속성을 함께 명시해야 한다는 점입니다. 가령, 3D 좌표를 나타내는 Point인데, z 좌표 하나 바꾸기 위해 초기화 구문이 필요 이상으로 많아지는 불편함이 있습니다.

Point3D p1 = new Point3D(5, 10, 7);
Point3D p2 = new Point3D { X = p1.X, Y = p1.Y, Z = p1.Z + 1 };

이 문제에 대한 보완으로 record는 초기화를 돕는 숨겨진 Clone 메서드를 public으로 제공합니다. 실제로 record Point로 정의한 타입은 다음과 같은 식의 Clone 메서드를 (protected 생성자와 함께) .NET Reflector 등의 도구로 확인할 수 있습니다.

[NullableContext(1)]
public virtual Point <Clone>$()
{
    return new Point(this);
}

protected Point(Point original)
{
    this.X = original.X;
    this.Y = original.Y;
}

비록 public이지만, 메서드 이름에 있는 유효하지 않은 식별자로 인해 외부 개발자가 직접 편집기를 통해 호출하진 못합니다. (비주얼 스튜디오의 인텔리센스로도 제공되지 않습니다.) 대신, C# 컴파일러는 이 메서드를 "with" 연산자와 함께 사용할 때 호출할 수 있도록 합니다. 그래서 기존 값에 변화를 시키는 코드를 작성하는 경우 다음과 같이 간단하게 타이핑이 됩니다.

Point p1 = new Point(5, 10);

Point p2 = p1 with { Y = p1.Y + 2 }; // p1의 기존 값에서 Y만 변경한 새로운 인스턴스를 반환

public record Point
{
    public int X { get; init; }
    public int Y { get; init; }
}

그럼 C#은 내부적인 Clone 메서드를 호출해 Y 값만 변경시켜 p2 인스턴스를 구성하는 코드로 만들어 줍니다.

// Point p2 = p1 with { Y = p1.Y + 2 }; // p1의 기존 값에서 Y만 변경
==>
    Point p2 = p1.<Clone>$();
    p2.Y = p1.Y + 2;

물론 멤버 메서드 내에서도 이런 식으로 사용할 수 있습니다.

public record Point
{
    public int X { get; init; }
    public int Y { get; init; }

    /* 
    public ImmutablePoint AddX(int x)
    {
        return new ImmutablePoint { X = this.X + x, Y = this.Y };
    }
    */

    public ImmutablePoint AddX(int x)
    {
        return this with { X = this.X + x };
    }
}

이와 같이, record 예약어는 "class 정의를 기반으로 값을 담는 타입"에 대해 간편 구문을 제공합니다.

(첨부 파일은 이 글의 예제 코드를 포함합니다.)




마치기 전에, init에 대해 부가 설명을 좀 더 해보겠습니다. 사실 init은 C#에서만 의미가 있는 예약어로써 IL 코드로는 여전히 "public set"으로 정의되는 것과 같습니다.

// record, init 예약어가 번역된 코드

public /* record */ class Point
{
    //...[생략]...

    public int X { get; /* init */ set; }
    public int Y { get; /* init */ set; }
}

단지 C# 컴파일러 입장에서 저 속성(property)을 다룰 때는 한 번만 대입이 되게 처리를 하는 것뿐입니다. 재미있는 것은, 이렇게 처리를 하는데 특성(attribute)를 사용하지 않고 IL 코드 수준에서 modreq를 이용해 처리를 한다는 점입니다. 실제로 아래의 IL 코드는 init 프로퍼티의 set 메서드가 어떻게 번역되는지를 보여줍니다.

.method public hidebysig specialname instance void modreq (System.Runtime.CompilerServices.IsExternalInit)
    set_Y(int32 'value') cil managed
  {
    .custom instance void [mscorlib]System.Runtime.CompilerServices.CompilerGeneratedAttribute::.ctor()
      = (01 00 00 00 )
    .maxstack 8

    IL_0000: ldarg.0      // this
    IL_0001: ldarg.1      // 'value'
    IL_0002: stfld        int32 Point::'<Y>k__BackingField'
    IL_0007: ret

  } // 




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 8/18/2021]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 



2020-11-06 03시16분
정성태
2020-12-29 09시06분
정성태
2021-03-02 02시19분
정성태
2023-06-02 08시30분
C#의 레코드가 마음에 들지 않는다면, 별도의 소스 생성기로 제공하는 Vogen을 이용해 보는 것도 좋을 것입니다. ^^

SteveDunn/Vogen - A semi-opinionated library which is a source generator and a code analyser. It Source generates Value Objects
; https://github.com/stevedunn/vogen
정성태

... 16  17  [18]  19  20  21  22  23  24  25  26  27  28  29  30  ...
NoWriterDateCnt.TitleFile(s)
13172정성태11/25/20225121.NET Framework: 2071. 닷넷에서 ESP/RSP 레지스터 값을 구하는 방법파일 다운로드1
13171정성태11/25/20224697Windows: 214. 윈도우 - 스레드 스택의 "red zone"
13170정성태11/24/20225018Windows: 213. 윈도우 - 싱글 스레드는 컨텍스트 스위칭이 없을까요?
13169정성태11/23/20225611Windows: 212. 윈도우의 Protected Process (Light) 보안 [1]파일 다운로드2
13168정성태11/22/20224879제니퍼 .NET: 31. 제니퍼 닷넷 적용 사례 (9) - DB 서비스에 부하가 걸렸다?!
13167정성태11/21/20224917.NET Framework: 2070. .NET 7 - Console.ReadKey와 리눅스의 터미널 타입
13166정성태11/20/20224639개발 환경 구성: 651. Windows 사용자 경험으로 WSL 환경에 dotnet 런타임/SDK 설치 방법
13165정성태11/18/20224547개발 환경 구성: 650. Azure - "scm" 프로세스와 엮인 서비스 모음
13164정성태11/18/20225471개발 환경 구성: 649. Azure - 비주얼 스튜디오를 이용한 AppService 원격 디버그 방법
13163정성태11/17/20225396개발 환경 구성: 648. 비주얼 스튜디오에서 안드로이드 기기 인식하는 방법
13162정성태11/15/20226473.NET Framework: 2069. .NET 7 - AOT(ahead-of-time) 컴파일
13161정성태11/14/20225716.NET Framework: 2068. C# - PublishSingleFile로 배포한 이미지의 역어셈블 가능 여부 (난독화 필요성) [4]
13160정성태11/11/20225636.NET Framework: 2067. C# - PublishSingleFile 적용 시 native/managed 모듈 통합 옵션
13159정성태11/10/20228816.NET Framework: 2066. C# - PublishSingleFile과 관련된 옵션 [3]
13158정성태11/9/20225131오류 유형: 826. Workload definition 'wasm-tools' in manifest 'microsoft.net.workload.mono.toolchain' [...] conflicts with manifest 'microsoft.net.workload.mono.toolchain.net7'
13157정성태11/8/20225767.NET Framework: 2065. C# - Mutex의 비동기 버전파일 다운로드1
13156정성태11/7/20226679.NET Framework: 2064. C# - Mutex와 Semaphore/SemaphoreSlim 차이점파일 다운로드1
13155정성태11/4/20226189디버깅 기술: 183. TCP 동시 접속 (연결이 아닌) 시도를 1개로 제한한 서버
13154정성태11/3/20225670.NET Framework: 2063. .NET 5+부터 지원되는 GC.GetGCMemoryInfo파일 다운로드1
13153정성태11/2/20226955.NET Framework: 2062. C# - 코드로 재현하는 소켓 상태(SYN_SENT, SYN_RECV)
13152정성태11/1/20225580.NET Framework: 2061. ASP.NET Core - DI로 추가한 클래스의 초기화 방법 [1]
13151정성태10/31/20225680C/C++: 161. Windows 11 환경에서 raw socket 테스트하는 방법파일 다운로드1
13150정성태10/30/20225717C/C++: 160. Visual Studio 2022로 빌드한 C++ 프로그램을 위한 다른 PC에서 실행하는 방법
13149정성태10/27/20225646오류 유형: 825. C# - CLR ETW 이벤트 수신이 GCHeapStats_V1/V2에 대해 안 되는 문제파일 다운로드1
13148정성태10/26/20225641오류 유형: 824. msbuild 에러 - error NETSDK1005: Assets file '...\project.assets.json' doesn't have a target for 'net5.0'. Ensure that restore has run and that you have included 'net5.0' in the TargetFramew
13147정성태10/25/20224761오류 유형: 823. Visual Studio 2022 - Unable to attach to CoreCLR. The debugger's protocol is incompatible with the debuggee.
... 16  17  [18]  19  20  21  22  23  24  25  26  27  28  29  30  ...