Príklady diagramov komponentov

Každý diagram nižšie používa tie isté tri značky, a ak ich viete prečítať, prečítate všetkých päť: komponent je box s ikonou zástrčky, «interface» je box pomenúvajúci kontrakt a šípky hovoria, na ktorej strane toho kontraktu každý komponent stojí. Čiarkovaná šípka s dutým trojuholníkom znamená toto implementujem. Obyčajná čiarkovaná šípka znamená toto potrebujem. Celá sada je v symboloch diagramu komponentov a úvaha za notáciou je v sprievodcovi diagramom komponentov.

Sú zoradené podľa toho, ako často sa ten tvar objavuje, nie podľa zložitosti. Každý pomenúva otázku, ktorú rieši, lebo diagram komponentov, ktorý nerieši nič, je najčastejším druhom a najmenej užitočným: päť boxov, päť šípok a žiadne tvrdenie, s ktorým by niekto mohol nesúhlasiť.

Obrázok v hlavičke tohto článku. Webový obchod aj mobilná aplikácia potrebujú produktové dáta; jedna katalógová služba ich poskytuje. Rozhranie je nakreslené raz, medzi nimi.

Ten jediný box je celou pointou príkladu. Kým neexistoval, mali tí dvaja klienti dve rozdielne predstavy o tom, čo „katalóg“ vracia, a ten rozdiel žil v tom z nich, ktorý sa písal ako druhý. Pomenovať ICatalog si vynúti otázku, čím ten kontrakt vlastne je, a keď je raz pomenovaný, je zmena v ňom viditeľne zmenou pre dvoch spotrebiteľov, a nie úpravou jednej služby.

Prečítajte si šípky a všimnite si, čoho sa jadro objednávok nedotýka. Nezávisí od HTTP a nezávisí od PostgreSQL. Realizuje jeden kontrakt a vyžaduje druhý, a oba sú boxy, ktoré mu mohol podať ktokoľvek.

Toto je tvar, ktorý ľudia myslia hexagonálnou architektúrou, portami a adaptérmi alebo čistou architektúrou, a diagram komponentov je najlacnejším spôsobom, ako overiť, či ju kódová základňa naozaj má. Ak má box jadra šípku mieriacu na databázový komponent namiesto na rozhranie, je ten vzor len ašpiráciou: niečo v strede importuje ovládač.

Toto je diagram, ktorý sa kreslí pred výmenou, nie po nej. Tvrdenie, ktoré robí, je presné a testovateľné: všetko, čo objednávková služba od fakturácie potrebuje, je v IBilling, takže druhá implementácia toho rozhrania sa dá zapojiť bez toho, aby sa objednávková služba menila.

Je to zároveň najrýchlejší spôsob, ako zistiť, že to tvrdenie je nepravdivé. Ak niekto povie „nová služba nevie vystaviť PDF výpisy“, potom boli PDF výpisy súčasťou kontraktu a v rozhraní chýbajú, a diagram bol nesprávny skôr než migrácia. Ten rozhovor stojí desať minút pri tabuli a tri mesiace v produkcii.

Keď je stará implementácia preč, zmažte ju z diagramu. Diagram komponentov, ktorý dva roky po vypnutí stále ukazuje mainframe, je dôvodom, prečo ľudia prestanú diagramom veriť.

Topologicky je toto príklad tri s pridanou treťou implementáciou, a pri tej podobnosti sa oplatí zastaviť: vymeniteľnosť a rozšíriteľnosť sú tá istá kresba. Líši sa zámer. Pri migrácii je realizácia navyše dočasná; pri architektúre so zásuvnými modulmi je produktom.

Technika čítania, ktorá sa tu vyplatí, je zakryť pravý stĺpec dlaňou. To, čo zostane - hostiteľ a IExporter- je všetko, čo autor štvrtého exportéra potrebuje vedieť. Ak odpoveď na otázku „môžem si napísať vlastný exportér?“ vyžaduje čítanie zdrojáku hostiteľa, je rozhranie nedostatočne špecifikované a diagram vám to práve povedal.

Dve služby, každá realizujúca kontrakt, ktorý tá druhá vyžaduje. Nič tu nie je nelegálne UML a nič na diagrame nie je zle - tá kresba je presným obrázkom systému, ktorý bude náročný, a to je presne to, čo od diagramu chcete vedieť povedať.

Cyklus medzi komponentmi znamená, že ani jeden sa nedá pochopiť sám: žiadne nezávislé nasadenie, žiadny test v izolácii bez záslepky za ten druhý, a výmena ktoréhokoľvek musí naplniť kontrakt, od ktorého ten druhý súčasne závisí. Na diagrame tried je cyklus zápach; medzi nasaditeľnými jednotkami je to riziko harmonogramu.

Obvyklé nápravy sú viditeľné na tom istom obrázku. Presuňte to, čo doprava potrebuje, z IOrders do udalosti, ktorú objednávková služba publikuje, aby sa šípka stala jednosmernou. Alebo vytiahnite zdieľanú časť do tretieho komponentu, od ktorého závisia obe, čo cyklus zmení na zbiehanie a vráti vás k príkladu jeden.

Na nakreslenie jedného z týchto oproti vášmu systému je verzia krok za krokom v článku ako nakresliť diagram komponentov. Na to, kde tie komponenty bežia, namiesto toho, čo si navzájom sľubujú, je diagram nasadenia.