Archyno
UMLDiagramy správania

Ako nakresliť UML sekvenčný diagram

Jeden scenár, účastníci, ktorých sa naozaj dotkne, šťastná cesta v poradí, potom vetvenie - a tvrdý koniec na jednej obrazovke.

7 min čítaniaUML 2.5.110 z 35

Krátka odpoveď

  • Začnite jedným scenárom napísaným ako veta. Ak neviete jednou vetou pomenovať ten jeden priebeh, máte prípad použitia, nie sekvenčný diagram.
  • Účastníkov umiestnite zľava doprava v poradí, v akom sa ich tok prvýkrát dotkne, s aktérom vľavo. Čokoľvek iné zaručí kríženie šípok.
  • Kríženie šípok tu nie je otázka štýlu - robí poradie čítania naozaj nejednoznačným, a poradie je celý zmysel diagramu.
  • Jedna obrazovka, asi pätnásť správ. Za tým sa diagram roluje namiesto čítania a druhú polovicu má niesť fragment ref.
Raný UML sekvenčný diagram. Hosť odošle rezervačnú požiadavku na rezervačnú stránku, tá sa spýta služby dostupnosti, či je izba voľná, a potom zapíše rezerváciu do úložiska. Na každú správu prichádza odpoveď.
Po treťom kroku. Jeden scenár, priamo cez - a poradie je už usadené.

01Krok jeden a dva: jeden scenár, potom jeho účastníci#

Scenár napíšte ako vetu skôr, než čokoľvek nakreslíte."Hosť si rezervuje izbu, ktorá je voľná" je scenár. "Rezervovanie" nie je - je to prípad použitia, ktorý pokrýva každý priebeh vrátane tých neúspešných, a diagram, ktorý sa snaží byť nimi všetkými, je ten, čo skončí ako osemdesiat správ. Ak vaša veta obsahuje slovo "alebo", máte dva scenáre alebo jeden fragment alt, a mali by ste sa rozhodnúť ktorý, skôr než budete pokračovať.

Potom vypíšte účastníkov, ktorých sa ten scenár naozaj dotýka, a umiestnite ich zľava doprava v poradí, v akom sa k nim dostane. Aktér ide celkom vľavo. Štyria alebo piati sú pracovný rozsah; ak ich máte sedem, aspoň dvaja sú implementačné detaily, o ktorých tok neuvažuje, a ich zmazanie nestratí nič, čo by čitateľ potreboval.

02Krok tri: šťastná cesta, v poradí, a nič iné#

Nakreslite priebeh, kde všetko funguje, zhora nadol, bez jediného fragmentu. To je diagram v hlavičke vyššie a ako kus práce je hotový, aj keď ako diagram hotový nie je - poradie je usadené, a to je tá drahá časť.

Väčšinu významu nesú dve konvencie. Popiska správy je operácia so svojimi argumentmi, nie opis: isFree(dates, roomType)povie čitateľovi, čo musí príjemca ponúkať, kým "skontroluje dostupnosť" mu povie príbeh, ktorý už poznal. A každá odpoveď je čiarkovaná - plná šípka späť je druhé volanie a znamená niečo iné.

Aktivačné pásy sú v UML 2.5.1 voliteľné a oplatí sa ich kresliť. Sú jedinou vecou na diagrame, ktorá ukazuje, že synchrónne volanie blokuje svojho volajúceho po celú vnorenú výmenu pod ním, a to býva presne ten fakt, kvôli ktorému sa diagram kreslil.

03Kroky štyri a päť: vetvy a zastavenie#

Ten istý UML sekvenčný diagram po pridaní vetiev. Kontrola dostupnosti je zabalená vo fragmente alt: keď je izba voľná, stránka ju rezervuje a potvrdí; keď nie je, stránka si vypýta alternatívy a ponúkne ich namiesto toho. Blokácia platby sa asynchrónne vystrelí na auditný log.
Ten istý tok po štvrtom kroku. Alt je obalený okolo miesta, kde začne na odpovedi záležať.

Až teraz pridajte fragmenty, a pridávajte ich po jednom, pričom sa každého spýtate: mení táto vetva to, čo musí čitateľ postaviť? Vetva, ktorá vráti chybu a skončí, mení zriedkakedy a lepšie sa zaznamená v texte prípadu použitia. Vetva, ktorá robí inú prácu - ako ponúknutie náhradných termínov vyššie - mení vždy a na diagram patrí.

Rám obaľte okolo miesta, kde sa cesty rozchádzajú, nie okolo celého diagramu. alt vyššie začína po tom, ako sa vráti verdikt o dostupnosti, lebo všetko pred tým je obom výsledkom spoločné; rám okolo všetkých deviatich správ by bol technicky legálny a čitateľovi by o tom, kde je rozhodnutie, nepovedal nič.

Potom zastavte na jednej obrazovke. Toto nie je mäkké odporúčanie: sekvenčný diagram existuje preto, aby spravil poradie viditeľným na jeden pohľad, a diagram, ktorý treba scrollovať, sa toho vzdal a náklady si nechal. Keď sa tok nezmestí, rozdeľte ho na prirodzenom šve, pomenujte každú polovicu a z prvej odkážte na druhú fragmentom ref - alebo nad tú sadu nakreslite diagram prehľadu interakcií.

Po jednom riadku na každé

  1. 01Scenár najskôr napíšte ako vetu. Ak obsahuje 'alebo', rozhodnite sa medzi dvoma diagramami a jedným alt.
  2. 02Účastníci idú zľava doprava v poradí, v akom sa k nim tok dostane, aktér prvý.
  3. 03Šťastnú cestu kreslite bez fragmentov. Popisky sú operácie s argumentmi; každá odpoveď je čiarkovaná.
  4. 04Vetvu pridajte, len ak mení to, čo sa postaví, a rám obaľte v mieste, kde sa cesty rozchádzajú.
  5. 05Jedna obrazovka. Za tým rozdeľte a použite fragment ref.

Tri hotové toky na okopírovanie: vypracované príklady.

04Časté otázky#

Kde začať pri kreslení sekvenčného diagramu?

Jedným scenárom napísaným ako veta, nie boxami. Sekvenčný diagram opisuje jeden priebeh toku, takže ak neviete jednou vetou povedať ktorý, ešte nemáte diagram - máte prípad použitia, a to je iný obrázok.

V akom poradí umiestniť účastníkov?

Zľava doprava v poradí, v akom sa ich tok prvýkrát dotkne, s aktérom úplne vľavo. Čokoľvek iné zaručí kríženie šípok, a kríženie šípok v sekvenčnom diagrame nie je otázka štýlu: robí poradie čítania naozaj nejednoznačným.

Aký dlhý môže byť sekvenčný diagram?

Jedna obrazovka, teda asi pätnásť správ. Za touto hranicou sa diagram už nečíta zhora nadol, ale roluje, a poradie, ktoré bolo celým dôvodom kreslenia, prestane byť viditeľné. Rozdeľte ho a na druhú polovicu odkážte fragmentom ref.

V tejto sérii

Súvisiace články

Všetky články