DSL 코드 이해

ConnectionBuilders.cs

연결 작성기는 관계를 만드는 클래스로, 연결 도구를 작동하게 만드는 코드입니다. 이 파일에는 각 연결 도구의 클래스 쌍이 포함됩니다. 해당 클래스의 이름은 도메인 관계와 연결 도구의 이름에서 파생됩니다(RelationshipBuilder 및 ConnectorToolConnectAction).

구성 요소 솔루션 예제에서는 연결 작성기 중 하나의 이름이 ConnectionBuilder입니다. 도메인 관계의 이름이 Connection이므로 이는 우연의 일치입니다.

관계는 RelationshipBuilder.Connect() 메서드에서 작성됩니다. 기본 버전은 소스 및 대상 모델 요소가 적절한지 확인한 다음 관계를 인스턴스화합니다. 예를 들면 다음과 같습니다.

CommentReferencesSubject(sourceAccepted, targetAccepted);

각 작성기 클래스는 DSL 탐색기 연결 작성기 섹션의 노드에서 생성됩니다. Connect 메서드 하나가 도메인 클래스 쌍 하나 이상 간의 관계를 만들 수 있습니다. 각 쌍은 DSL 탐색기의 작성기 노드에서 확인할 수 있는 링크 연결 지시문을 통해 정의됩니다.

예를 들어 샘플 DSL의 3가지 관계 형식에 대해 각각 연결 작성기 링크 연결 지시문을 하나씩 추가할 수 있습니다. 그러면 사용자에게 연결 도구 하나가 제공됩니다. 인스턴스화되는 관계 형식은 사용자가 선택한 소스 및 대상 요소의 형식에 따라 달라집니다. 링크 연결 지시문을 추가하려면 DSL 탐색기에서 작성기를 마우스 오른쪽 단추로 클릭합니다.

특정 도메인 관계 형식을 만들 때 실행되는 사용자 지정 코드를 작성하려면 작성기 노드에서 해당하는 링크 연결 지시문을 선택합니다. 속성 창에서Uses Custom Connect를 설정합니다. 솔루션을 다시 작성하고 코드를 입력하여 발생하는 오류를 해결합니다.

사용자가 이 연결 도구를 사용할 때마다 실행되는 사용자 지정 코드를 작성하려면 연결 작성기의 Is Custom 속성을 설정합니다. 소스 요소 허용 여부, 특정 소스 및 대상 조합 허용 여부 그리고 연결 설정 시 모델에 대해 수행해야 하는 업데이트를 결정하는 코드를 입력할 수 있습니다. 예를 들어 다이어그램에서 루프를 만들지 않는 경우에만 연결을 허용할 수 있습니다. 단일 관계 링크 대신 소스와 대상 간에 서로 관련된 여러 요소의 보다 복잡한 패턴을 인스턴스화할 수 있습니다.

Diagram.cs

다이어그램을 정의하는 클래스를 포함하며, Diagram에서 파생됩니다.

런타임에 색 및 기타 일부 스타일 기능을 변경할 수 있도록 하려면 DSL 정의 다이어그램에서 클래스를 마우스 오른쪽 단추로 클릭하고 Add Exposed를 가리킵니다.

이 파일은 모델에 새 요소를 추가할 때 응답하는 FixupDiagram 규칙도 포함합니다. 해당 규칙은 새 모양을 추가하고 모델 요소에 모양을 연결합니다.

DomainClasses.cs

추상 클래스 및 모델 루트 클래스를 비롯하여 정의된 도메인 클래스의 구현으로, ModelElement에서 파생됩니다.

각 도메인 클래스는 다음 항목을 포함합니다.

• 각 도메인 속성에 대한 속성 정의 및 중첩 처리기 클래스. OnValueChanging() 및 OnValueChanged()를 재정의할 수 있습니다. 자세한 내용은 도메인 속성 값 변경 처리기을 참조하십시오.

  예제 DSL에서 Comment 클래스에는 Text 속성과 TextPropertyHandler 처리기 클래스가 포함되어 있습니다.

• 이 도메인 클래스가 참가하는 관계의 접근자 속성입니다. 역할 속성에 대한 중첩 클래스는 없습니다.

  예제 DSL에서 Comment 클래스에는 포함 관계 ComponentModelHasComments를 통해 부모 모델에 액세스하는 접근자가 있습니다.

• 생성자. 이러한 항목을 재정의하려면 도메인 클래스에 대해 Has Custom Constructor를 설정합니다.

• EGP(Element Group Prototype) 처리기 메서드. 사용자가 이 클래스 인스턴스에 다른 요소를 병합(추가)할 수 있는 경우 이러한 메서드가 필요합니다. 사용자는 일반적으로 요소 도구나 다른 모양에서 끌기 또는 붙여넣기를 통해 이 작업을 수행합니다.

  예제 DSL에서는 Input Port 또는 Output Port를 Component에 병합할 수 있습니다. 또한 Component와 Comment를 모델에 병합할 수도 있습니다. Component

  클래스의 EGP 처리기 메서드를 사용하면 Component가 Port는 수락하되 Comment는 수락하지 않도록 지정할 수 있습니다. 루트 모델 클래스의 EGP 처리기는 Comment와 Component는 수락하지만 Port는 수락하지 않습니다.

DomainModelResx.resx

이 파일에는 도메인 클래스와 속성의 설명, 속성 이름, 도구 상자 레이블, 표준 오류 메시지, 사용자에게 표시될 수 있는 기타 문자열 등의 문자열이 포함됩니다. 또한 이미지 모양의 이미지와 도구 아이콘도 포함됩니다.

이 파일은 작성된 어셈블리로 바인딩되며 이러한 리소스의 기본값을 제공합니다. 리소스의 지역화된 버전을 포함하는 위성 어셈블리를 만들어 DSL을 지역화할 수 있습니다. 해당 버전은 지역화된 리소스와 일치하는 문화권에서 DSL을 설치할 때 사용됩니다. 자세한 내용은 Deploying Domain-Specific Language Solutions을 참조하십시오.

HelpKeywordHelper.cs

사용자가 F1 키를 누르면 사용되는 기능을 제공합니다.

PropertiesGrid.cs

이 파일은 도메인 속성에 사용자 지정 형식 설명자를 연결한 경우에만 코드를 포함합니다. 자세한 내용은 Customizing the Properties Window을 참조하십시오.

Serializer.cs

각 도메인 클래스, 관계, 모양, 연결선, 다이어그램 및 모델의 serializer 클래스입니다.

이러한 클래스의 기능 대부분은 DSL 탐색기의 Xml Serialization 동작 아래 설정을 통해 제어할 수 있습니다.

ToolboxHelper.cs

요소 도구에 요소 그룹 프로토타입을 설치하여 도구 상자를 설정합니다. 사용자가 도구를 실행하면 이러한 프로토타입의 복사본이 대상 요소와 병합됩니다.

CreateElementPrototype()을 재정의하여 여러 개체의 그룹을 만드는 도구 상자 항목을 정의할 수 있습니다. 예를 들어 하위 구성 요소가 포함된 개체를 나타내는 항목을 정의할 수 있습니다. 코드를 변경한 후에는 실험적 Visual Studio 인스턴스를 다시 설정하여 도구 상자 캐시를 지웁니다.

Constants.cs

GUID입니다.

DocView.cs

YourDslDocView는 다이어그램이 표시되는 창을 관리합니다. 예를 들어 Windows Form 내부에 다이어그램을 포함할 수 있습니다.

DslPackage 프로젝트에 사용자 정의 컨트롤 파일, 다이어그램을 표시할 수 있는 패널 그리고 단추 및 기타 컨트롤을 추가합니다. 이렇게 하려면 Form의 코드 보기에서 다음 코드를 추가하고 DSL에 맞게 이름을 조정합니다.

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Linq;
using System.Text;
using System.Windows.Forms;
using Microsoft.VisualStudio.Modeling;
using Microsoft.VisualStudio.Modeling.Shell;
namespace Company.EmbedInForm
{
  public partial class UserControl1 : UserControl
  {
    public UserControl1()
    {
      InitializeComponent();
    }
    
    private DiagramDocView docView;
    public UserControl1(DiagramDocView docView, Control content)
      : this()
    {
      this.docView = docView;
      panel1.Controls.Add(content);
    }
    private void button1_Click(object sender, EventArgs e)
    {
      ExampleModel modelRoot = this.docView.CurrentDiagram.ModelElement as ExampleModel;
      foreach (ExampleElement element in modelRoot.Elements)
      {
       listBox1.Items.Add(element.Name);
      }
    }
  }
  internal partial class EmbedInFormDocView
  {
    private ContainerControl container;
    /// <summary>
    /// Return a User Control instead of the DSL window. 
    /// The user control will contain the DSL window.
    /// </summary>
    public override System.Windows.Forms.IWin32Window Window
    {
      get
      {
        if (container == null)
        {
          // Put the normal DSL Window inside our control
          container = new UserControl1(this, (Control)base.Window);
        }
        return container;
      }
    }
  }
}

GeneratedVSCT.vsct

다이어그램 컨텍스트 메뉴, 편집 메뉴 등 메뉴의 표준 메뉴 명령을 찾습니다. 명령의 코드는 CommandSet.cs에 있습니다. 표준 명령을 다시 배치하거나 수정할 수 있으며 원하는 명령을 추가할 수도 있습니다. 자세한 내용은 사용자 명령 및 작업 작성을 참조하십시오.

ModelExplorerToolWindow.cs

모델 탐색기가 표시되는 창을 정의하고 탐색기의 항목 선택을 처리합니다.

Source.extension.vsixmanifest

이 파일을 사용자 지정하려면 .tt 파일을 편집합니다.

이 파일은 DSL을 VSIX(Visual Studio Integration Extension)로 패키징하는 방식을 제어합니다. 자세한 내용은 Deploying Domain-Specific Language Solutions을 참조하십시오.