방법: UML 클래스 다이어그램에서 코드 생성
Visual Studio Ultimate 사용 하 여 UML 클래스 다이어그램에서 코드 생성은 코드 생성 명령. 기본적으로 명령은 C# 형식을 선택 하 여 각 UML 형식에 대해 생성 됩니다.코드를 생성하는 텍스트 템플릿을 수정하거나 복사하여 이 동작을 수정하고 확장할 수 있습니다.모델의 여러 패키지에 포함된 형식에 대해 각기 다른 동작을 지정할 수 있습니다.
코드 생성 명령은 사용자가 선택한 요소에서 코드를 생성하고 각 UML 클래스 또는 다른 요소에 대해 하나의 파일을 생성하는 데 특히 적합합니다.예를 들어 다음 스크린 샷에서는 두 가지 UML 클래스에서 생성된 두 개의 C# 파일을 보여 줍니다.
또는 생성된 파일이 UML 요소와 1:1 관계가 아닌 코드를 생성하려면 모든 템플릿 변환 명령을 사용하여 호출된 텍스트 템플릿을 작성하는 것을 고려할 수도 있습니다.이 방법에 대한 자세한 내용은 방법: UML 모델에서 파일 생성을 참조하십시오.
.png "UML 클래스 다이어그램 및 생성된 C# 클래스 파일")
Visual Studio Ultimate의 UML 클래스 다이어그램에 대한 자세한 내용은 다음 항목을 참조하십시오.
코드 생성 명령 사용
다음 절차에서는 코드 생성 명령의 기본 동작에 대해 설명합니다.
각 요소에 대해 별도의 파일을 생성하려면
클래스가 포함된 UML 모델을 만듭니다.모델 요소에 스테레오타입을 적용할 수도 있습니다.
자세한 내용은 기본 코드 생성 변환을 참조하십시오.
클래스 다이어그램이나 UML 모델 탐색기에서 코드를 생성할 요소를 선택합니다.다음 중 하나를 선택할 수 있습니다.
특정 요소 집합
코드를 생성할 내용이 포함된 패키지 또는 모델
모든 요소를 선택할 다이어그램
선택된 된 요소에 대한 바로 가기 메뉴를 열고 선택 코드 생성.
특정 모델에서 코드 생성을 처음 사용할 때 대화 상자가 나타납니다.이 대화 상자에서 모델의 코드 생성 매개 변수를 편집할 수 있습니다.
선택 확인 사용 하지 않는 이러한 매개 변수를 변경 하려는 것입니다.
나중에이 대화 상자로 돌아가려면 하려면 다이어그램 바로 가기 메뉴를 열고 선택한 기본 코드 생성 설정 구성.자세한 내용은 코드 생성 명령 사용자 지정을 참조하십시오.
C# 코드가 포함된 파일이 생성됩니다.기본적인 경우에 형식마다 파일이 하나씩 생성되며 이러한 파일은 C# 클래스 라이브러리 프로젝트에서 생성됩니다.그러나 이 동작을 사용자 지정할 수 있습니다.자세한 내용은 코드 생성 명령 사용자 지정을 참조하십시오.
모델이 C#으로 변환될 수 있는지 확인하기 위해 모델에 적용되는 유효성 검사 테스트가 있습니다.이러한 테스트가 실패하면 오류 메시지가 표시되고 코드가 생성되지 않습니다.유효성 검사 메뉴 명령을 만든 경우 유효성 검사 명령이 실패하는 모든 요소에 대해 코드가 생성되지 않습니다.자세한 내용은 방법: UML 모델에 대한 유효성 검사 제약 조건 정의을 참조하십시오.
기본 코드 생성 변환
이 단원에서는 코드 생성 명령을 사용자 지정하지 않은 경우 이 명령으로 생성되는 결과를 요약하여 설명합니다.자세한 내용은 코드 생성 명령 사용자 지정을 참조하십시오.
UML 모델에서 선택한 형식마다 C# 형식이 하나씩 생성됩니다.각 형식은 GeneratedCode 폴더에 있는 별도의 코드 파일에 배치됩니다.
UML 형식이 패키지에 포함된 경우 생성된 C# 형식은 네임스페이스 안에 배치되고 네임스페이스와 이름이 동일한 폴더에 파일이 생성됩니다.
UML 클래스의 Attribute마다 C# 속성이 하나씩 생성됩니다.
UML 형식의 Operation마다 C# 메서드가 하나씩 생성됩니다.
클래스가 참여하는 탐색 가능한 연결마다 C# 필드가 하나씩 생성됩니다.
각 UML 형식에 스테레오타입을 추가하여 생성된 C# 형식의 보다 많은 속성을 제어할 수 있습니다.
만들 C# 형식 |
그릴 UML 형식 |
적용할 스테레오타입 |
|---|---|---|
클래스 |
클래스 |
<none> 또는 C# class |
Interface |
Interface |
<none> 또는 C# interface |
열거형 |
열거형 |
<none> 또는 C# enum |
대리자 |
클래스 |
C# delegate |
구조체 |
클래스 |
C# struct |
형식 또는 기타 요소에 대해 스테레오타입을 설정하려면
요소 또는 다이어그램에 대한 바로 가기 메뉴를 열고 UML 모델 탐색기, 다음을 선택 하 고 속성.
에 속성 창에서 드롭다운 화살표를 선택의 타입 다음 적용할 스테레오 타입에 대한 확인란을 선택 하 고 속성을.
.gif "팁")
팁C# 스테레오타입이 나타나지 않으면 모델이나 관심이 있는 모델 요소를 포함하는 패키지에 대한 C# 프로필을 사용하도록 설정합니다.UML 모델 탐색기에서 패키지나 모델의 루트를 선택한 다음다음에 속성 창에서 선택 프로필, 다음 C# 프로 파일을 사용 합니다.
스테레오타입 속성을 확장하여 설정할 수 있는 추가 속성을 확인합니다.
형식, 특성, 작업 및 연결의 Description 속성은 생성된 코드에서 <summary> 주석에 기록됩니다.형식에 연결된 주석 요소는 <remarks> 주석에 기록됩니다.
생성된 코드 변경
생성된 코드는 각 형식, 특성 또는 작업의 속성에 따라 달라집니다.예를 들어 클래스의 Is Abstract 속성을 true로 설정하면 abstract 키워드가 생성된 클래스에 나타납니다.특성의 Multiplicity를 **0..***로 설정하면 생성된 속성의 형식이 IEnumerable<>이 됩니다.
또한 각 스테레오타입은 설정할 수 있는 몇 가지 추가 속성을 제공합니다.이러한 값은 C# 코드에서 적절한 키워드로 변환됩니다.예를 들어 클래스에서 Is Static 속성을 설정하면 C# 클래스가 static이 됩니다.
이러한 추가 속성을 설정하려면 다이어그램에서 클래스나 다른 요소를 선택합니다.속성 창에서 스테레오타입을 확장한 다음 C# Class와 같은 C# 스테레오타입을 확장합니다.클래스의 경우 다음과 같은 추가 속성이 포함됩니다.
CLR Attributes
Is Partial
Is Static
Is Unsafe
Package Visibility
각 특성과 작업에는 설정할 수 있는 스테레오타입 속성도 있습니다.새 특성에 대한 속성이 표시되지 않으면 코드 생성을 실행합니다.
코드 생성 명령 사용자 지정
코드 생성 명령은 텍스트 템플릿 집합을 통해 모델 요소를 변환하여 작동합니다.텍스트 템플릿에 대한 자세한 내용은 코드 생성 및 T4 텍스트 템플릿을 참조하십시오.
템플릿은 text template bindings(텍스트 템플릿 바인딩)의 집합에 지정됩니다.텍스트 템플릿 바인딩은 적용해야 하는 템플릿, 생성된 출력이 배치되어야 하는 위치 및 코드 생성 명령의 다른 매개 변수를 지정합니다.
특정 모델에 대해 코드 생성 명령을 처음 실행하면 템플릿 바인딩의 기본 집합이 모델의 루트에 연결됩니다.이러한 바인딩은 모델의 모든 요소에 적용됩니다.
그러나 사용자 고유의 바인딩을 패키지, 클래스 또는 다른 요소에 연결하여 이러한 기본 바인딩을 재정의하거나 기본 바인딩에 추가할 수 있습니다.바인딩은 바인딩이 연결된 요소에 포함된 모든 요소에 적용됩니다.예를 들어 특정 패키지 내의 모든 형식이 다른 템플릿 집합에 의해 변환되거나 다른 폴더에 출력되도록 하려는 경우 템플릿 바인딩을 패키지에 연결할 수 있습니다.
모델 요소에 연결 하는 템플릿 바인딩을 검사 하려면 줄임표를 선택 [...] 에 있는 텍스트 템플릿 바인딩 을 속성 창에서 속성.
코드 생성 명령은 선택한 각 모델 요소에 템플릿을 적용합니다.각 요소의 경우 적용된 템플릿 집합은 모델의 루트를 포함하여 모델의 루트까지 존재하는 요소의 컨테이너에 연결된 템플릿의 결합된 집합입니다.
이 집합에 있는 두 템플릿 바인딩의 이름이 동일한 경우 더 작은 컨테이너의 바인딩이 더 큰 컨테이너의 바인딩보다 우선합니다.예를 들어 모델 루트에 이름이 Class Template인 바인딩이 있는 경우사용자 고유의 템플릿이 특정 패키지의 내용에 적용되도록 하려면 이름이 Class Template인 사용자 고유의 템플릿 바인딩을 정의합니다.
둘 이상의 템플릿을 모델 요소에 적용할 수 있습니다.각 모델 요소에서 둘 이상의 파일을 생성할 수 있습니다.
[!참고]
모델의 루트에 연결된 바인딩은 모델의 모든 요소에 대한 기본값으로 작동합니다.이러한 기본 바인딩을 보려면 다이어그램 화면에서 바로 가기 메뉴를 열고 선택한 를 구성 하는 기본 코드 생성 설정.UML 모델 탐색기에서 모델의 루트를 선택 하 고 선택 또는 [...] 에 있는 텍스트 템플릿 바인딩 을 속성입니다.코드 생성 명령을 한 번 이상 사용할 때까지는 바인딩이 나타나지 않습니다.템플릿 바인딩은 다이어그램에 연결할 수 없습니다.
텍스트 템플릿 바인딩을 패키지 또는 다른 모델 요소에 연결하려면
UML 모델 탐색기모델 요소에 대한 바로 가기 메뉴를 열고 선택 속성.일반적으로 패키지나 모델의 루트에 텍스트 템플릿 바인딩을 연결합니다.
에 속성 창에서 줄임표 단추 ([...])에 있는 텍스트 템플릿 바인딩 을 속성입니다.
Text Template Bindings(텍스트 템플릿 바인딩) 대화 상자가 나타납니다.
선택 추가 새 텍스트 템플릿 바인딩을 만들 수 있습니다.
-또는-
기존 바인딩을 편집 하려면 선택 합니다.
각 템플릿 바인딩은 선택한 모델 요소에 지정된 템플릿을 적용해야 하는 방법과 포함된 다른 모델 요소를 정의합니다.
대화 상자에서 텍스트 템플릿 바인딩의 속성을 설정합니다.
속성
설명
이름
이 바인딩의 이름입니다.포함하는 패키지 또는 모델에서 상속한 바인딩을 재정의하려면 재정의할 바인딩과 동일한 이름을 사용합니다.
덮어쓰기
true이면 모든 기존 코드를 덮어씁니다.
대상 이름
생성된 파일의 이름입니다.
{Name} 또는 {Owner.Name}과 같은 식을 이 문자열에 삽입할 수 있습니다.예를 들어 {Owner.Name}_{Name}과 같이 작성할 수 있습니다.식은 모델 요소에 대해 평가됩니다.식에서는 요소의 속성을 사용할 수 있지만 메서드의 속성은 사용할 수 없습니다.사용할 수 있는 속성을 찾으려면 Microsoft.VisualStudio.Uml.*에서 형식의 속성을 확인하십시오.
.gif "중요")
중요
{Name} 또는 {Owner.Name}은 대상 이름 속성에서만 사용할 수 있습니다.생성된 클래스의 이름을 변경하려면 템플릿을 수정해야 합니다.자세한 내용은 텍스트 템플릿 작성을 참조하십시오.프로젝트 경로
변환의 출력 파일을 포함할 Visual Studio 프로젝트의 경로를 지정합니다.새 프로젝트를 만들려면 형식화된 값을 사용하고,줄임표 단추 ([...])는 기존 프로젝트를 선택 합니다.
새 프로젝트가 없는 경우 만들어지며,C# 클래스 라이브러리 프로젝트가 됩니다.
이렇게 하려면 프로젝트를 직접 입력해야 합니다.%ProgramFiles% 또는 %LocalAppData%와 같은 환경 변수 매크로를 포함할 수 있습니다.
대상 디렉터리
대상 파일이 생성된 폴더입니다.경로는 프로젝트 폴더에 상대적입니다.
{PackageStructure} 식을 사용하여 포함하는 패키지의 이름에 해당하는 경로를 삽입할 수 있습니다.기본값은 \GeneratedCode\{PackageStructure}입니다.%TEMP% 또는 %HomePath%와 같은 환경 변수도 포함할 수 있습니다.
중요
{PackageStructure}는 대상 디렉터리 속성에서만 사용할 수 있습니다.템플릿 파일 경로
변환을 수행할 템플릿입니다.
제공된 템플릿을 사용하거나 사용자 고유의 템플릿을 만들 수 있습니다.제공 된 템플릿을 다음 위치에서 찾을 수 있습니다.
상자 Visual Studio 11.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\Extensibility\Templates\Text\...\Program
바인딩을 원하는 만큼 요소에 연결할 수 있습니다.
텍스트 템플릿 작성
사용자 고유의 텍스트 템플릿을 작성할 수 있습니다.텍스트 템플릿은 프로그램 코드나 다른 모든 종류의 텍스트 파일을 생성할 수 있습니다.
표준 템플릿의 복사본을 수정하여 시작하는 것이 좋습니다.다음 위치에서 템플릿을 복사할 수 있습니다.
상자 Visual Studio 11.0\Common7\IDE\Extensions\Microsoft\Architecture Tools\Extensibility\Templates\Text\...\Program
텍스트 템플릿을 이해하려면 다음 항목을 참조하십시오.
텍스트 템플릿은 결과 파일의 프로토타입이며 결과 텍스트와 모델을 읽는 프로그램 코드를 둘 다 포함합니다.자세한 내용은 코드 생성 및 T4 텍스트 템플릿을 참조하십시오.
프로그램 코드에서 UML 모델을 탐색하려면 UML API를 사용해야 합니다.자세한 내용은 방법: UML 모델 탐색 및 UML 모델링 확장성을 위한 API 참조을 참조하십시오.
코드 생성 명령과 함께 템플릿을 사용하려면 Modeling 지시문을 포함해야 합니다.예를 들면 다음과 같습니다.
<#@ Modeling ElementType="Microsoft.VisualStudio.Uml.Classes.IClass" Processor="ModelingProcessor" #>
ElementType 특성은 이 템플릿이 적용되는 UML 요소의 형식을 정의합니다.
템플릿에서 this는 다음 속성이 있는 임시 클래스에 속합니다.
Element = 템플릿이 적용될 UML IElement
Errors: CompilerErrorCollection
ModelBus: ModelBus.자세한 내용은 방법: UML 모델을 다른 모델 및 도구와 통합을 참조하십시오.
ProfileName = "C#Profile"
ServiceProvider: IServiceProvider
Session: TextTemplatingSession.
Store: Store.UML ModelStore가 구현되는 시각화 및 모델링 SDK 저장소입니다.UML IModelStore를 가져오려면 this.Element.GetModelStore()를 사용합니다.
텍스트 템플릿을 작성하는 동안 다음 사항을 참고하면 도움이 될 수 있습니다.이 정보는 코드 생성 및 T4 텍스트 템플릿에 자세히 설명되어 있습니다.
Output 지시문에서 결과의 파일 확장명을 설정할 수 있습니다.각 텍스트 템플릿에는 Output 지시문이 하나씩 필요합니다.
일부 어셈블리는 템플릿에서 자동으로 참조됩니다.이러한 어셈블리에는 System.dll, Microsoft.VisualStudio.Uml.Interfaces.dll 등이 있습니다.
생성하는 프로그램 코드에서 다른 어셈블리를 사용하려면 Assembly 지시문을 사용해야 합니다.예를 들면 다음과 같습니다.
<#@ Assembly Name="%ProgramFiles%\Microsoft Visual Studio 11.0\Common7\IDE\PublicAssemblies\Microsoft.VisualStudio.ArchitectureTools.Extensibility.dll" #>
System과 같은 일부 네임스페이스를 프로그램 코드에 자동으로 가져올 수 있습니다.다른 네임스페이스의 경우 using 문을 사용할 때와 같은 방식으로 Import 지시문을 사용할 수 있습니다.예를 들면 다음과 같습니다.
<#@ Import Namespace="Microsoft.VisualStudio.Uml.Classes" #>
<#@ Import Namespace="Microsoft.VisualStudio.ArchitectureTools.Extensibility.Uml" #>
Include 지시문을 사용하여 다른 파일의 텍스트를 참조할 수 있습니다.
꺾쇠 괄호로 묶인 템플릿의 부분(<# ... #>)이 코드 생성 명령으로 실행됩니다.이러한 꺾쇠 괄호 밖에 있는 템플릿의 부분은 결과 파일에 복사됩니다.생성하는 코드와 생성된 텍스트를 구별할 수 있어야 합니다.텍스트는 어떠한 언어로도 생성될 수 있습니다.
<#= Expressions #>은 평가되고 문자열로 변환됩니다.