순서 그림

순서 그림은 같은 카드를 순서 보기(view sequence)로 보이는 그림입니다. 참여자 사이에 메시지가 오가는 순서를 그립니다. 인증 절차, API 호출 순서처럼 위에서 아래로 읽는 그림에 씁니다.

최소 예제

참여자 카드를 먼저 선언하고, 순서 보기 블록에 참여자 순서를 적습니다. 메시지는 장면 안에만 적고, 메시지 순서가 곧 그림의 위아래 순서입니다. 순서 보기는 문서 안 모든 장면의 메시지를 한 열에 놓습니다. 탭은 그 가운데 어느 장면을 재생할지 고릅니다.

문법

줄 종류와 선택 사항은 그림 문법의 문법 표가 정본이고, 순서 보기의 줄은 카드와 보기에 있습니다. 순서 보기의 참여자는 person, box, external, store, queue이고, 테이블, API, 클래스는 칸과 멤버 없이 카드 머리만 참여자로 보입니다.

장면과 움직임

한 줄이 한 박자이고 한 행입니다. 점이 화살표를 따라 한 번 지나가며, dashed는 응답을 뜻하는 점선입니다. a -> a는 자기 자신에게 보내는 메시지로 오른쪽으로 돌아 나옵니다. note는 바로 앞 메시지의 보내는 쪽이나 받는 쪽 참여자 옆에 붙는 메모이고 박자를 만들지 않습니다. 메시지 글은 필수이고, 같은 두 참여자 사이 같은 방향 메시지를 여러 번 적어도 됩니다. activate, deactivate는 메시지 바로 뒤에서 활성 구간을 열고 닫으며, create와 destroy를 메시지에 붙이면 받는 참여자의 생명선이 시작되거나 끝납니다.

조건·반복·병렬 구획

fragment alt "재고" choose="있음" {으로 재생할 대안을 고르고, 그 안에 branch "있음" {과 branch "없음" { 블록을 적습니다. 모든 대안을 그리지만 선택한 대안만 움직입니다. choose는 실제 조건식 평가가 아니라 재생 경로를 정하는 값입니다.

fragment loop "재시도" times=3 { 안의 메시지는 같은 선에서 세 번 재생합니다. fragment par "조회" {의 여러 branch는 동시에 시작해 각자 진행하고 모두 끝나면 다음 메시지로 넘어갑니다. fragment opt "추가 인증" run=on {은 본문을 한 번 재생하고 run=off는 대기까지 모두 생략하며 제목에 표시합니다. 각 블록은 {로 열고 별도 줄의 }로 닫습니다. 구획을 중첩할 수 있고, 본문에는 메시지, 메모, 대기를 넣습니다. 생성, 소멸, 활성 구간은 구획 밖에 적습니다. 생성과 소멸은 장면마다 따로 효력이 있어서, 한 장면의 소멸이 다른 장면의 생명선을 자르지 않고 같은 참여자를 둘 이상의 장면이 만들 수도 있습니다. 네 구획과 생명주기를 모두 담은 sequence 예제를 장면별로 재생해 볼 수 있습니다. 전체 계약과 제한은 시퀀스 제어 구획에 있습니다.

흔한 오류

code는 thinkflow check figure.thinkflow --json으로 봅니다. 그림 검사 항목은 그림 검사에 있습니다.