도메인별 언어 정의

DSL(도메인 특정 언어)을 정의하려면 템플릿에서 Visual Studio 솔루션을 만듭니다. 이 솔루션의 중요한 요소는 DslDefinition.dsl에 저장되는 DSL 정의 다이어그램입니다. DSL 정의는 DSL의 클래스와 모양을 정의합니다. 이러한 요소를 수정하고 필요한 내용을 추가한 후에 프로그램 코드를 추가하여 DSL을 보다 자세하게 사용자 지정할 수 있습니다.

DSL을 처음 사용한다면 Visualization and Modeling SDK 사이트에서 제공하는 DSL 도구 랩을 실습하는 것이 좋습니다.

템플릿 솔루션 선택

DSL을 정의하려면 다음 구성 요소를 설치해야 합니다.

• Visual Studio
• Visual Studio 확장 개발 워크로드(Visual Studio SDK 포함)
• Modeling SDK(Visual Studio에서 개별 구성 요소로 설치)

참고 항목

텍스트 템플릿 변환 구성 요소는 Visual Studio 확장 개발 워크로드의 일부로 자동으로 설치됩니다. Visual Studio 설치 프로그램의 개별 구성 요소 탭, SDK, 라이브러리, 프레임워크 범주 아래에서 설치할 수도 있습니다. 개별 구성 요소 탭에서 Modeling SDK 구성 요소를 설치합니다.

새 DSL(도메인 특정 언어)을 만들려면 도메인 특정 언어 프로젝트 템플릿을 사용하여 새 Visual Studio 솔루션을 만듭니다.

DSL 솔루션을 만들려면

1. 새 도메인 특정 언어 프로젝트를 만듭니다.

   도메인 특정 언어 마법사가 열리고 템플릿 DSL 솔루션 목록이 표시됩니다.

2. 각 템플릿을 클릭하여 설명을 확인합니다. 만들려는 DSL과 가장 비슷한 솔루션을 선택합니다.

   각 DSL 템플릿은 기본적인 작업 DSL을 정의합니다. 요구 사항에 맞게 이 DSL을 편집합니다.

   각 샘플을 클릭하면 자세한 내용을 확인할 수 있습니다.

   • 스윔 레인이 있는 DSL을 만들려면 작업 흐름을 선택합니다. 스윔 레인은 다이어그램의 수직 또는 수평 파티션입니다.

   • 포트가 있는 DSL을 만들려면 구성 요소 모델을 선택합니다. 포트는 큰 모양의 모서리에 있는 작은 모양입니다.

   • 구획 도형이 있는 DSL을 만들려면 클래스 다이어그램을 선택합니다. 구획 모양에는 항목 목록이 포함됩니다.

   • 그 외의 경우 또는 확실하지 않은 경우에는 최소 언어를 선택합니다.

   • Windows Forms 또는 WPF 화면에 표시되는 DSL을 만들려면 최소 WinForm Designer 또는 최소 WPF Designer를 선택합니다. 편집기를 정의하려면 코드를 작성해야 합니다. 자세한 내용은 아래 항목을 참조하세요.

     Windows Forms 기반 도메인별 언어 만들기

     WPF 기반 도메인별 언어 만들기

3. 해당하는 마법사 페이지에서 DSL의 파일 이름 확장명을 입력합니다. 이 확장명은 DSL의 인스턴스가 포함된 파일에 사용됩니다.

   • 현재 사용 중인 컴퓨터 또는 DSL을 설치할 컴퓨터의 애플리케이션과 연결되지 않은 파일 이름 확장명을 선택합니다. 예를 들어 docx 및 htm은 파일 이름 확장명으로 사용할 수 없습니다.

   • 입력한 확장명이 DSL로 사용되고 있으면 경고가 표시됩니다. 이 경우 다른 파일 이름 확장명을 사용해야 합니다. Visual Studio SDK 실험적 인스턴스를 다시 설정하여 오래된 실험적 디자이너를 지울 수도 있습니다. Windows 시작 메뉴에서 Visual Studio 재설정을 입력한 다음, 버전 Visual Studio와 일치하는 Microsoft Visual Studio 실험 인스턴스 재설정 명령을 실행합니다.

4. 다른 페이지에서 설정을 조정하거나 기본값을 그대로 사용할 수 있습니다.

5. Finish를 클릭합니다.

   2~3개 프로젝트가 포함된 솔루션이 만들어지고 DSL 정의에서 코드가 생성됩니다.

   이제 사용자 인터페이스는 다음 그림과 같이 표시됩니다.

   

   이 솔루션은 DSL을 정의합니다. 자세한 내용은 도메인 특정 언어 도구 사용자 인터페이스 개요를 참조하세요.

솔루션 테스트

템플릿 솔루션에서 제공하는 작업 DSL을 수정하거나 그대로 사용할 수 있습니다.

솔루션을 테스트하려면 F5 키나 Ctrl+F5를 누릅니다. 새 Visual Studio 인스턴스가 실험적 모드에서 열립니다.

새 Visual Studio 인스턴스의 솔루션 탐색기에서 샘플 파일을 엽니다. 샘플 파일은 도구 상자가 포함된 다이어그램으로 열립니다.

최소 언어 템플릿에서 만든 솔루션을 실행하는 경우 실험적 Visual Studio는 다음 예와 같이 표시됩니다.

도구를 사용해 보고 요소를 만들어 서로 연결합니다.

Visual Studio의 실험적 인스턴스를 닫습니다.

참고 항목

DSL을 수정하면 샘플 테스트 파일에 모양이 더 이상 표시되지 않습니다. 그러나 새 요소를 만들 수는 있습니다.

템플릿 DSL 수정

템플릿 DSL 정의에서 일부 또는 모든 도메인 클래스 및 모양 클래스의 이름을 바꾸고 저장합니다. 새 클래스 이름은 공백이나 문장 부호가 없는 올바른 CLR 이름이어야 합니다.

이러한 클래스를 저장하면 특히 다음과 같은 경우에 유용합니다.

• 루트 클래스는 DSL 정의 다이어그램 왼쪽 위의 클래스 및 관계에 표시됩니다. 해당 클래스의 이름을 DSL과 다르게 바꿉니다. MusicLibrary라는 DSL에 Music이라는 루트 클래스가 있는 경우를 예로 들 수 있습니다.

• 다이어그램 클래스는 DSL 정의 다이어그램 오른쪽 아래의 다이어그램 요소 열에 표시됩니다. 해당 열을 보려면 오른쪽으로 스크롤해야 할 수 있습니다. 이 열의 이름은 보통 YourDslDiagram입니다.

• 작업 흐름 템플릿을 사용했으며 스윔 레인이 있는 다이어그램을 만들려는 경우에는 Actor 도메인 클래스 및 ActorSwimlane 모양을 저장하고 이름을 바꿉니다.

  나머지 클래스는 요구 사항에 맞게 삭제하거나 이름을 바꿉니다.

DSL 정의 패턴

한 번에 1~2개 기능을 추가하거나 조정하여 DSL을 개발하는 것이 좋습니다. 기능 하나를 추가하고 DSL을 실행하여 테스트한 다음 1~2개 기능을 더 추가합니다. DSL의 일반적인 기능은 다음과 같습니다.

• 도메인 클래스, 모델에 요소를 연결하는 포함 관계, 다이어그램에서 해당 클래스의 요소를 표시하는 데 필요한 모양, 사용자가 요소를 만드는 데 사용할 수 있는 요소 도구

• 도메인 클래스의 도메인 속성 및 모양에 이러한 속성을 표시하는 Decorator

• 참조 관계, 다이어그램에 참조 관계를 표시하는 연결선 및 사용자가 링크를 만드는 데 사용할 수 있는 연결선 도구

• 유효성 제약 조건 또는 메뉴 명령과 같이 프로그램 코드가 필요한 사용자 지정 항목

  다음 섹션에서는 가장 유용한 유형의 SDL 기능을 생성하는 방법을 설명합니다. DSL을 생성하는 데 사용할 수 있는 기타 여러 패턴이 있지만 여기서는 가장 자주 사용되는 패턴에 대해 설명합니다.

참고 항목

기능을 추가한 후에는 솔루션 탐색기 도구 모음에서 모든 템플릿 변환을 클릭한 후에 DSL을 빌드하고 실행해야 합니다.

다음 그림에는 이 항목에서 예로 사용되는 DSL의 클래스 및 관계 부분이 나와 있습니다.

그리고 다음 그림에는 이 DSL의 예제 모델이 나와 있습니다.

참고 항목

여기서 "모델"은 사용자가 만드는 DSL 인스턴스를 지칭하며 대개 다이어그램으로 표시됩니다. 이 항목에서는 DSL 사용 시에 표시되는 DSL 정의 다이어그램 및 모델 다이어그램 둘 다에 대해 설명합니다.

도메인 클래스 정의

도메인 클래스는 DSL의 개념을 나타냅니다. 해당 인스턴스는 모델 요소입니다. MusicLibrary DSL에 Album 및 Song이라는 도메인 클래스가 있는 경우를 예로 들 수 있습니다.

도메인 클래스를 만들려면 명명된 도메인 클래스 도구에서 다이어그램으로 클래스를 끈 다음 이름을 바꾸면 됩니다.

자세한 내용은 도메인 클래스의 속성을 참조하세요.

각 도메인 클래스에 대해 포함 관계 만들기

루트 클래스를 제외한 모든 도메인 클래스는 하나 이상되는 포함 관계의 대상이거나 포함 관계의 대상인 클래스에서 상속해야 합니다.

모델에서 모든 모델 요소는 포함 관계의 단일 트리에 포함된 노드입니다. 포함 관계의 소스와 대상을 대개 부모와 자식이라고 합니다.

도메인 클래스의 부모는 다른 요소를 기준으로 클래스 요소의 수명을 지정할 방법에 따라 선택합니다. 일반적으로 트리의 노드를 삭제하면 해당 하위 트리도 삭제됩니다. 그러므로 독립적인 요소의 클래스는 루트 클래스 바로 아래에 포함됩니다.

대개 다른 요소 내에 요소를 표시할 때는 소유자 관계를 지정합니다. 이 경우 가장 적절한 부모 클래스는 컨테이너의 클래스입니다. 단, 컨테이너 내에 표시되는 항목이 실제로는 단순히 독립 요소의 참조 링크인 경우는 예외입니다. 이 경우에는 컨테이너를 삭제하면 참조만 삭제되며 대상은 삭제되지 않습니다.

이 항목에서 설명하는 DSL 정의 패턴에서는 컨테이너를 삭제하면 컨테이너 내에 표시되는 요소도 삭제된다고 가정합니다. 규칙을 정의하면 더 복잡한 체계도 사용할 수 있습니다.

요소 표시 방식	부모(포함) 클래스	DSL 솔루션 템플릿의 예
다이어그램에 표시된 모양 스윔 레인	DSL의 루트 클래스	최소 언어 작업 흐름: 행위자 클래스
스윔 레인의 모양	스윔 레인으로 표시되는 요소의 도메인 클래스	작업 흐름: 작업 클래스
컨테이너를 삭제하면 항목도 삭제되는 모양 내 목록의 항목 모양 모서리의 포트	컨테이너 모양에 매핑되는 도메인 클래스	클래스 다이어그램: 특성 클래스 구성 요소 다이어그램: 포트 클래스
컨테이너를 삭제해도 삭제되지 않는 목록의 항목	DSL의 루트 클래스 목록에 참조 링크가 표시됩니다.
직접 표시되지 않음	부분을 구성하는 클래스

MusicLibrary 예에서 앨범은 사각형으로 표시되며 그 안에 노래 제목이 나열됩니다. 따라서 Album의 부모는 루트 클래스인 Music이고 Song의 부모는 Album입니다.

도메인 클래스와 포함 클래스를 동시에 만들려면 포함 관계 도구와 부모 클래스를 차례로 클릭한 후 다이어그램의 빈 부분을 클릭합니다.

일반적으로 포함 관계와 해당 역할은 클래스 이름을 자동으로 추적하므로 해당 이름을 조정할 필요가 없습니다.

자세한 내용은 도메인 클래스의 속성과 도메인 역할의 속성을 참조하세요.

참고 항목

포함은 상속과는 다릅니다. 포함 관계에 있는 자식은 부모로부터 기능을 상속하지 않습니다.

각 도메인 클래스에 도메인 속성 추가

도메인 속성에는 값이 저장됩니다. 예를 들어 이름, 제목, 게시 날짜 등이 저장될 수 있습니다.

클래스의 도메인 속성을 클릭하고 Enter 키를 누른 후에 속성 이름을 입력합니다. 도메인 속성의 기본 형식은 문자열입니다. 형식을 변경하려면 도메인 속성을 선택하고 속성 창에서 형식을 설정합니다. 사용하려는 형식이 드롭다운 목록에 없으면 속성 형식 추가를 참조하세요.

요소 이름 속성을 설정합니다. 언어 탐색기에서 요소를 식별하는 데 사용할 수 있는 도메인 속성을 선택합니다. 예를 들어 Song 도메인 클래스에서는 Title 도메인 속성을 선택할 수 있습니다. 속성 창에서 Is Element Name을 true로 설정합니다.

파생된 도메인 클래스 만들기

도메인 클래스에 해당 속성과 관계를 상속하는 변형을 포함하려면 해당 클래스에서 파생되는 클래스를 만듭니다. 예를 들어 Album에는 WMA 및 MP3 파생 클래스가 포함될 수 있습니다.

도메인 클래스 도구를 사용하여 파생 클래스를 만듭니다.

상속 도구와 파생 클래스를 차례로 클릭하고 기본 클래스를 클릭합니다.

기본 클래스의 상속 한정자를 추상으로 설정할 수 있습니다. 기본 클래스 인스턴스가 필요한 경우에는 기본 클래스에 대해 별도의 파생 클래스를 만들 수 있습니다.

파생 클래스는 기본 클래스의 속성과 역할을 상속합니다.

DSL 정의 다이어그램 정리

관계를 추가할 때 일부 클래스는 두 곳 이상에 표시됩니다. 클래스 표시 횟수를 줄이고 다이어그램을 더 넓히려면 관계의 대상 클래스를 마우스 오른쪽 단추로 클릭하고 여기로 트리 가져오기를 클릭합니다. 반대로 클래스 표시 횟수를 늘리고 다이어그램을 더 좁히려면 관계의 대상 클래스를 마우스 오른쪽 단추로 클릭하고 트리 분할을 클릭합니다. 이러한 메뉴 명령이 표시되지 않으면 도메인 클래스만 선택했는지 확인하세요.

Ctrl+위쪽 및 Ctrl+아래쪽 화살표를 사용하여 도메인 클래스와 모양 클래스를 이동합니다.

도메인 클래스 테스트

새 도메인 클래스를 테스트하려면

1. 솔루션 탐색기 도구 모음에서 모든 템플릿 변환을 클릭하여 DSL 디자이너 코드를 생성합니다. 이 단계는 자동화할 수 있습니다. 자세한 내용은 모든 템플릿 변환을 자동화하는 방법을 참조하세요.

2. DSL을 빌드하고 실행합니다. 새 Visual Studio 인스턴스를 실험적 모드에서 실행하려면 F5 키 또는 Ctrl+F5 키를 누릅니다. 실험적 Visual Studio 인스턴스에서 DSL의 파일 이름 확장명이 있는 파일을 열거나 만듭니다.

3. 탐색기를 엽니다. 다이어그램 옆쪽에는 일반적으로 이름이 YourLanguage Explorer인 언어 탐색기 창이 있습니다. 이 창이 표시되지 않으면 솔루션 탐색기 아래쪽의 탭에 있을 수 있습니다. 해당 창을 찾을 수 없으면 보기 메뉴에서 다른 창을 가리키고 YourLanguageExplorer를 클릭합니다.

   탐색기에 모델의 트리 뷰가 표시됩니다.

4. 새 요소를 만듭니다. 위쪽의 루트 노드를 마우스 오른쪽 단추로 클릭하고 새 YourClass 추가를 클릭합니다.

   새 클래스 인스턴스가 언어 탐색기에 표시됩니다.

5. 새 인스턴스를 만들 때는 각 인스턴스의 이름이 서로 다른지 확인합니다. 도메인 속성에서 Is Element Name 플래그를 설정한 경우에만 이 확인을 수행하면 됩니다.

6. 도메인 속성을 검사합니다. 클래스의 인스턴스가 선택된 경우 속성 창을 검사합니다. 그러면 이 도메인 클래스에 대해 정의한 도메인 속성이 표시되어야 합니다.

7. 파일을 저장하고 닫았다가 다시 엽니다. 노드를 확장하고 나면 작성한 모든 인스턴스가 탐색기에 표시되어야 합니다.

다이어그램에 표시된 도형 정의

다이어그램에 사각형, 타원 또는 아이콘으로 표시되는 요소 클래스를 정의할 수 있습니다.

다이어그램에 모양으로 표시되는 요소 클래스를 정의하려면

1. 도메인 클래스 정의의 설명에 따라 도메인 클래스를 정의하고 테스트합니다.

   • 클래스의 부모는 루트 클래스여야 합니다. 즉 루트 클래스와 새 도메인 클래스 간에 포함 관계가 있어야 합니다.

   • 다이어그램에 스윔 레인이 있으면 부모는 스윔 레인에 매핑되는 도메인 클래스일 수 있습니다. 이 절차를 계속 진행하기 전에 스윔 레인이 있는 DSL 정의를 참조하세요.

2. 모델 다이어그램에서 요소를 나타낼 도형 클래스를 추가합니다. 이렇게 하려면 다음 도구 중 하나에서 DSL 정의 다이어그램으로 클래스를 끌어 놓습니다.

   • 기하 도형은 사각형이나 타원을 제공합니다.

   • 이미지 도형은 사용자가 제공하는 이미지를 표시합니다.

   • 구획 도형은 항목 목록을 하나 이상 포함하는 사각형입니다.

     모양 클래스의 이름을 바꿉니다. 이 이름은 DSL 정의 다이어그램 오른쪽의 모양 및 연결선 아래에 표시됩니다.

3. 이미지 도형을 만든 경우 이미지를 정의합니다.

   1. 원하는 크기로 이미지 파일을 만듭니다. BMP, JPEG, GIF, EMF 형식이 지원됩니다.

   2. 솔루션 탐색기의 Dsl\Resources에서 파일을 솔루션에 추가합니다.

   3. DSL 정의 다이어그램으로 돌아와 새 이미지 모양 클래스를 선택합니다.

   4. 속성 창에서 이미지 속성을 클릭합니다.

   5. 이미지 선택 대화 상자에서 파일 이름 아래의 드롭다운 메뉴를 클릭하고 이미지를 선택합니다.

4. 도형에 텍스트 데코레이터를 추가하여 도메인 속성을 표시합니다.

   모델 요소의 이름이나 제목을 표시하려면 텍스트 Decorator가 하나 이상 필요할 수 있습니다.

   도형 클래스 헤더를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 텍스트 데코레이터를 클릭합니다. 데코레이터 이름을 설정하고 속성 창에서 해당 위치를 설정합니다.

5. 다이어그램 요소 맵을 사용하여 각 도형을 표시할 도메인 클래스에 연결합니다.

   이렇게 하려면 다이어그램 요소 맵 도구, 도메인 클래스, 도형 클래스를 차례로 클릭합니다.

6. 속성을 텍스트 데코레이터에 매핑합니다.

   1. 다이어그램 요소 맵을 나타내는 모양 클래스와 도메인 클래스 사이의 회색 선을 선택합니다.

   2. DSL 정보 창에서 데코레이터 맵 탭을 클릭합니다. DSL 정보 창이 표시되지 않으면 보기 메뉴에서 다른 창을 가리키고 DSL 정보를 클릭합니다. 모든 내용을 보려면 이 창 위쪽을 올려야 하는 경우가 많습니다.

   3. Decorator의 이름을 선택합니다. 표시 속성에서 도메인 클래스 속성의 이름을 선택합니다. 각 Decorator에 대해 이 단계를 반복합니다.

      관련 요소의 속성을 표시하려면 속성을 표시할 경로 아래 드롭다운 트리 탐색기를 클릭합니다.

   4. 각 Decorator 이름 옆에 확인 표시가 나타나는지 확인합니다.

      

7. 도메인 클래스의 요소를 생성하기 위한 도구 상자 항목을 만듭니다.

   1. DSL 탐색기에서 편집기 노드와 모든 하위 노드를 확장합니다.

   2. 도구 상자 탭 아래에서 MusicLibrary와 같이 DSL과 이름이 같은 노드를 마우스 오른쪽 단추로 클릭합니다. 요소 도구 추가를 클릭합니다.

      참고 항목

      도구 노드를 마우스 오른쪽 단추로 클릭하면 요소 도구 추가가 표시되지 않습니다. 도구 노드 위의 노드를 클릭해야 합니다.

   3. 속성 창에서 새 요소 도구를 선택하고 클래스를 최근 추가한 도메인 클래스로 설정합니다.

   4. 캡션 및 도구 설명을 설정합니다.

   5. 도구 상자 아이콘을 도구 상자에 표시될 아이콘으로 설정합니다. 이 아이콘은 새 아이콘 또는 다른 도구에 이미 사용한 아이콘으로 설정할 수 있습니다.

      새 아이콘을 만들려면 솔루션 탐색기에서 Dsl\Resources를 엽니다. 기존 요소 도구 BMP 파일 중 하나를 복사하여 붙여넣습니다. 붙여넣은 복사본의 이름을 바꾼 다음 두 번 클릭하여 편집합니다.

      DSL 정의 다이어그램으로 돌아와서 도구를 선택하고 속성 창의 도구 상자 아이콘에서 [...]를 클릭합니다. 비트맵 선택 대화 상자의 드롭다운 메뉴에서 .BMP 파일을 선택합니다.

   자세한 내용은 기하 도형의 속성과 이미지 도형의 속성을 참조하세요.

모양을 테스트하려면

1. 솔루션 탐색기 도구 모음에서 모든 템플릿 변환을 클릭하여 DSL 디자이너 코드를 생성합니다.

2. DSL을 빌드하고 실행합니다. 새 Visual Studio 인스턴스를 실험적 모드에서 실행하려면 F5 키 또는 Ctrl+F5 키를 누릅니다. 실험적 Visual Studio 인스턴스에서 DSL의 파일 이름 확장명이 있는 파일을 열거나 만듭니다.

3. 요소 도구가 도구 상자에 표시되는지 확인합니다.

4. 도구에서 모델 다이어그램으로 끌어 도형을 만듭니다.

5. 각 텍스트 데코레이터가 표시되는지와 다음 사항을 확인합니다.

   1. 도메인 속성에 대해 Is UI Read Only 플래그를 설정한 경우를 제외하고는 텍스트 데코레이터를 편집할 수 있습니다.

   2. 속성 창이나 Decorator에서 속성을 편집하면 다른 뷰가 업데이트됩니다.

   모양을 처음으로 테스트한 후에 일부 속성을 조정하고 몇 가지 고급 기능을 더 추가할 수 있습니다. 자세한 내용은 도메인 특정 언어 사용자 지정 및 확장을 참조하세요.

참조 관계 정의

소스 도메인 클래스와 대상 도메인 클래스 간에 참조 관계를 정의할 수 있습니다. 참조 관계는 보통 다이어그램에 연결선(모양 사이의 선)으로 표시됩니다.

예를 들어 음악 앨범 및 아티스트가 다이어그램에 모양으로 표시되는 경우에는 아티스트를 참여 앨범에 연결하는 ArtistsAppearedOnAlbums 관계를 정의할 수 있습니다. 아래 그림의 예를 참조하세요.

참조 관계는 같은 유형의 요소를 연결할 수도 있습니다. 예를 들어 가족 구성도를 나타내는 DSL에서는 부모와 자식의 관계가 개인 간 참조 관계입니다.

참조 관계 정의

참조 관계 도구, 관계의 소스 도메인 클래스, 대상 도메인 클래스를 차례로 클릭합니다. 대상 클래스는 소스 클래스와 같을 수 있습니다.

각 관계에는 관계 상자 양쪽에 선으로 표시되는 두 역할이 있습니다. 각 역할을 선택하고 속성 창에서 해당 속성을 설정할 수 있습니다.

역할 이름을 바꿀 수 있습니다. 예를 들어 개인 간 관계에서는 기본 이름을 부모/자식, 관리자/부하 직원, 교사/학생 등으로 변경할 수 있습니다.

필요하면 각 역할의 다중성을 조정합니다. 각 개인에게 관리자를 한 명까지만 지정하려면 다이어그램의 관리자 레이블 아래에 표시되는 다중성을 0..1로 설정합니다.

관계에 도메인 속성을 추가합니다. 그림에서 아티스트-앨범 관계에는 역할의 속성이 있습니다.

같은 모델 요소 쌍 간에 같은 클래스의 링크가 두 개 이상 있을 수 있다면 관계의 Allows Duplicates 속성을 설정합니다. 예를 들어 교사 한 명이 같은 학생에게 둘 이상의 과목을 가르치도록 허용할 수 있습니다.

자세한 내용은 도메인 클래스의 속성과 도메인 역할의 속성을 참조하세요.

관계를 표시할 연결선 정의

연결선은 모델 다이어그램의 두 모양 사이에 선을 표시합니다.

연결선 도구에서 DSL 정의 다이어그램으로 끌어 놓습니다.

연결선에 레이블을 표시하려면 텍스트 Decorator를 추가하고 해당 위치를 설정합니다. 사용자가 텍스트 데코레이터를 이동할 수 있도록 하려면 Is Moveable 속성을 설정합니다.

다이어그램 요소 맵 도구를 사용하여 연결선을 참조 관계에 연결합니다.

다이어그램 요소 맵을 선택하고 DSL 정보 창과 데코레이터 맵 탭을 차례로 엽니다.

각 데코레이터를 선택하고 표시 속성을 올바른 도메인 속성으로 설정합니다.

데코레이터 목록의 각 항목 옆에 확인 표시가 나타나는지 확인합니다.

연결 작성기 도구 정의

DSL 탐색기 창에서 편집기 노드와 모든 하위 노드를 확장합니다.

DSL과 이름이 같은 노드를 마우스 오른쪽 단추로 클릭하고 새 연결 도구 추가를 클릭합니다.

새 도구를 선택한 상태로 속성 창에서 다음 단계를 수행합니다.

• 캡션 및 도구 설명을 설정합니다.

• 연결 작성기를 클릭하고 새 관계에 적합한 작성기를 선택합니다.

• 도구 상자 아이콘을 도구 상자에 표시할 아이콘으로 설정합니다. 이 아이콘은 새 아이콘 또는 다른 도구에 이미 사용한 아이콘으로 설정할 수 있습니다.

  새 아이콘을 만들려면 솔루션 탐색기에서 Dsl\Resources를 엽니다. 기존 요소 도구 BMP 파일 중 하나를 복사하여 붙여넣습니다. 붙여넣은 복사본의 이름을 바꾼 다음 두 번 클릭하여 편집합니다.

  DSL 정의 다이어그램으로 돌아와서 도구를 선택하고 속성 창의 도구 상자 아이콘에서 [...]를 클릭합니다. 비트맵 선택 대화 상자의 드롭다운 메뉴에서 .BMP 파일을 선택합니다.

참조 관계 및 연결선을 테스트하려면

1. 솔루션 탐색기 도구 모음에서 모든 템플릿 변환을 클릭하여 DSL 디자이너 코드를 생성합니다.

2. DSL을 빌드하고 실행합니다. 새 Visual Studio 인스턴스를 실험적 모드에서 실행하려면 F5 키 또는 Ctrl+F5 키를 누릅니다. 실험적 Visual Studio 인스턴스에서 DSL의 파일 이름 확장명이 있는 파일을 열거나 만듭니다.

3. 연결 도구가 도구 상자에 표시되는지 확인합니다.

4. 도구에서 모델 다이어그램으로 끌어 도형을 만듭니다.

5. 도형 간에 연결을 만듭니다. 연결선 도구와 모양을 차례로 클릭하고 다른 모양을 클릭합니다.

6. 부적절한 클래스 간에 연결을 만들 수 없는지 확인합니다. 예를 들어 앨범과 아티스트 간의 관계가 있는 경우 아티스트를 아티스트에 연결할 수 없는지 확인합니다.

7. 곱셈이 올바른지 확인합니다. 예를 들어 한 사람을 둘 이상의 관리자에게 연결할 수 없는지 확인합니다.

8. 각 텍스트 데코레이터가 표시되는지와 다음 사항을 확인합니다.

   1. 도메인 속성에 대해 Is UI Read Only 플래그를 설정한 경우를 제외하고는 텍스트 데코레이터를 편집할 수 있습니다.

   2. 속성 창이나 Decorator에서 속성을 편집하면 다른 뷰가 업데이트됩니다.

   연결선을 처음으로 테스트한 후에 일부 속성을 조정하고 몇 가지 고급 기능을 더 추가할 수 있습니다. 자세한 내용은 도메인 특정 언어 사용자 지정 및 확장을 참조하세요.

목록을 포함하는 도형 정의: 구획 도형

구획 모양은 항목 목록을 하나 이상 포함합니다. 예를 들어 MusicLibrary DSL에서는 구획 모양을 사용하여 음악 Album을 표시할 수 있습니다. 각 Album에는 노래 목록이 있습니다.

DSL 정의에서 이러한 모양을 적용하는 가장 간단한 방법은 컨테이너와 각 목록에 대해 도메인 클래스를 하나씩 정의하는 것입니다. 컨테이너 클래스는 구획 모양에 매핑됩니다.

자세한 내용은 구획 도형의 속성을 참조하세요.

구획 모양을 정의하려면

1. 컨테이너 도메인 클래스를 만듭니다. 포함 관계 도구와 모델의 루트 클래스를 차례로 클릭하고 DSL 정의 다이어그램의 빈 부분을 클릭합니다. 그러면 예제 그림과 같이 Album이라는 도메인 클래스가 만들어집니다.

   루트 클래스에 포함하는 대신 스윔 레인에 매핑되는 도메인 클래스에 컨테이너를 포함할 수 있습니다.

   Name 등의 도메인 속성을 클래스에 추가하고 속성 창에서 Is Element Name 플래그를 설정합니다.

2. 목록 항목 도메인 클래스를 만듭니다. 포함 관계 도구와 모델의 컨테이너 클래스(Album)를 차례로 클릭하고 다이어그램의 빈 부분을 클릭합니다. 그러면 예제 그림과 같이 Song이라는 도메인 클래스가 만들어집니다.

   Title 등의 도메인 속성을 클래스에 추가하고 Is Element Name 플래그를 설정합니다.

   다른 도메인 속성을 추가합니다.

   표시할 각 목록에 대해 다른 목록 항목 도메인 클래스를 추가합니다.

3. 목록에서 여러 항목 형식을 혼합하여 사용하려면 목록 클래스에서 상속하는 클래스를 만듭니다. 상속 한정자를 설정하여 목록 클래스를 추상으로 지정합니다.

   예를 들어 클래식 음악을 아티스트가 아닌 작곡가를 기준으로 정렬하려면 Song의 두 서브클래스 ClassicalSong 및 NonClassicalSong을 만들 수 있습니다.

4. 구획 도형을 만듭니다. 구획 도형 도구에서 DSL 정의 다이어그램으로 끌어 놓습니다.

   텍스트 Decorator를 추가하고 해당 이름을 설정합니다.

   구획을 추가하고 해당 이름을 설정합니다.

5. 사용자가 목록 구획을 숨길 수 있도록 하려면 구획 도형 클래스를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 데코레이터 확장/축소를 클릭합니다. 속성 창에서 Decorator의 위치를 설정합니다.

6. 다이어그램 요소 맵 도구, 컨테이너 도메인 클래스, 구획 도형을 차례로 클릭합니다.

7. 모양과 도메인 클래스 사이의 다이어그램 요소 맵 링크를 선택하고 DSL 정보 창에서 다음을 수행합니다.

   1. 데코레이터 탭을 클릭합니다. 데코레이터 이름을 클릭하고 표시 속성에서 적절한 항목을 선택합니다. Decorator 이름 옆에 확인 표시가 나타나는지 확인합니다.

   2. 구획 맵 탭을 클릭합니다.

      구획의 이름을 클릭합니다.

      표시되는 요소 컬렉션 경로에서 목록 요소 클래스(Song)로 이동합니다. 탐색기 도구를 사용하려면 드롭다운 화살표를 클릭합니다.

      표시 속성에서 목록에 표시할 속성을 선택합니다. 이 예에서 해당 속성은 Title입니다.

참고 항목

Decorator 맵의 경로 필드와 구획 맵 필드를 사용하면 도메인 클래스와 구획 모양 간에 더 복잡한 관계를 만들 수 있습니다.

도형을 만들 도구를 정의하려면

1. 도메인 클래스의 요소를 생성하기 위한 도구 상자 항목을 만듭니다.

2. DSL 탐색기에서 편집기 노드와 모든 하위 노드를 확장합니다.

3. 도구 상자 탭 아래에서 MusicLibrary와 같이 DSL과 이름이 같은 노드를 마우스 오른쪽 단추로 클릭합니다. 요소 도구 추가를 클릭합니다.

   참고 항목

   도구 노드를 마우스 오른쪽 단추로 클릭하면 요소 도구 추가가 표시되지 않습니다. 도구 노드 위의 노드를 클릭해야 합니다.

4. 속성 창에서 새 요소 도구를 선택하고 클래스를 최근 추가한 도메인 클래스로 설정합니다.

5. 캡션 및 도구 설명을 설정합니다.

6. 도구 상자 아이콘을 도구 상자에 표시될 아이콘으로 설정합니다. 이 아이콘은 새 아이콘 또는 다른 도구에 이미 사용한 아이콘으로 설정할 수 있습니다.

   새 아이콘을 만들려면 솔루션 탐색기에서 Dsl\Resources를 엽니다. 기존 요소 도구 .BMP 파일 중 하나를 복사하여 붙여넣습니다. 붙여넣은 복사본의 이름을 바꾼 다음 두 번 클릭하여 편집합니다.

   DSL 정의 다이어그램으로 돌아와서 도구를 선택하고 속성 창의 도구 상자 아이콘에서 [...]를 클릭합니다. 비트맵 선택 대화 상자의 드롭다운 메뉴에서 BMP 파일을 선택합니다.

구획 모양을 테스트하려면

1. 솔루션 탐색기 도구 모음에서 모든 템플릿 변환을 클릭하여 DSL 디자이너 코드를 생성합니다.

2. DSL을 빌드하고 실행합니다. 새 Visual Studio 인스턴스를 실험적 모드에서 실행하려면 F5 키 또는 Ctrl+F5 키를 누릅니다. 실험적 Visual Studio 인스턴스에서 DSL의 파일 이름 확장명이 있는 파일을 열거나 만듭니다.

3. 도구가 도구 상자에 표시되는지 확인합니다.

4. 도구를 모델 다이어그램으로 끌어 놓습니다. 모양이 만들어집니다.

   요소 이름이 표시되며 기본값으로 자동 설정되는지 확인합니다.

5. 새 도형의 헤더를 마우스 오른쪽 단추로 클릭한 다음 목록 항목 추가를 클릭합니다. 예제에서 명령은 Add Song입니다.

   목록에 항목이 표시되며 새 이름이 적용되어 있는지 확인합니다.

6. 목록 항목 중 하나를 클릭하고 속성 창을 점검합니다. 목록 항목의 속성이 표시되어야 합니다.

7. 언어 탐색기를 엽니다. 내부에 목록 항목 노드가 포함된 컨테이너 노드가 표시되는지 확인합니다.

   

   구획 모양을 처음으로 테스트한 후에 일부 속성을 조정하고 몇 가지 고급 기능을 더 추가할 수 있습니다. 자세한 내용은 도메인 특정 언어 사용자 지정 및 확장을 참조하세요.

구획에 참조 링크 표시

일반적으로 구획에 표시하는 요소는 구획 모양으로 표시되는 요소의 자식입니다. 그러나 참조 관계를 통해 구획에 연결되는 요소를 표시하는 경우도 있습니다.

예를 들어 Album에 연결된 Artist 목록을 표시하는 두 번째 구획을 AlbumShape에 추가할 수 있습니다.

이 경우 구획에는 참조되는 요소가 아닌 링크가 표시되어야 합니다. 사용자가 구획에서 항목을 선택하고 DELETE 키를 누르면 참조되는 요소가 아닌 링크가 삭제되어야 하기 때문입니다.

참조되는 요소의 이름이 구획에 표시되도록 할 수도 있습니다.

다음 절차에서는 이 섹션 앞부분에서 설명한 대로 도메인 클래스, 참조 관계, 구획 모양 및 다이어그램 요소 맵을 이미 만들었다고 가정합니다.

구획에 참조 링크를 표시하려면

1. 구획 도형에 구획을 추가합니다. DSL 정의 다이어그램에서 구획 도형 클래스를 마우스 오른쪽 단추로 클릭하고 추가를 가리킨 다음 구획을 클릭합니다.

2. 대상 요소가 아닌 링크로 이동하도록 표시되는 요소 컬렉션 경로를 설정합니다. 드롭다운 메뉴를 클릭한 다음 트리 보기를 사용하여 대상이 아닌 참조 관계를 선택합니다. 이 예에서 해당 관계는 ArtistAppearedOnAlbums입니다.

3. 링크에서 대상 요소로 이동하도록 속성을 표시할 경로를 설정합니다. 이 예에서 대상 요소는 Artist입니다.

4. 표시 속성을 Name과 같은 대상 요소의 해당 속성으로 설정합니다.

5. 모든 템플릿 변환을 클릭하고 DSL을 빌드하고 실행한 다음 테스트 모델을 엽니다.

6. 모델 다이어그램에서 모양의 해당 클래스를 만들고 이름을 설정한 후에 클래스 간 링크를 만듭니다. 구획 모양에 연결된 요소의 이름이 표시됩니다.

7. 구획 모양에서 링크나 항목을 선택합니다. 링크와 항목이 모두 사라져야 합니다.

다른 도형의 경계에 있는 포트 정의

포트는 다른 모양의 경계에 있는 모양입니다.

포트를 사용하여 다른 모양에 고정 연결점을 제공할 수 있습니다. 사용자는 이 연결점에 연결선을 그릴 수 있습니다. 이 경우 포트 모양을 투명하게 지정할 수 있습니다.

포트를 사용하는 예를 확인하려면 새 DSL 솔루션을 만들 때 구성 요소 다이어그램 템플릿을 선택합니다. 이 예에서는 포트를 정의할 때 고려할 수 있는 주요 항목을 제시합니다.

• 포트의 컨테이너를 나타내는 Component 도메인 클래스가 있습니다.

• 포트를 나타내는 도메인 클래스가 있습니다. 이 예에서 해당 클래스는 ComponentPort입니다.

• 컨테이너 도메인 클래스에서 포트 도메인 클래스로의 포함 관계가 있습니다. 자세한 내용은 도메인 클래스 정의를 참조하세요.

• 같은 컨테이너에서 여러 포트 형식을 혼합하여 사용하려는 경우 포트 도메인 클래스의 서브클래스를 만들 수 있습니다. 이 예에서는 InPort 및 OutPort가 ComponentPort에서 상속합니다.

• 컨테이너 도메인 클래스를 모든 종류의 모양에 매핑할 수 있습니다. 이 예에서 해당 모양은 ComponentShape입니다. 자세한 내용은 도형 정의를 참조하세요.

• 포트 도메인 클래스는 포트 모양에 매핑됩니다. 파생 클래스의 개별 포트 모양 클래스에 매핑할 수도 있고 기본 클래스를 포트 모양 클래스에 매핑할 수도 있습니다.

  다른 측면에서 볼 때 포트 도형은 도형 정의에서 설명된 대로 작동합니다.

  자세한 내용은 포트 도형의 속성을 참조하세요.

스윔 레인이 있는 DSL 정의

스윔 레인은 다이어그램의 수평 또는 수직 파티션입니다. 각 스윔 레인은 모델 요소에 해당합니다. DSL 정의에서는 스윔 레인 요소당 도메인 클래스가 하나씩 있어야 합니다.

스윔 레인이 포함된 DSL을 만드는 가장 효율적인 방법은 새 DSL 솔루션을 만들고 작업 흐름 솔루션 템플릿을 선택하는 것입니다. DSL 정의에서 Actor 클래스는 스윔 레인에 매핑되는 도메인 클래스입니다. 이 클래스와 기타 클래스의 이름을 프로젝트에 맞게 바꿉니다.

스윔 레인 내에 모양으로 표시할 클래스를 추가하려면 스윔 레인 클래스와 새 클래스 간에 포함 관계를 만듭니다. 사용자는 스윔 레인 간에 요소를 끌 수 있지만 각 요소는 항상 특정 스윔 레인 내에 포함됩니다. 작업 흐름 솔루션 템플릿에서 FlowElement는 스윔 레인 클래스의 자식입니다.

스윔 레인과 독립적인 모양으로 표시할 클래스를 추가하려면 루트 클래스와 새 클래스 간에 포함 관계를 만듭니다. 사용자는 스윔 레인 경계와 외부를 비롯하여 다이어그램의 원하는 위치에 이러한 모양을 배치할 수 있습니다. 작업 흐름 솔루션 템플릿에서 Comment는 루트 클래스의 자식입니다.

자세한 내용은 스윔 레인의 속성을 참조하세요.

속성 형식 추가

도메인 열거형 및 리터럴

도메인 열거형은 여러 리터럴 값을 포함하는 형식입니다.

도메인 열거형을 추가하려면 DSL 탐색기에서 모델 루트를 마우스 오른쪽 단추로 클릭하고 새 도메인 열거형 추가를 클릭합니다. DSL 탐색기의 도메인 형식 노드에 요소가 표시됩니다. 다이어그램에는 이 요소가 표시되지 않습니다.

도메인 열거형에 열거형 리터럴을 추가하려면 DSL 탐색기에서 도메인 열거형을 마우스 오른쪽 단추로 클릭하고 새 열거형 리터럴 추가를 클릭합니다.

기본적으로 열거형 형식의 속성은 한 번에 하나의 열거형 값으로만 설정할 수 있습니다. 사용자와 프로그래머가 여러 값 조합("비트 필드")을 설정할 수 있도록 하려면 열거형의 IsFlags 속성을 설정합니다.

외부 형식

도메인 속성의 형식을 설정할 때 형식 드롭다운 목록에 원하는 형식이 없으면 외부 형식을 추가할 수 있습니다. 예를 들어 System.Drawing.Color 형식을 목록에 추가할 수 있습니다.

형식을 추가하려면 DSL 탐색기에서 모델 루트를 마우스 오른쪽 단추로 클릭하고 새 외부 형식 추가를 클릭합니다. 속성 창에서 이름을 Color로, 네임스페이스를 System.Drawing으로 설정합니다. 그러면 DSL 탐색기의 도메인 형식에 이 형식이 표시됩니다. 도메인 속성 형식을 설정할 때마다 이 형식을 선택할 수 있습니다.

DSL 사용자 지정

이 항목에서 설명하는 기술을 사용하면 다이어그램 표기법, 읽을 수 있는 XML 형식 및 코드와 기타 아티팩트를 생성하는 데 필요한 기본적인 도구를 사용해 DSL을 빠르게 만들 수 있습니다.

두 가지 방법으로 DSL 정의를 확장할 수 있습니다.

1. DSL 정의 기능을 추가로 사용해 DSL을 미세 조정합니다. 예를 들어 여러 연결선 형식을 만들 수 있는 단일 연결선 도구를 만들고, 특정 요소를 삭제하면 관련 요소도 삭제되는 규칙을 제어할 수 있습니다. 이러한 기술은 대부분 DSL 정의에서 값을 설정하는 방식으로 사용하지만 프로그램 코드를 몇 줄 작성해야 하는 기술도 있습니다.

   자세한 내용은 도메인 특정 언어 사용자 지정 및 확장을 참조하세요.

2. 보다 고급 효과를 적용하려면 프로그램 코드를 사용하여 모델링 도구를 확장합니다. 예를 들어 모델을 변경할 수 있는 메뉴 명령을 만들고, 둘 이상의 DSL을 통합하는 도구를 만들 수 있습니다. VMSDK는 DSL 정의에서 생성된 코드를 사용하여 확장을 쉽게 통합할 수 있도록 설계되었습니다. 자세한 내용은 도메인별 언어를 사용자 지정하는 코드 작성을 참조하세요.

DSL 정의 변경

DSL 정의에서 항목을 만들면 대부분의 기본값은 자동으로 설정됩니다. 설정된 기본값은 변경할 수 있습니다. 따라서 DSL 개발은 간소화하는 동시에 유용한 사용자 지정 기능을 추가할 수 있습니다.

예를 들어 모양을 요소에 매핑하면 도메인 클래스의 포함 관계에 따라 매핑의 부모 요소 경로가 자동으로 설정됩니다. 그러나 포함 관계를 나중에 변경하는 경우에는 부모 요소 경로가 자동으로 변경되지 않습니다.

그러므로 DSL 정의에서 일부 관계를 변경하는 경우 주의해야 합니다. 정의를 저장하거나 모든 템플릿 변환을 실행할 때 오류가 보고되는 경우가 있기 때문입니다. 이러한 오류는 대부분 쉽게 해결할 수 있습니다. 오류 보고서를 두 번 클릭하면 오류의 위치를 확인할 수 있습니다.

방법: 도메인 특정 언어의 네임스페이스 변경을 참조하세요.

문제 해결

아래 테이블에는 DSL을 디자인할 때 가장 흔히 발생하는 몇 가지 문제와 제안 해결 방법이 나와 있습니다. 시각화 도구 확장성 포럼에서 추가 조언을 사용할 수 있습니다.

문제	제안 해결 방법
DSL 정의 파일에서 수행한 변경 내용이 적용되지 않습니다.	솔루션 탐색기 위쪽의 도구 모음에서 모든 템플릿 변환을 클릭하고 솔루션을 다시 빌드합니다.
모양에 속성 값이 아닌 Decorator 이름이 표시됩니다.	Decorator 매핑을 설정합니다. 이렇게 하려면 DSL 정의 다이어그램에서 모양 클래스와 도메인 클래스 사이의 회색 선인 다이어그램 요소 맵을 클릭합니다. DSL 정보 창을 엽니다. 창이 표시되지 않으면 보기 메뉴에서 다른 창을 가리키고 DSL 정보를 클릭합니다. 데코레이터 맵 탭을 클릭합니다. 데코레이터의 이름을 선택합니다. 이름 옆의 확인란이 선택되어 있는지 확인합니다. 표시 속성에서 도메인 속성의 이름을 선택합니다. 자세한 내용은 다이어그램에 표시된 도형을 참조하세요.
DSL 탐색기에서 컬렉션에 항목을 추가할 수 없습니다. 예를 들어 도구를 마우스 오른쪽 단추로 클릭해도 메뉴에 "도구 추가" 명령이 표시되지 않습니다. DSL 탐색기에서 목록에 요소를 추가할 수 없습니다.	요소를 추가하려는 노드 위의 항목을 마우스 오른쪽 단추로 클릭합니다. 목록에 항목을 추가하려는 경우 추가 명령은 목록 노드가 아닌 해당 소유자에 있습니다.
도메인 클래스를 만들었는데 언어 탐색기에서 인스턴스를 만들 수 없습니다.	루트를 제외한 모든 도메인 클래스는 포함 관계의 대상이어야 합니다.
DSL 탐색기에는 요소와 형식 이름만 표시됩니다.	DSL 정의에서 클래스의 도메인 속성을 선택하고 속성 창에서 Is Element Name을 true로 설정합니다.
DSL이 항상 XML 편집기에서 열립니다.	파일을 읽는 동안 오류가 발생하면 이러한 현상이 발생할 수 있습니다. 그러나 해당 오류를 해결한 후에도 명시적으로 편집기를 DSL 디자이너로 다시 설정해야 합니다. 프로젝트 항목을 마우스 오른쪽 단추로 클릭하고 연결 프로그램을 클릭한 후에 YourLanguage디자이너(기본값)를 선택합니다.
어셈블리 이름을 변경한 후 DSL의 도구 상자가 표시되지 않습니다.	DslPackage\GeneratedCode\Package.tt를 검사하고 업데이트합니다. 자세한 내용은 방법: 도메인 특정 언어의 네임스페이스 변경을 참조하세요.
어셈블리 이름을 변경하지 않았는데 DSL의 도구 상자가 표시되지 않습니다. 또는 확장을 로드하지 못했음을 보고하는 메시지 상자가 표시됩니다.	실험적 인스턴스를 다시 설정하고 솔루션을 다시 빌드합니다. 1. Windows 시작 메뉴의 모든 프로그램에서 Visual Studio SDK, 도구를 차례로 확장하고 Microsoft Visual Studio 실험적 인스턴스 초기화를 클릭합니다. 2. 빌드 메뉴에서 솔루션 다시 빌드를 클릭합니다.

관련 콘텐츠

• 도메인별 언어 시작
• Windows Forms 기반 도메인별 언어 만들기
• WPF 기반 도메인별 언어 만들기