모든 가이드로 돌아가기
클래스 다이어그램··읽는 시간 6분

클래스 다이어그램 만들기: 실용 가이드

실제 주문 시스템 예시를 사용하여 클래스 다이어그램을 만드세요. 속성, 작업 및 관계를 추가한 다음 검토, 정렬, 내보내기 및 공유하세요.

유형이 지정된 속성, 작업, 연관 및 합성을 포함하는 Customer, Order 및 OrderItem 클래스 구획
이 가이드에서
  1. 모델이 답해야 할 질문으로 시작하세요.
  2. 시각적 작업 공간에서 클래스 다이어그램 생성
  3. 속성과 작업을 분리하십시오
  4. 책임을 연결하고 양쪽 끝을 읽으십시오.
  5. 레이아웃을 다듬기 전에 모델을 검토하세요.
  6. 독자가 읽기 쉬운 뷰 만들기
  7. 다음 단계를 위한 올바른 파일을 선택하세요.
  8. 참조 및 추가 자료

모델이 답해야 할 질문으로 시작하세요.

클래스 다이어그램은 시스템의 구조를 설명합니다: 포함된 객체의 종류, 보유한 정보, 노출하는 동작 등입니다. 구현 전에 책임과 계약을 논의하거나 기존 디자인을 설명하는 데 사용하세요. 이는 타입을 설명하며, order 471과 같은 개별 주문은 Order 클래스의 인스턴스가 됩니다.

이 가이드에서는 상점이 주문을 어떻게 표현하고 합계를 어떻게 계산하는지 물어보세요. Customer, Order, OrderItem으로 시작하세요. 배송, 할인, 재고는 첫 번째 스케치에서 제외하세요. 명시적인 결정이 포함된 작은 모델은 여러 관련 없는 관심사가 섞인 큰 다이어그램보다 검토하기 쉽습니다.

시각적 작업 공간에서 클래스 다이어그램 생성

클래스 다이어그램을 열고 주문 시스템 템플릿을 선택하여 편집 가능한 예시를 탐색하거나, 빈 다이어그램을 선택하여 모델을 직접 구축하세요. 라이브러리에서 분류자를 클릭하거나 캔버스로 드래그하세요. 애플리케이션의 어휘와 일치하는 단수형 이름을 사용하여 처음 세 클래스의 이름을 Customer, Order, OrderItem으로 지정하세요.

라이브러리는 클래스, 추상 클래스, 인터페이스 및 열거형을 제공합니다. 색상이 아닌 의미에 따라 종류를 선택하십시오. 인터페이스는 계약을 명시하고, 열거형은 명명된 값을 제공합니다. 사용자 정의 분류자(Custom classifier)는 스테레오타입 레이블을 추가하지만, 새로운 컴파일러 강제 유형 시스템이나 추가적인 UML 의미론을 도입하지는 않습니다.

클래스를 선택하여 인스펙터를 엽니다. 작은 화면에서는 '세부 정보 편집'을 통해 속성 패널로 이동하고 '다이어그램으로 돌아가기'를 통해 캔버스로 돌아갑니다. 클래스의 책임을 한 문장으로 설명할 수 있을 때만 클래스를 추가하세요.

속성과 작업을 분리하십시오

속성은 상태를 설명합니다. Order의 경우 number: String 및 total: Decimal을 사용하십시오. 연산은 클래스가 노출하는 동작(예: 품목 추가 또는 합계 계산)을 설명합니다. 다이어그램은 서명을 기록하며, 해당 연산을 실행하거나 구현을 생성하지 않습니다.

인스펙터에서 필드 모드는 가시성, 이름, 유형, 매개변수 및 반환 값을 입력하는 데 도움이 됩니다. 텍스트 모드는 표기법을 이미 알고 있을 때 유용합니다. 아래 예시에는 두 개의 비공개 속성과 두 개의 공개 작업이 있습니다. 속성 줄은 속성에, 작업 줄은 작업에 유지하세요.

Order 속성

- number: String
- total: Decimal

Order 작업

+ addItem(item: OrderItem): void
+ calculateTotal(): Decimal
  • +는 public, -는 private, #은 protected, ~는 package 가시성을 의미합니다.
  • 괄호는 연산과 속성을 구분하며, 반환 유형은 닫는 괄호 뒤에 옵니다.
  • OPEN, PAID, CANCELLED와 같은 값에는 열거형(Enumeration)을 사용하세요. 해당 속성 구획은 리터럴을 보유합니다.
  • 인식되지 않는 사용자 정의 표기법은 보존됩니다. 가이드 파서 및 검사(Checks)는 언어 컴파일러가 아닙니다.

책임을 연결하고 양쪽 끝을 읽으십시오.

Customer를 places라는 레이블이 지정된 연관 관계로 Order에 연결합니다. 고객이 여러 개의 주문을 가질 수 있고 각 주문에 정확히 한 명의 고객이 있는 경우, Customer 끝에 1을, Order 끝에 0..*을 배치합니다. 반대쪽 끝에 있는 하나의 인스턴스에 대한 해당 클래스의 인스턴스 수로 클래스 옆의 숫자를 읽습니다.

품목이 하나의 주문에 속하고 이 모델에서 독립적인 위치가 없는 경우에만 합성을 사용하여 Order를 OrderItem에 연결합니다. 채워진 다이아몬드는 전체인 Order 옆에 위치합니다. Order에는 1을 사용하고 OrderItem 범위를 신중하게 선택하십시오. 0..*은 빈 초안을 허용하는 반면, 1..*은 최소 하나 이상의 품목을 요구합니다. 이 선택은 스타일 선호도가 아니라 비즈니스 규칙입니다.

결제 동작이 중요하다면 Payable 인터페이스를 추가하고 구현 클래스에서 해당 인터페이스로의 실체화(realization)를 추가하세요. 점선은 계약 부분에서 빈 삼각형으로 끝납니다. 단순히 두 클래스에 이름이 같은 필드가 있다고 해서 상속을 사용하는 것은 피하세요.

레이아웃을 다듬기 전에 모델을 검토하세요.

검사(Checks)를 열어 멤버 표기법, 이름, 다중성 범위 및 구조적 관계를 검토하십시오. 결과를 선택하여 해당 클래스 또는 커넥터를 확인하십시오. 검사는 모델을 검사하는 데 도움이 되지만, 전체 계산, 소유권 규칙 또는 구현이 올바른지 증명할 수는 없습니다.

클래스 이름을 변경할 때, '참조와 함께 이름 바꾸기'는 인식된 속성 및 작업 유형 참조를 미리 보여줍니다. 제안된 변경 사항을 검토하고 어떤 참조가 새 이름을 따라야 하는지 선택하세요. 이는 관련 없는 텍스트를 바꾸지 않고도 모델 전체에서 유형 이름의 일관성을 유지하는 데 도움이 됩니다.

구체적인 시나리오를 살펴보세요: 고객이 임시 주문을 생성하고, 두 개의 항목을 추가하고, 합계를 요청합니다. 어떤 클래스가 각 상태 조각을 소유하고 어떤 작업이 각 작업을 담당하는지 물어보세요. 해결되지 않은 규칙은 모호한 커넥터 레이블 안에 숨기는 대신 노트에 넣으세요.

독자가 읽기 쉬운 뷰 만들기

정렬은 그래프와 표시된 크기를 사용하여 클래스를 구성합니다. 레이아웃은 선택된 정렬, 동일한 간격, 위치 잠금 및 선택 정렬을 제공합니다. 의도한 위치에는 잠금을 사용하고, 다른 클래스는 자유롭게 이동할 수 있도록 두십시오. 정렬은 위치와 연결 측면을 변경하며, 관계의 의미는 변경하지 않습니다.

보기(View)를 열어 전체 세부 정보, 속성만 또는 이름만을 선택하세요. 동일한 패널의 곡선(Curved) 및 꺾인 선(Elbow)은 문서 전체의 연결 스타일을 변경합니다. 자동 끝점은 개별 헤드를 한쪽에 고정할 때까지 이동된 클래스를 따릅니다. 찾기는 이름과 구성원을 검색하며, 구성원 결과는 관련 세부 정보를 보여줍니다.

시각적 그룹화를 위해 패키지를 사용한 다음, 검토 시 개요가 필요할 때 이를 축소하세요. 이 작업 공간의 패키지는 네임스페이스라기보다 시각적 그룹입니다. 노트는 클래스나 관계에 첨부할 수 있어 설명 연결선이 대상을 따라갑니다. 책임을 구분하기 위해 절제된 색상을 사용하고, 캔버스에 맞춘 후 가독성을 확인하세요.

다음 단계를 위한 올바른 파일을 선택하세요.

편집 가능한 클라우드 파일을 위해 로그인하고 저장하십시오. 공개 읽기 전용 링크를 공유하기 전에 최신 변경 사항을 저장하십시오. 새 다이어그램은 저장하거나 JSON을 다운로드할 때까지 메모리에 유지됩니다. 이미지는 편집 가능한 백업을 대체할 수 없습니다.

JSON 다운로드는 전체 문서를 보존합니다. 이미지 내보내기는 보고서나 프레젠테이션을 위해 PNG, JPEG, WebP, SVG 및 PDF를 제공하며, 표시되는 세부 정보 선택 사항이 이미지에 반영됩니다. 파일 → PlantUML 내보내기는 PlantUML 워크플로우를 위한 로컬 텍스트를 미리 보거나 복사하거나 다운로드합니다. PlantUML은 해당 텍스트를 독립적으로 배치하며, 이는 에디터 카메라 및 위치를 위한 왕복 형식이 아닙니다.

독자가 보게 될 규모로 모델을 확인하여 마무리하세요. 도면이 제안된 동작인지 구현된 동작인지 명시하고, 그 목적과 해결되지 않은 규칙을 클래스 다이어그램 가까이에 두세요. 정확한 제어 및 지원되는 구문은 아래 링크된 클래스 다이어그램 가이드를 참조하세요.

참조 및 추가 자료

클래스 다이어그램에서 모델을 사용해 보세요.

빈 모델로 시작하거나 주문 시스템 템플릿을 탐색하세요.

클래스 다이어그램 열기 →

클래스 다이어그램 가이드 읽기 →

추가 게시물