Příklady diagramů komponent

Každý diagram níže používá tytéž tři značky, a pokud je umíte přečíst, přečtete všech pět: komponenta je box s ikonou zástrčky, «interface» je box pojmenovávající kontrakt a šipky říkají, na které straně toho kontraktu každá komponenta stojí. Čárkovaná šipka s dutým trojúhelníkem znamená tohle implementuji. Obyčejná čárkovaná šipka znamená tohle potřebuji. Celá sada je v symbolech diagramu komponent a úvaha za notací je v průvodci diagramem komponent.

Jsou seřazené podle toho, jak často se ten tvar objevuje, ne podle složitosti. Každý pojmenovává otázku, kterou řeší, protože diagram komponent, který neřeší nic, je nejčastějším druhem a nejméně užitečným: pět boxů, pět šipek a žádné tvrzení, se kterým by někdo mohl nesouhlasit.

Obrázek v hlavičce tohohle článku. Webový obchod i mobilní aplikace potřebují produktová data; jedna katalogová služba je poskytuje. Rozhraní je nakreslené jednou, mezi nimi.

Ten jediný box je celou pointou příkladu. Než existoval, měli ti dva klienti dvě rozdílné představy o tom, co „katalog“ vrací, a ten rozdíl žil v tom z nich, který se psal jako druhý. Pojmenovat ICatalog si vynutí otázku, čím ten kontrakt vlastně je, a jakmile je pojmenovaný, je změna v něm viditelně změnou pro dva spotřebitele, a ne úpravou jedné služby.

Přečtěte si šipky a všimněte si, čeho se jádro objednávek nedotýká. Nezávisí na HTTP a nezávisí na PostgreSQL. Realizuje jeden kontrakt a vyžaduje druhý, a oba jsou boxy, které mu mohl podat kdokoli.

Tohle je tvar, který lidé myslí hexagonální architekturou, porty a adaptéry nebo čistou architekturou, a diagram komponent je nejlevnějším způsobem, jak ověřit, jestli ji kódová základna opravdu má. Pokud má box jádra šipku mířící na databázovou komponentu místo na rozhraní, je ten vzor jen aspirací: něco uprostřed importuje ovladač.

Tohle je diagram, který se kreslí před výměnou, ne po ní. Tvrzení, které dělá, je přesné a testovatelné: všechno, co objednávková služba od fakturace potřebuje, je v IBilling, takže druhá implementace toho rozhraní se dá zapojit, aniž by se objednávková služba měnila.

Je to zároveň nejrychlejší způsob, jak zjistit, že to tvrzení je nepravdivé. Pokud někdo řekne „nová služba neumí vystavit PDF výpisy“, pak byly PDF výpisy součástí kontraktu a v rozhraní chybí, a diagram byl nesprávný dřív než migrace. Ten rozhovor stojí deset minut u tabule a tři měsíce v produkci.

Když je stará implementace pryč, smažte ji z diagramu. Diagram komponent, který dva roky po vypnutí pořád ukazuje mainframe, je důvodem, proč lidé přestanou diagramům věřit.

Topologicky je tohle příklad tři s přidanou třetí implementací, a u té podobnosti se vyplatí zastavit: vyměnitelnost a rozšiřitelnost jsou tatáž kresba. Liší se záměr. U migrace je realizace navíc dočasná; u architektury se zásuvnými moduly je produktem.

Technika čtení, která se tu vyplatí, je zakrýt pravý sloupec dlaní. To, co zbude - hostitel a IExporter- je všechno, co autor čtvrtého exportéru potřebuje vědět. Pokud odpověď na otázku „můžu si napsat vlastní exportér?“ vyžaduje čtení zdrojáku hostitele, je rozhraní nedostatečně specifikované a diagram vám to právě řekl.

Dvě služby, každá realizující kontrakt, který ta druhá vyžaduje. Nic tu není nelegální UML a nic na diagramu není špatně - ta kresba je přesným obrázkem systému, který bude náročný, a to je přesně to, co od diagramu chcete umět říct.

Cyklus mezi komponentami znamená, že ani jedna se nedá pochopit sama: žádné nezávislé nasazení, žádný test v izolaci bez záslepky za tu druhou, a výměna kterékoli musí naplnit kontrakt, na kterém ta druhá zároveň závisí. Na diagramu tříd je cyklus zápach; mezi nasaditelnými jednotkami je to riziko harmonogramu.

Obvyklé nápravy jsou vidět na témže obrázku. Přesuňte to, co doprava potřebuje, z IOrders do události, kterou objednávková služba publikuje, aby se šipka stala jednosměrnou. Nebo vytáhněte sdílenou část do třetí komponenty, na které závisí obě, což cyklus změní na sbíhání a vrátí vás k příkladu jedna.

Na nakreslení jednoho z těchhle proti vašemu systému je verze krok za krokem v článku jak nakreslit diagram komponent. Na to, kde ty komponenty běží, místo toho, co si navzájem slibují, je diagram nasazení.