UML sekvenčné diagramy

Sekvenčný diagram presne odpovedá na jednu otázku: čo sa deje, v akom poradí a medzi kým. Je to diagram, ktorý nakreslíte, keď sa dvaja ľudia nezhodnú, ktorá služba volá ktorú, alebo keď tok prechádza štyrmi systémami a nikto nemá celú cestu v hlave.

Všetku prácu urobí rozloženie. Účastníci sedia pozdĺž horného okraja. Čas beží nadol - nie zľava doprava a nie v mierke. Správa nižšie na stránke nastane po správe vyššie na stránke, a to je celé pravidlo čítania.

Tri kusy nábytku, a všetko ostatné je ich obmena.

Čiara života je hlavička hore plus prerušovaná zvislá čiara, ktorá z nej beží nadol. Hlavička pomenúva účastníka. Môže to byť názov triedy, objekt (: Checkout), aktér nakreslený ako panáčik alebo rola so stereotypom ako «boundary» či «control». Čokoľvek si vyberiete, buďte konzistentní po celom diagrame.

Aktivačný pruh - niekedy nazývaný výskyt vykonávania - je tenký obdĺžnik položený na čiare života. Označuje obdobie, počas ktorého ten účastník niečo robí. Vnorené pruhy znamenajú, že účastník zavolal späť sám seba. Aktivácie sú v UML nepovinné a oplatí sa ich kresliť: robia zrejmým, že Checkout stále čaká, kým brána pracuje.

Správa je vodorovná šípka. Jej štýl hovorí, o aký druh volania ide, a to je tá časť, ktorú sa oplatí zapamätať.

Rozdiel medzi vyplnenou a otvorenou šípkou je ten, ktorý má skutočnú váhu. Je to rozdiel medzi „volajúci je teraz blokovaný“ a „volajúci šiel ďalej“, a je to tá najužitočnejšia vec, ktorú sekvenčný diagram povie čitateľovi o distribuovanom systéme.

Skutočné toky majú podmienky aj opakovanie. UML rieši oboje kombinovaným fragmentom: boxom nakresleným okolo série správ, s operátorom v štítku v jeho ľavom hornom rohu.

• alt - alternatívy. Rozdelený prerušovanou čiarou na priehradky, každá so strážou v hranatých zátvorkách. Prebehne práve jedna. Toto je if/else.
• opt - nepovinné. Jedna priehradka so strážou; buď prebehne, alebo nie. Toto je if bez else.
• loop - opakovanie. Stráž udáva podmienku alebo hranice, ako v loop [1..*] alebo loop [kým sú ďalšie strany].
• par - paralelne. Priehradky bežia súbežne, bez zaručeného poradia.
• ref - odkaz na interakciu definovanú na inom diagrame. Takto zabránite tomu, aby jeden sekvenčný diagram narástol na tri strany.
• critical - oblasť, ktorá sa nesmie prepliesť s ničím iným.

Všetko vyššie sedí v boxe, ktorý väčšina diagramov kreslí a málokto si ho všimne: rámec interakcie, obdĺžnik okolo celého diagramu so štítkom v ľavom hornom rohu, na ktorom je sd a názov interakcie. Vyzerá ako výzdoba a nie je - je to to, čo interakcii dáva meno, a práve meno umožňuje ref. Bez neho nemôžete dlhý tok rozrezať na kusy, čo znamená, že každý tok sa musí zmestiť na jednu stranu.

Zoznam fragmentov v predchádzajúcej sekcii je pracovná sada, nie celá. Existujú ďalšie štyri operátory a tri z nich si občas svoje miesto zaslúžia: break opustí zvyšok obklopujúceho fragmentu, keď platí jeho stráž, čo je prirodzený tvar skorého návratu pri chybe; strict vynúti poradie svojich priehradiek tam, kde ich obyčajné seq necháva voľné; neg označuje interakciu, ktorá nesmie nastať, čo je spôsob, ako do obrázka zapísať negatívny test. assert, ignore a consider patria do formálnej špecifikácie a pokojne ich preskočte, kým vás k nim niečo nedotlačí.

Najcennejšie na sekvenčnom diagrame nie je zdokumentovanie šťastnej cesty. Je to to, že keď je šťastná cesta raz na papieri, zlyhania sa dajú spočítať - a tok cez štyri systémy ich má oveľa viac, než ktokoľvek z hlavy odhadne.

Prejdite diagram nadol a pri každej správe si položte tri otázky v poradí. Odpovede sú vaše rozšírené cesty a každá z nich je buď fragment, ktorý máte nakresliť, alebo rozhodnutie, ktoré musí niekto urobiť.

1. Čo ak nepríde odpoveď? Každá synchrónna správa je miesto, kde volajúci môže blokovať navždy. Niekde existuje hodnota vypršania; ak ju nikto v miestnosti nepozná, to je to zistenie. Nakreslite to ako alt so strážou [timeout] a číslo skončí na diagrame, kde sa o ňom dá polemizovať.
2. Čo ak je odpoveďou zlyhanie? Odlišné od žiadnej odpovede a znepokojivo veľkým množstvom produkčného kódu spracované rovnako. Zamietnutá autorizácia a mŕtva akvizičná banka potrebujú iné ošetrenie a práve na diagrame sa ten rozdiel zviditeľní.
3. Čo ak sa toto doručí dvakrát? Pýtajte sa to pri každej asynchrónnej správe, lebo fronty doručujú znova a klienti opakujú. Ak je odpoveďou „zákazníkovi sa strhne dvakrát“, našli ste požiadavku na idempotenciu, ktorá v tickete nebola.

Potom si diagram prečítajte ešte raz, odzadu, kvôli otázke, ktorú prechod dopredu nikdy nezachytí: čo sa už stalo a teraz sa to musí vrátiť späť? Zlyhanie pri štvrtej správe necháva účinky prvých troch na mieste. To je kompenzačná logika a sekvenčný diagram je najlacnejším miestom na svete, kde zistíte, že nejakú potrebujete.

Sekvenčný diagram je tiež najúčinnejším UML artefaktom na revíziu návrhu skôr, než sa postaví, lebo vytláča nepríjemné otázky na svetlo. Čo sa stane, ak bráne vyprší čas? Kto to opakuje? Je to volanie blokujúce? Diagram sa nedá nakresliť bez toho, aby ste na ne odpovedali.

1. Každá šípka nakreslená plná a vyplnená. Ak všetko vyzerá synchrónne, diagram zahodil svoje najužitočnejšie rozlíšenie. Na „pošli a zabudni“ použite otvorené hlavy.
2. Šípky odpovede na všetko. Odpoveď na synchrónne volanie je často implicitná a dá sa vynechať. Kreslite ju, keď na vrátenej hodnote záleží.
3. Miešanie úrovní abstrakcie. Čiara života pre celú platobnú platformu vedľa čiary života pre jednu pomocnú triedu. Vyberte si jednu výšku.
4. Žiadna chybová cesta. Samotná šťastná cesta je tá menej zaujímavá polovica. Práve alt s vetvou vypršania robí diagram hodným revízie.
5. Dvadsať čiar života. Zhruba nad sedem sa diagram prestane zmestiť na obrazovku a začne sa skôr rolovať než čítať. Rozdeľte ho a použite ref.