값으로서의 문자열 : 도메인 별 문자열 유형에 대한 현대적인 접근

도메인 구동 애플리케이션의 원시 문자열은 버그를 방지하고 유형 안전을 향상시키기 위해 값 객체로 대체해야합니다. 1. 원시 문자열을 사용하면 원시 강박 관념이 발생하며, 교환 가능한 문자열 유형은 인수 교환과 같은 미묘한 버그를 유발할 수 있습니다. 2. emailAddress와 같은 가치 객체는 검증, 불변성 및 의미있는 의미론으로 도메인 별 문자열을 캡슐화합니다. 3. 혜택은 유형 안전, 중앙 집중식 검증, 기록을 통한 불변성, 더 나은 발견 성 및 일관된 형식; 4. 도메인 로직을 위해 iscorporate와 같은 도우미 방법을 추가 할 수 있습니다. 5. C# 레코드와 같은 현대 언어 기능은 보일러 플레이트를 줄이는 반면, EF Core와 같은 ORM의 암시 적 연산자 및 가치 변환은 Seamless Interop; 6. 정규화는 일관된 형식을 보장하고 직렬화 라이브러리는 사용자 정의 변환기를 통해 이러한 유형을 처리 할 수 있습니다. 7. 소스 생성기는 반복 코드를 자동화하여 채택을보다 쉽게 할 수 있습니다. 8. 이메일 또는 phoneNumber와 같은 중요한 유형으로 작게 시작하여 명확성, 정확성 및 유지 관리에 대한 명확한 이점을 보여 주므로 도메인 별 문자열에는 전용 유형이 필요하다는 것을 증명합니다.

도메인 중심 애플리케이션에서 문자열로 작업 할 때는 변수, 매개 변수 및 데이터베이스 필드간에 자유롭게 할당하는 원시, 상호 교환 가능한 값으로 쉽게 처리 할 수 있습니다. 그러나 이것은 미묘한 버그, 유형 안전성이 좋지 않으며 추론하기 어려운 코드로 이어집니다. 현대적이고 강력한 접근 방식은 도메인 별 문자열을 가치 객체로 취급하는 것입니다.

이메일 주소, 전화 번호 또는 ID와 같은 것들에 직접 string 사용하는 대신 전용 유형으로 래핑합니다. 이것은 우리에게 더 나은 정확성, 명확성 및 제어를 제공합니다.

원시 문자열이 문제가되는 이유

모든 곳에서 일반 문자열을 사용하면 무해한 것처럼 보일 수 있지만 이것을 고려하십시오.

 문자열 userId = "jane.doe@example.com";
문자열 이메일 = "12345";
SendEmail (이메일, userID);

잠깐만 - 우리는 단지 논쟁을 교환 했습니까? 컴파일러는 이것을 포착하지 않습니다. 둘 다 string 이므로 매우 다른 개념을 나타내더라도 상호 교환 가능합니다.

이것은 원시 강박 관호 코드 냄새입니다. 도메인 개념을 모델링하는 대신 내장 유형에 과도하게 포함됩니다.

구조에 대한 가치를 평가합니다

값 객체는 ID가 아닌 가치로 정의 된 의미있는 도메인 데이터를 나타냅니다. 문자열의 경우, 이것은 규칙을 시행하는 가볍고 불변의 유형으로 포장하는 것을 의미합니다.

예를 들어, EmailAddress 값 객체 :

 공개 레코드 emailaddress (문자열 값)
{
    public static bool tryparse (문자열 입력, out emailaddress? 이메일)
    {
        이메일 = null;
        if (string.isnullorwhitespace (input)) false를 반환합니다.

        노력하다
        {
            var addr = new System.net.mail.MailAddress (입력);
            if (addr.address == 입력)
            {
                email = new emailAddress (input.trim ());
                진실을 반환하십시오.
            }
        }
        잡다 { }

        거짓을 반환합니다.
    }

    공개 재정의 문자열 toString () => value;
}

이제 : 대신 :

 void sendeMail (문자열 to, 문자열)

우리는 다음과 같습니다.

 void sendeMail (emailAddress to, emailAdDress from)

기능 서명은 이제 무언가를 의미합니다 . 이메일이 예상되는 경우 실수로 사용자 ID를 전달할 수 없습니다.

도메인 별 문자열 유형의 이점

• 타입 안전 : 컴파일러는 다양한 종류의 문자열을 혼합하지 못하게합니다.
• 캡슐화 : 유효성 검사 로직은 한 곳에서 값 객체에 있습니다.
• 불변성 : 레코드 (C#) 또는 이와 유사한 구성은 값이 변경되지 않도록합니다.
• 발견 가능성 : IDES는 PhoneNumber , SSN 등을 제안하여 API를 올바르게 사용할 수 있도록 할 수 있습니다.
• 일관성 : 모든 인스턴스는 동일한 규칙 (서식, 정규화 등)을 따릅니다.

도우미를 추가 할 수도 있습니다.

 public bool iscorporate () => value.endswith ( "@company.com", stringcomparison.ordinalignorecase);

일반적인 패턴 및 최적화

문자열 당 새 유형을 만드는 것은 장황감을 느낄 수 있지만 현대 언어는 오버 헤드를 줄입니다.

• C# 레코드는 무료로 Equals , GetHashCode 및 불변성을 제공합니다.
• 암시 적/명시 적 연산자 (드물게 사용)는 인터 로프를 용이하게 할 수 있습니다.

 공개 정적 암시 연산자 문자열 (emailAddress email) => email.value;

그러나 조심하십시오 - 암시 적 전환은 과도하게 사용하면 원래의 문제를 되 찾을 수 있습니다.

또는 도메인 모델을 엄격하게 유지하면서 필요한 경우 (예 : 직렬화를 위해). .Value 노출시킵니다.

또한 정규화를 고려하십시오.

 공개 레코드 사용자 이름 (문자열 값)
{
    public username () : this ( "Guest") {}
    public username (문자열 값) : this (value? .trim (). tolowerinvariant () ?? "Guest") {}
}

이를 통해 시스템 전체의 일관된 형식을 보장합니다.

프레임 워크 및 생태계 지원

Modern ORM (EF Core와 같은)을 지원하는 값 값 전환 값 값 객체를 데이터베이스 열로 전환합니다.

 ModelBuilder.entity <user> ()
    .property (u => u.email)
    .HASCONVERSION (e => e.Value, s => emailAddress.parse (s));

직렬화 라이브러리 (System.text.json, NewTonsoft)는 변환기를 통해 이러한 유형을 처리하도록 가르쳐 줄 수도 있습니다.

소스 생성기 또는 Roslyn 분석기를 사용하면 일반적인 패턴 (예 : NonEmptyString 기본 유형)에 대해서도 자동 생성 보일러 플레이트도 가능합니다.

최종 생각

도메인 별 문자열을 가치 객체로 취급하는 것은 단순히 학문적이 아니라 버그를 방지하고 유지 관리 가능성을 향상 시키며 코드의 의도를 명확하게 표현합니다.

작은 시작 : Email 또는 PhoneNumber 와 같은 임계 문자열 하나를 선택하여 포장하십시오. 버그가 적고, API, 자체 문서화 코드가 적은 혜택을 보면 왜 더 빨리하지 않았는지 궁금해 할 것입니다.

현을 제거하는 것이 아닙니다. 그들에게 의미를 부여하는 것입니다.

기본적으로 문자열이 도메인에서 개념을 나타내는 경우 유형이 필요합니다.

위 내용은 값으로서의 문자열 : 도메인 별 문자열 유형에 대한 현대적인 접근의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!