UML sekvenční diagramy

Sekvenční diagram přesně odpovídá na jednu otázku: co se děje, v jakém pořadí a mezi kým. Je to diagram, který nakreslíte, když se dva lidé neshodnou, která služba volá kterou, nebo když tok prochází čtyřmi systémy a nikdo nemá celou cestu v hlavě.

Všechnu práci udělá rozvržení. Účastníci sedí podél horního okraje. Čas běží dolů - ne zleva doprava a ne v měřítku. Zpráva níž na stránce nastane po zprávě výš na stránce, a to je celé pravidlo čtení.

Tři kusy nábytku, a všechno ostatní je jejich obměna.

Čára života je hlavička nahoře plus přerušovaná svislá čára, která z ní běží dolů. Hlavička pojmenovává účastníka. Může to být název třídy, objekt (: Checkout), aktér nakreslený jako panáček nebo role se stereotypem jako «boundary» či «control». Cokoli si vyberete, buďte konzistentní po celém diagramu.

Aktivační pruh - někdy nazývaný výskyt vykonávání - je tenký obdélník položený na čáře života. Označuje období, během kterého ten účastník něco dělá. Vnořené pruhy znamenají, že účastník zavolal zpět sám sebe. Aktivace jsou v UML nepovinné a vyplatí se je kreslit: dělají zřejmým, že Checkout stále čeká, zatímco brána pracuje.

Zpráva je vodorovná šipka. Její styl říká, o jaký druh volání jde, a to je ta část, kterou se vyplatí zapamatovat.

Rozdíl mezi vyplněnou a otevřenou šipkou je ten, který má skutečnou váhu. Je to rozdíl mezi „volající je teď blokován“ a „volající šel dál“, a je to ta nejužitečnější věc, kterou sekvenční diagram řekne čtenáři o distribuovaném systému.

Skutečné toky mají podmínky i opakování. UML řeší oboje kombinovaným fragmentem: boxem nakresleným kolem série zpráv, s operátorem ve štítku v jeho levém horním rohu.

• alt - alternativy. Rozdělený přerušovanou čarou na přihrádky, každá se stráží v hranatých závorkách. Proběhne právě jedna. Tohle je if/else.
• opt - nepovinné. Jedna přihrádka se stráží; buď proběhne, nebo ne. Tohle je if bez else.
• loop - opakování. Stráž udává podmínku nebo meze, jako v loop [1..*] nebo loop [dokud jsou další stránky].
• par - paralelně. Přihrádky běží souběžně, bez zaručeného pořadí.
• ref - odkaz na interakci definovanou na jiném diagramu. Takhle zabráníte tomu, aby jeden sekvenční diagram narostl na tři stránky.
• critical - oblast, která se nesmí proplést s ničím jiným.

Všechno výše sedí v boxu, který většina diagramů kreslí a málokdo si ho všimne: rámec interakce, obdélník kolem celého diagramu se štítkem v levém horním rohu, na kterém je sd a název interakce. Vypadá jako výzdoba a není - je to to, co interakci dává jméno, a právě jméno umožňuje ref. Bez něj nemůžete dlouhý tok rozřezat na kusy, což znamená, že každý tok se musí vejít na jednu stránku.

Seznam fragmentů v předchozí sekci je pracovní sada, ne celá. Existují další čtyři operátory a tři z nich si občas své místo zaslouží: break opustí zbytek obklopujícího fragmentu, když platí jeho stráž, což je přirozený tvar časného návratu při chybě; strict vynutí pořadí svých přihrádek tam, kde je obyčejné seq nechává volné; neg označuje interakci, která nesmí nastat, což je způsob, jak do obrázku zapsat negativní test. assert, ignore a consider patří do formální specifikace a klidně je přeskočte, dokud vás k nim něco nedotlačí.

Nejcennější na sekvenčním diagramu není zdokumentování šťastné cesty. Je to to, že když je šťastná cesta jednou na papíře, selhání jde spočítat - a tok přes čtyři systémy jich má mnohem víc, než kdokoli z hlavy odhadne.

Projděte diagram dolů a u každé zprávy si položte tři otázky v pořadí. Odpovědi jsou vaše rozšířené cesty a každá z nich je buď fragment, který máte nakreslit, nebo rozhodnutí, které musí někdo udělat.

1. Co když nepřijde odpověď? Každá synchronní zpráva je místo, kde volající může blokovat navždy. Někde existuje hodnota vypršení; pokud ji nikdo v místnosti nezná, tohle je to zjištění. Nakreslete to jako alt se stráží [timeout] a číslo skončí na diagramu, kde se o něm dá polemizovat.
2. Co když je odpovědí selhání? Odlišné od žádné odpovědi a znepokojivě velkým množstvím produkčního kódu zpracované stejně. Zamítnutá autorizace a mrtvá akviziční banka potřebují jiné ošetření a právě na diagramu se ten rozdíl zviditelní.
3. Co když se tohle doručí dvakrát? Ptejte se na to u každé asynchronní zprávy, protože fronty doručují znovu a klienti opakují. Pokud je odpovědí „zákazníkovi se strhne dvakrát“, našli jste požadavek na idempotenci, který v ticketu nebyl.

Pak si diagram přečtěte ještě jednou, pozpátku, kvůli otázce, kterou průchod dopředu nikdy nezachytí: co se už stalo a teď se to musí vrátit zpět? Selhání u čtvrté zprávy nechává účinky prvních tří na místě. To je kompenzační logika a sekvenční diagram je nejlevnějším místem na světě, kde zjistíte, že nějakou potřebujete.

Sekvenční diagram je také nejúčinnějším UML artefaktem pro revizi návrhu dřív, než se postaví, protože vytlačuje nepříjemné otázky na světlo. Co se stane, když bráně vyprší čas? Kdo to opakuje? Je to volání blokující? Diagram nejde nakreslit, aniž byste na ně odpověděli.

1. Každá šipka nakreslená plná a vyplněná. Pokud všechno vypadá synchronně, diagram zahodil své nejužitečnější rozlišení. Na „pošli a zapomeň“ použijte otevřené hlavy.
2. Šipky odpovědi na všechno. Odpověď na synchronní volání je často implicitní a jde vynechat. Kreslete ji, když na vrácené hodnotě záleží.
3. Míchání úrovní abstrakce. Čára života pro celou platební platformu vedle čáry života pro jednu pomocnou třídu. Vyberte si jednu výšku.
4. Žádná chybová cesta. Samotná šťastná cesta je ta méně zajímavá polovina. Právě alt s větví vypršení dělá diagram hodným revize.
5. Dvacet čar života. Zhruba nad sedm se diagram přestane vejít na obrazovku a začne se spíš rolovat než číst. Rozdělte ho a použijte ref.