From 9b64cdee9891870af848175ede73324123ef76e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Sun, 6 Apr 2025 19:10:43 +0300 Subject: [PATCH] docs: add diagrams for facade, factory kit, factory method, factory, fan-out/fan-in, feature toggle, filterer, fluent interface, flyweight, front controller, function composition --- facade/README.md | 4 ++++ facade/etc/facade-sequence-diagram.png | Bin 0 -> 63341 bytes factory-kit/README.md | 4 ++++ .../etc/factory-kit-sequence-diagram.png | Bin 0 -> 45088 bytes factory-method/README.md | 4 ++++ .../etc/factory-method-sequence-diagram.png | Bin 0 -> 60410 bytes factory/README.md | 4 ++++ factory/etc/factory-sequence-diagram.png | Bin 0 -> 29457 bytes fanout-fanin/README.md | 4 ++++ fanout-fanin/etc/fan-out-fan-in-flowchart.png | Bin 0 -> 62694 bytes feature-toggle/README.md | 4 ++++ feature-toggle/etc/feature-toggle-flowchart.png | Bin 0 -> 46481 bytes filterer/README.md | 4 ++++ filterer/etc/filterer-flowchart.png | Bin 0 -> 40010 bytes fluent-interface/README.md | 4 ++++ .../etc/fluent-interface-sequence-diagram.png | Bin 0 -> 91556 bytes flyweight/README.md | 4 ++++ flyweight/etc/flyweight-sequence-diagram.png | Bin 0 -> 76042 bytes front-controller/README.md | 1 - function-composition/README.md | 8 ++++---- .../function-composition-sequence-diagram.png | Bin 0 -> 34500 bytes 21 files changed, 40 insertions(+), 5 deletions(-) create mode 100644 facade/etc/facade-sequence-diagram.png create mode 100644 factory-kit/etc/factory-kit-sequence-diagram.png create mode 100644 factory-method/etc/factory-method-sequence-diagram.png create mode 100644 factory/etc/factory-sequence-diagram.png create mode 100644 fanout-fanin/etc/fan-out-fan-in-flowchart.png create mode 100644 feature-toggle/etc/feature-toggle-flowchart.png create mode 100644 filterer/etc/filterer-flowchart.png create mode 100644 fluent-interface/etc/fluent-interface-sequence-diagram.png create mode 100644 flyweight/etc/flyweight-sequence-diagram.png create mode 100644 function-composition/etc/function-composition-sequence-diagram.png diff --git a/facade/README.md b/facade/README.md index ea27e4afa..b0dec75b8 100644 --- a/facade/README.md +++ b/facade/README.md @@ -33,6 +33,10 @@ Wikipedia says > A facade is an object that provides a simplified interface to a larger body of code, such as a class library. +Sequence diagram + +![Facade sequence diagram](./etc/facade-sequence-diagram.png) + ## Programmatic Example of Facade Pattern in Java Here's an example of the Facade Design Pattern in a goldmine scenario, demonstrating how a Java facade can streamline complex operations. diff --git a/facade/etc/facade-sequence-diagram.png b/facade/etc/facade-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..d0172c01c5c8ee9dfd3c573b1e620e7691437859 GIT binary patch literal 63341 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 Factory kit is a configurable object builder, a factory to create factories. +Sequence diagram + +![Factory Kit sequence diagram](./etc/factory-kit-sequence-diagram.png) + ## Programmatic Example of Factory Kit Pattern in Java Imagine a magical weapon factory in Java capable of creating any desired weapon using the Factory Kit Pattern. This pattern allows for configurable object builders, making it ideal for scenarios where the types of objects are not known upfront. diff --git a/factory-kit/etc/factory-kit-sequence-diagram.png b/factory-kit/etc/factory-kit-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..c2f07c2b9bf331b3ec802b78eb6ca0fbb06ca504 GIT binary patch literal 45088 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%0AM0uRZx4F!rA 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 literal 0 HcmV?d00001 diff --git a/factory-method/README.md b/factory-method/README.md index 6aad53596..4334b0523 100644 --- a/factory-method/README.md +++ b/factory-method/README.md @@ -36,6 +36,10 @@ Wikipedia says > In class-based programming, the factory method pattern is a creational pattern that uses factory methods to deal with the problem of creating objects without having to specify the exact class of the object that will be created. This is done by creating objects by calling a factory method — either specified in an interface and implemented by child classes, or implemented in a base class and optionally overridden by derived classes—rather than by calling a constructor. +Sequence diagram + +![Factory Method sequence diagram](./etc/factory-method-sequence-diagram.png) + ## Programmatic Example of Factory Method Pattern in Java The Factory Method approach is pivotal in Java Design Patterns for achieving flexible and maintainable code as we see in the following example. diff --git a/factory-method/etc/factory-method-sequence-diagram.png b/factory-method/etc/factory-method-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..d055d9ca956b64a58164ee8a8929e60b2eb94c71 GIT binary patch literal 60410 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 b{QdZ%jb~$hJ8#o35b(j9+w9KY Factory is an object for creating other objects – formally a factory is a function or method that returns objects of a varying prototype or class. +Sequence diagram + +![Factory sequence diagram](./etc/factory-sequence-diagram.png) + ## Programmatic Example of Factory Pattern in Java Imagine an alchemist who is about to manufacture coins. The alchemist must be able to create both gold and copper coins and switching between them must be possible without modifying the existing source code. The factory pattern makes it possible by providing a static construction method which can be called with relevant parameters. diff --git a/factory/etc/factory-sequence-diagram.png b/factory/etc/factory-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..260bea92f24736656584c4714398e47e2dbb61c2 GIT binary patch literal 29457 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

a2pE@iOs1kiD%Yk zvE_^`QwrGJL*?h^M{RCee=vYyuT-MQ*C=~ai&II zEF4^pEAV{!iZUCX=E}2Nc4s)>>kD~{_UF`8M(y?&Vk0SARq&s(Z8oez0>?-9Z7w)< z8lNFj)mi7*h_zoOF;Et`)~dEOMRGWG_Y_1K_{WxKYLAM(3z6Iyd)C}Sj$UX-fBam< zV?OC|T4Y?+TUrun|0y4=5N{(V8to_1G&%akRIG$Uhb$sW|EP1Rl% z$uW=4Zaryqrf>REn`W%GKgzwQ*}wPh!ae`zR>~fYVmW@;TX?#@A)H}JTw<1cui9s+ z?F6Ov2`;!K9%o#&JML5>Uf)#GAr0X6EcGywJHf8%U7-}Eky_7aB$h~a5C^dNTAMpQ z`;jezf)`wJ*pV!p4VTlYTlXQ7h^e22L8X`P@9#2qTS1BYxIf%9y%4_34mG~$@U5-! zs&{BdGYyA-I(Yj(r3cax*YOqqHP&?rp(yptucn!a*#fwpMyAE0(BiNMAjDAc05>zU zO&?V{h}pHEBqEub>fYw+&$RlhlD7@%4@=d0gV!c%!Bhn8%?!i)a_wGLiS=UrC#3^p z-#$R@qr;^a!$Z*%vw}1`h4&tf)QkfE)l$iJ zgReICW|bB&xj~Uy1bTYdZy0FEimFxXW2(IB#SBsFKe9%Kxb2+AE!&$jhsuF2dbqfs z*QV8P!8%Ts(`NF8Zk5Ei^_@VT=p1*RL=f28(!d=c`l$QqGdJ?v^*b&3OC(F^-F8TJ z5e{SlM%y^+TgrOdI4uVIzaH} z-Bj2f4Gj`;MTHa*6SRF^CF9r7)32+rmfK->h2ToD6~nx>zshUHdh^WQMRH-n?|>lv zF61i^D~JftIanNwZ#}^6U`p{iiK!*V$87g{GMYrj{1RFRgiOg4zOrt!OTkiGMP_wG zT(=Yrtxl_bTzhz#I|6V9$tYLvsv0JAMBBU@X&_&!-0(m`}F5NGvx1xfV2z-9SsRT{j=kKAj>m@WgcSx{L})3`j=vOx+H0xuS5Os;_pBDM+LqD z`3Vts9}K;d!`P!1j>{V50XINNU(WILcHR6vQ=5QA2RHkuibrJkj)jw1ao@h2k(XGp zlvGlcpPTlDx;n!OiH6!s4Qq9&!43>oh2JR>5*64PDM|hzE#K(pN%n5K)&-rs_F+sV zWyl~%^FOUyrF+t|x^dT!^qLYV>gXRyepX8gpMx(b|fTd zxnE7^d5w(b%e}eqW8|q}sWiCJtVbUazC*OxMe>{RNfLl*HQ6-%@-Kb7$Y(6&xu8CO z2TVJ!1#$>s-6CnEYj*Sb^(O(u5ZDOL3+h4fJnMqq%=GdB}C@obY7HEnG#Nc8LFNy7MoO^Z78 zp4oDll$^YZN_d~?_>61$K;F`F6wW{g{dC^&gk^-jwXn$LqUFoB2(zrDuw*sECX29M z-3Cd$xk<-B07?Gi&0wE8TDxwh-UA;`n8>-#A5(72nYGWQKYa#s+F*-jQjNM968BJs z+(;vcv*}7@w9@pXEcIQivC?o?fA{Ab#|SAV6*swp!W#syxfPzqeY*dw)RuF+m@_)@ zAYT47;6%i`t-Leq=5O8JV+IzgxRHGjuaCSbODj$#a5T}&-EF5txR;n%_H#m=cZL=2 z&^SdZFLrE*yGP@u1wK}N=qmGrHQ^9LSp4=d{;$m|FAy7`FQt~lRY6A!697PVc^ z8wpl|h5|cViPNGD$=E(ih3%Y@kfk#3OjpIi=R8#nJeR0We?@Z^=^x_AU1_R_9NTqu z-MNjED(E?p;NGymYD}p`JZqE8u1uZVLtT%2fADmPGk%hM6_Bk#dzxojitGL-XHzX( zPjTx2k<;y-{qRTWuy1lyOiK~s-4j`mN_f~M`9x_%W24=kn)}6JkL^meJ9W%Z;Ds#0 zW$ni4>Up}Ab_r~mv%F7Jw=-hItUG!@HKs-hS~as2E-I-aws(JHveA+&Io-7PvpbEa z8shX#!69-|Kb+@y-YIolqsOCFoHNR^@kaHcjOEZw$?SzSCU zO9L`HXL2+i-YMLkMO9k_9VQElEtCP_J2#vWXYC86@#u8rgAdWWSnA@@$)$}m)zevB zG@WDd`n0}SM+B><-rPN|YnKtr?Oq0~*3*@76==7*?Yi@l{hrbTlVJ0Xiv|(FWpC*6 zNAXmqVq84mJ$myH8-3yFUm@`v@dlzWtR-1D9&6-RdEa*08QB9nmhv|n&mTRqWN(By zVh3N`f2eZz&st*u^>&`;eOr7vx+2qtL%cUME@xfLdA4@6zpl>t`en)LBUTnwkps^1 zcPp&P+aF~@R_fDDJ2lWS<$ZgH;)xVKv$W-vm2PH34+b)W4~@Mkmm#T_HaAcEgj3-gP4^Qg#x3jGXE)9!jXLh^6ld7XRfjc>^Q5>T zf#Ae$MF-cUN#KsO%({O&Qgp@&*5lF|fa`iSrf_U8QJi5|JtG zPES2PwotQ2TXwMNa7wqlZ~mF)y!h3&;=Wvk%gAJNd=Y1?14q+v@CjA*td84#A1^>j zr^(;Pmr}=b=)OI8#J5V>Z#_}={fylJ*6Vun6neTtU_W@}9#Y-0gA%2$nLUrhCl2pv zIK|tM^5eLpnLBfSh%_J2kl&J0Xv!an)4g5h+Vp;NIc4<&N=h|>{2-P;Y=6pr_Hup+ zh_(2pi1{hIERdYScTjcjtHq^uU#*taB|+^sXWxin3R~yN`B;_W1N=%BIf~F=OCSKPqvqs zVp{S^z-@{_c>iI&8^Uw0)!Fo7sQ!w*9(ivfRmT57)KvDunm4n^_EySB;=ZMA(}+O{ zhk>Q(%v{ZyP){)dra>;~s!6w`f`Flf<1FJV6PDCa#+XJ#`X1AC2CYdYxsxfQUJf>P((WCO^G>kbXt;Njqu@ zNRzl;4Qe64QJp`Q)>onoSJ`2#8BfWYj3U0b5N}8}l`>}4E=V#iWN84WDjWEfG3gWR zLej`;Q8V=}qgP;+-y&zcqn7Clm3q5ar zQjhmMu1j?U9+B*tCg^S>|BAgQdO*37hGdUbX-xLYXWF*%<1D31vnYh%%v^sIdH|&@ zeTlVWTY5Awkx5XoCf=W59^ufZ@^rJ|tt`2E!h1a#ne5amgxN{iyk-~>(@Y|oP`ND- zXVcf7Ll(VRoqQIVV=9^Mu~(&xtg1m&bPQpknI5|8XKgA4Ii7b%F&tN*j=reqJ52qM z{nbWOxL6!yJD2m~*5Q<~^vJ^xD9L_PeI8}QDa^e2C#&e*3GSTO;x5Wh;x`>y}cbC-I2k0wY4>2e0-rp$MKHu z%cEx!G!#i&nx)!CnT{KymBn7Ol}CMT7dJz;+yq=iO_zPf_0~v?0>yh9##|Q01Z3vq z*OTv-jvU=Ffae=wx#u%I+oZP+VQepw*KfXcf0|PHf}E!;-uedo4st@elF3#pQQt9V z0AHlm2G?qJQQ7e2^vRu_AEVE#R~jt zeXz+L$rPXJ<=l7zJIaLB13^KK+hd8QsbjmN-x?dx3%TQQO$J#))Wy0aN!B2|WmhAZ zI$SVn=VDByLBH6#@c<7}q)Ub$pPtVAI2c60&w+3|Abh)<*p|NOsP7GP+T!0E4rBom zgFA~kXAjF>3WPS9ywI}p9L=v&A=@iZh~dSvVDlV6&PvnRJ2Dx-CGv#NYL3X(VK7+b z;dfbm8=G)Z*(p+(n1uc;*3GTNhhDuR4LZZ}&dzbS*C)q{n6XE>6@uls{}}3+V6I{X z49D^r5zyuNaW&4hHTgyo77~`!@?=FQfm|>3)3|@qP1jRr2nE|J$0;I=Ro8t!W zPkl71l+41(G#0~Lc=2H8sQl!PBtFc&^$Vw55|WmXcs9J8xlBtf%j%Jd(E5Rb0s?rnm?NiQM*yxXiQZKbU zlj4Z`+zh8B`)nFYIN~v(H|qD;xP@Dvu2J8fnZB`B+F?XMW5S940BvFN`swNJW;^Ym zzr0OKvn9EhpN@6rr`tebuDibY-l>aiS>tDoxdyH7@z$rHn&LK^-zxt`Hcf0^7-ZqR z*DRO*S$EfS5Lr1~r;g?NV{d0d<0(3q65$yf}F2kLURHvr*IxzK6j&~Z* zio`p!LbxC^HbJSP<96=J?00epQrJ}!*zaz^8l9)xINmg#{r5!V+XXnQzSHxy)Gbs%egf5bUgJ9X<{)wZ{K!3GGNK6d-r37Y6YI7 zs_5=rK^HXCs&TZ*5Q3^ZY2dZ~6;S)27H!~6R}#D%-K&|td3Lm6LUTLKZBN6J!~SeH zoS^B;ARp%0V8)L9s4W4`q}s47zgK0SD(}jKSE*>PionQ@8~8F?4^>8HuKV8IyrKOp zyr+UO0#U;?D^wL-LN#4we7yX}!c|c5CO>^>OB<|}?wzEVN2{4^PLc(=*nLSUf0;tq z(~IqBT{HGYAU3m)debajNacA?H{iWc*XT+e^ScLbaTXQ?Y2^wxl}O$>z;5T{y7jWg>H;+uukiL+Q*q$_3yvCnh(8OnlPJt7in6430twE< zvvhjg3+;QSLDGe|n69*8grLtU&IvQz0l-g7b5qat=)y14)ABe}{JV{RK9K1U1h-~6 z+VOY5|M1d*TtD*Shovp-jWgL7JhWp#)dAc-p9`X*{85(1(Yw)6{PPO3E;HCRHA<`f zEEz*Mv4$Cbx%6W`$wz)lvW9UiuxP{!lA_3O9Se?EP2~w)2-F)cWOIhvjorU&d)OCZps=%O7#6UE{vd~hU{Yvj=IVu z%L^&}osjorToE{AvU4xkcub!)x;f%a!3FMVDw~rgB)a3TDSh4yDC{w5FA{VP>C|GH zu|*w27OKS8Tf-rH1vZv~t3P?O8a#ZJJU8|TuN31;Bj+A?s@W+j^A)Qt%uTrY+F5_m z^=&#|VBTLeLV;;8^y=tEOLXcH?M}Sw$ou9OuLGyg`%m$iPKN|B9SU#RF5+NfXWjOp zG4;QqEW3Qu?%DmsCN=ntjye{0{1yE?X|AlgMd||eg!r2pDvl=HCHW^VPxofj_~B=f zUrbq*19bE-BEQiU#5KufKUHeIwAT%7);6{Iy6N8UE>5_)(<@i+GpU;*53->$+z#N zXROlcVrNkSFz4A5*EbPOhxwd*{(r-F&w-mcxzfC9IRAwvd>k2o^Rb3Bx9PWU@h7nu zK%nT-@AkvGem^Qc4~e(gv-}t$b4(bNBrz+dR}&$Z%0=`KvZD+z z5x@+Z-ebu4m}?~^bHPJvf?bJ$xzieiBE?W9{mth^1jczMT`Kg_+o0I^(-XvW<8yY(|b z#s6;?F+l%6q-cDeoA<8}328t;*fCV~M-~Mch@71KgF?JC-Mj!W$IVsuSANg2PXeJt zLkHMM^6p+W)mJe(Wr-XGNnqtZ#DDh3B+M|u&chzXnf=l5psR1evdko}gE>C9oAps) z-aY7-j~NjJMrz77pbNaXnH{N(-}6Zu0Dkq;jDlniMytictIb3zRf(hUoaSeF1y6QX zk)*};4GJa!9CK_Q<@=adB#QUlcz)mM^ND*n-^*QI&O^Azjw9CZx^W}1I$sFh{-OUf z5O{q8EC+>=d-wimm(EA;{>~-9akEa+*-@~jzedkeNa%iRV@oc0MyXi%tdinhJrStH zdiGmX#>_{F?(2<9NnMTTw2m3&s%$YQ+>sGm{C=a~N}B%qsv?*N|c z0ZIRW*iqnwD&>clab3y$Hst-wpGCkEo;XH}9u)Msy7A7 z8&qt0d|!b-FX6sfx6rLmp=ndU_Ke(h5Oe?7ou*rB?vmy5?C|qr4k36i|Ly~& zW{=ieuB+K_ll_?dePF!Ef~v^UKsnmLy%TWz%*cFH zJeH_j7wh6zIyQKBE)k;jJ&%~F8H^&RiIog{Voj7h&kncgIGc{+*mS?CwNttKr8u;^ zm`~?a;X~RDIVvjVlh6|*1JS&yVnh8N^+I|s$i(uVJJXY8hLjG8=hTU`hMwoXVI$w9 z+{vBhuk5dARAWD0cmP;wzWrP)vDJi^o>yVJpvRS;*u|6`@r- zK|6HgHuSQ>Ztt!;;v2L+BR%bK8=-*^z%v-T5)-I#(E`R%PRk0KhSByEcGQdZ0#b z*DZ)cdH}$!+j-jRQ8UNuhqic-?$n-Y zZpZ7U%CD%sju{2fyOAZ-Eh?BgD}<2oFfG-iJL`eyYYVcrTb|yy{7YRSuD`r58iwCp0;iZ1u?6 z#<1P18TTG^mso4yB>7IJmsfRPjWIO8(nfa9pG1ad(@%Y+z-yMtR^%WOKbJt%g4hu5v@_i0#%@rqbasT)K=H%FyGD z3wwV>Tj2Ir>qg(lsq5`U{xL{jxGH{T`!IO`r`No_BtPQ5(~B1#yY*{G{so$xK5Wx6 znd0}CYxwAI(;@}fyTf&v%hD}P(TUH1)J$IBicW07HZm*Oo;+Fq+MYT24&h(rnWungbFxZ?BWMghVBjM_Td_ z$~Sv`kM_~!xq<&w(p*lP^E_M8!io8uNLZm$aoZs3Z#_%$2e4 zaQtJPd}GWoW!f5#osjtglY>na67b*|1aK&l=wfls7);c7eahGo8fg)7&*LOGQp4MKg0pODS z3~wpLBkOuyk)1V_N&`80FI;%l_$^(lfpgq9A?6kCL!&%U|m!;ladG=>D0J$Fxd*~$cm{AH} z#m~9a+i;P?cE-ndSJ4RDE&C+x!vaf8+2ll**=K8&2OLq2khw7qZw+-SsGY0Hk4ye= z8yVMDYgA`UggDu3m|UtD%ldf2S~|3#aW#Tym--;XCUr^y9{y$8=?69lNKsW4|7TFr z^0We+0{4M*NUjhA$SrM|`sBB8@(uLmnp@pQ`1$ez&cMwjWEF62e=OSz#~@)uC2`;h?|t>h$qE~*{vf`B|u`Zt_ro+@_W~| ziQT!&LE^8H2D2+(q8)L{a8MqXR?Ti&eb-pL4No5s(@dUC+V_VeZsVTTAkI4jM3F&5 z$DK44mM={M4!4JgdRxpC3#X|3=0QF%Fi)^z_g8H^bpfi9=*Sj=3Q(zu{!lf|3_R7| z?>b?k1px^NhiZ*Q^efDH-I$To65V_U|8ddMv=gqZ_yAs{Z)TR}L}!saUQE$jUL;ah z5pwnGvqN^a$vD4(7uTbX3)-<&p;;)?+-UPReFxUU0%_~T^zo9hp2Ssr2xT(Rwwhz5Pmi zn*tvzjCZ*>mm*YXXP%hiuw!HnoDhYAoWFGYZ5{u@@o`?2OE?@!IKXuwQ!zU^C*f~0 z3dN)B;+~Q66DSG3kUzGE+X+@RQ*VWpE_z8c|02LRYt_0&f?g%xEahA6$n>n(O|u73 z*hU3AAX7c?sbq#Am?xPyq3kbv9kB830h5+l zPWT1xb*H!)xXRR_!kYmX@8ali0P|2m>W$r&viOTt+_A{?`i`MF@ayf(-DAtjLpEpY zdjtY>k;CBo=r4WAw?p)$6n|>4;gn7A#V{?2$H=i7axdvUl|nAi=YBz&pxZ zl4biNNpei)!xKS=bUr}M91%`rRBuq@^;nEEFs`#T84?ZiKnEz}!{|hx_{#|b8UoW>K%*ypwVWJOD${m+G z%1`Q|n^9uCq1yeC7p6cQtz2VSL=Lt{Oy@-{yU-6_Ib=-F~-fBKEC5g{ww<9>ToFP=o-MT1Ad~`>e2Zi?B z2WTXFNs{fgY+doavI*XK+UHW*`aTOi{XgPjD)EXc@B_Zgi1)<2`^3=N;{C}U;|*{T zaH~FmZ+U#pxAd7vIaK&ao<|6bCoZ6)iJ+<|Rg5xnUBA*b&;{rs14X$pHv|V2>EtT` zwHkx=XGN-OY*@s-PkHIuDT(2H4?Uc~!KaJz0q&2dIFFwI*ihoV^+(q58i%I!QI`0Z zV4R=s_p<{s=22wdm{AmH{Dw!Fe|h z4IzsCd7pt3mQgOgMjDjxZXr=-Ww1i%m5`5b(2WBR4EmRQ)%bZ+dix=MFQm=li9>!; zLXDE4(Df`pu$Oxi2;Y=*D2uRA%Ru8_FA@LM*?kD*X#pX?Yf5xi3FufUZOcfJqvtp# zZN}V=!p=YOo8G{d06rX?Gx1Nj+yt^){>yet(wSAzSE1u&k>;eiznS|K=^L~yNjE;B z#I7`>H~`r}=S<2PkJS^J+hAr~tjbP*R0MD**`w`Bs=Ac1hepv|B4v#d!M8;;62OHJ z)3>*Y6gm(cnOcw0(B@GIInB65sLhxE1VJH?U*PdMp=V#!Ismt_-Ize4tNWS}k)&jp z_q|g7=*OvJVrKRoO5UwA|3y6klXig)U<0XnNF`8gAOSnN=>uldHL#3{u4VlM|2z7n zeMbaq}^q86{}xxcFQn^Gn@Q`J`4@BQl? zzDl+2FcQmP#MsMuN$wS`Z!YvYb7e0^NAD!|%|;%QOAE-w=T$%-N$W355tS7=iN{D9 zo32t}Dh1tW*-mDDDlLTSmOJ)6-b7Hx-DW_lW-FT(jIa7@c%9A0toZ2zsQ!t((u5Fr zGD*+jtU4w(jZUb+J${|OnYJXX={%{0n#GSFMr?h8Y&9O}T47Q~(GsR7x^8i?5&SxL zXZ+Yx1_a>>@#j?O1_M`)mmol$$X>s`X1#MH?e|>YZPHK>rEbIOIc!}X=n{ncJ;tB$ z%^@ZweZ7}l?R2cqp4b$EA3N#n7tc4J_J~rjDzWFvGvc9uk^W$%si~=SM!L{S`}kap zDT~^VI^)PF=YDc_K+bhHU;6|Q(WS@N&YvqH-KXyiHK=BJBUWpjriJi-bOqimN9y~W z`x!j=Cx<}J*p}lBH2wV1 z-kd0@Qj&H^C2Di=k1YFn*U0fAI?}VLYOZZnn9`oyWYTc!K~FQNE5aI1DGOabEAM z9p4=Q-y-dH7wL=oQOpceZ8i*SLc%X2HTO!h)unh-nb(y&f2a)OrF|3b=#^e$5mO+OH06g+h88uBt`QbxbY<6D%K~gaE#J80(m*P z-%X}3(~VFPoZh`NK2qOrBjPmPA~8HpVN23R?Tg4OY-s@Z+B7tzlr?Z`B(kt+u~1O> z`wnXOu=B(5ow_pyV!j2mZlA+Dsh(hm@xMLH$}AH!zQA=tP8KAGw1qnz$<_7@vp1Vj zGsYbOC}DN?Ve~}!3qEFNS655MX7N!ZZ-&Y97PaU)$NDUI?nXD}#(D&1ah(=iY(9FR zFrA~F*zXEixsT4I0Ei0W?2VWKx?D8V5FNwIJ@(iZ52J%y4KkXMQ#$H&han2HIprK@ zNmf>++}zYu3xW?Civra|!F^Nhg4VL1$e5;l4cxYIv()tHwE{iTm4G$?th=1;@r*5* z7ds!H)ZHmRdoSUhFL~VKl!j(tUBvlrePcMXt%~BS3E~81JYe6nPHSzJYsSgEG+k|b z@Akc2@jeHY?_gFfQ%!&i>J8m-eRAX%Xwch*Vau6(?0=56bub*JIi_H~Gipf=)KG}) zvs`=0#K6$mT%mX`2UJ7Oc+e-?)O>dO6}mbx1~pYIpnucnngSR|ihgNZi6tOY^XC(* zkWV?h5PMJY_kkUOGCFf1!UfI>!h2(~7dm<;dC-Qdyq3_vn`b?Tt6?`bxjxjyCa3e6t*^VI@5vj!{ewrgp{Jfy%V9V-7 z3;r{s`9;p5iRzZU{&O{&#&Ro&-x7!MjA>x!x_;7Qe37%%-Xdf9m1-Y%LctpQb@@DH zkY$V)%SvzZOrYE|gB@v2j|H?h^KUi^%7)!6%U~nT)m6;BwfIj3NDl)8-_PTSU$JM- zTfOnPe(7euLKy{-6C7L#A@=D${NX1G}xh>x>qnycq>TK|A5@`A!E}s+S#J^TYFM}ye4Q`Wk_IW=DWF1k}dKo zj~8C6<5ho~YDB*h0$IuB8nAautF$I7AqDG>8_ZlxxlOtc%&t@(43v@Ggd}^u{`LAE zdJ5IaaPBvt7#V64uyv2It0(&D`BB`MfSBf$+tleH{K13-paO150K~X5EptuV1-ZE+ zFBWW)@!j*8tsuLp{To}XS7iEr>@XP&WWyI__Ycx$wSZvRIGIxcakynTelyi||I_~T zR0z2)S7uojf=#39`<$TB$XB;oN|2YYUOG=;1z+->)PdSbmgYpUz4plF)D2zY68U+> zLW;=bOX8JP>}f!mUYb%nO#sC?TD%ucIFtB^*3>Yi@20CpeCj%0%FV?$ z@on262lBJQy2o-|_mLO8xkUFy3H@Vc75yZKmM45J)1aL_6vfi_W+Xv7ZK`sBqp|Oy z^M1zm*|gbow}~5bvY-1HmfL5USzNP?D3HnC(CU6_5g5-L1ZfD~DmmWTO6S&oQ^RTK zs&=``H&^4^cL}N149wh)8_!^CRsuMok5IwY<h znJI~QS6D&KqNdp%?7MXA&UV9`dTc}q`>Y9Pc4NsyfH{E#tu{IVvfT-Zr2BR#GJcE4 zdOL#kMC7=NcX>dsC@x6J3wT*>ST( zf7Yoe10pqkxu4d!zjPo@cDyAva!&1I)pYf4>iOhAxw`wIVaU|1ZMyHCYCX)q6O@r4 zvrN16^e!@&_B#7s4vsfWAj+(M7NU6|R$P0z(AxXvBLf)_J^Ub?IPd>i0cSoPuid?)Z{}86bS@@mB~oTIs!%g+b+gLm?2V-< z>G!SU2zeW?NnREGBW==PyLd?VAx47+3NT3g} zJLlO+jE}Dar|W3$2IeckQvd6QBTu53MHZB6^>k_BBOY~W#;rpi@rp@K#Mg2K|$gyiI8mqKROFj}-7t|@m1 zf?t9_>DhVhsQv3B2V-=Bl7^Zp9cJKw@C&-C{av&jmMQa@FmLB2B2x5jNgBaPJaLad z;aE7KqB72`%p9e)74IAA$(xfF-;)HILIU3>{>{1E8Q{mf0Mr8T#DwhB>nZq2gGOR3 zKfyrOi_t|QTdqPKDlH1B)fgYDcQk<3R-c)Jw9|3 z+y>Y$Ag17!d-?Ku1OR`Q`epq2?!&iZ4+AzS#-^p9>zmSnTIXqi^aTF&^%-j6a{+4R z`Dy2BcJglg_4HATeWg3lBEf>fAey9sxh)ktGB8 zE*DG7EkHabN+X9uGclB#RRl<5XtwDT82*sH*Q@v6Tb1|UjLN^vsQgP))pcx`#Kegi zfXQn&L;hkN6Mc}VtE=lHFZ13X8^%THu>gHZM8b_FAuXrxx1?I93kZ%D85i-d8IW#C zz~XG4zVi4+Mm`;nt3*vY3XnsMe@6o!WLI1Zq9vQE39^_ct4&dCpg zei2xZq9HUO4us^_CQ1Ypz|IgoHKC+HZN>SELpgLYe9W*T)(0G=#OTLrWvs7 zy;Yg5KhEZwfBAR|AX;?FV=PK>>nMga3S>M9aHQS~lSSM{UN?(k1up6yB8tnAM#m|k zCnThi#N4pvK$qsc{+U1>KtkQplfAwt?=z=#0>01dpdWtid-B@*ckg6q$I+2wlb8iw z10OR?+QTZNlw@Z;(^7dnrUCg15R#10J@frWl%!3p1@_lxiO-ZJcE9ekE< z2MG5?*4jsG2|ufm$!L0bUeukUS+YC%U$6%r1TE^U|m(=G8<`93sb_@{uDzu!P)Nhs$vdy?{F27mRfE zbUm;tmPe@3Pw{cde+ zUB@N8%6@!o>PyQZLK~GNmj}deoPcC|<-2jm>zBU1&%*zooI8Q-p9@0nPRlzdKf;on zSF!}JR-r4g?9B<&a32jeVK{!}@XuB-TuoKI2P0C5F1A26p1NS53JD|wD&0NnYpygH zBsznwUYRcg31L0^Uq=R3)~wkR(`OrR4!bavA<5Fc^0zD7+{VrWdcg6erL3F7kPzr8 zkVR(G{)WPRo6xDBVmZ$?WsI%Z8%Q{WUQA8z=Py?Nm{`UKvRyBbA975AWSzuznZ%%{ zZ9o*cnjVrK2ORGWDiMPT?;$ZuIC*=jmtY1)tP&dQbF! z<=ps`uq>@S;GXZzdgkGQk`Q$Tt*6rNOx08@CV&}Zurs{X=D1-us@Os(IbX>Ghq*S8 zQBvAXaZirx3_p5q9X4}#lAg0XfGZuK_&G~M25nAPG;nqFOIS6&st7oPRevm4!>egEU{}; zJtvnBLIM$^=~${qOkyHShTmmc;i>A&hJjy(oX*GWyvU(dmK8YJMRy0gratq!j&~kO zjG#?p^-A(P=KfI+teOrWgTx-xat?7)%?z_1D|6NZifpxWoMl_9y&8qZhCqgvblf361yF!2&S4f zT}#!snK{Zc{fbSl&SskuK{?d}2y`r|HRJ{1N*+sd+JX4oENW#j$^%W}Z{%j0+~y^i zdp$Aa&etcMSCg>e#6Ao48yVw0KnQ0)?bf*y(#2vgpU_S1%Nm>RqX94~1f}l9X*Rz} z9Go*1YmF@o6m(w!juz)-o>jSAKHd?Qck!rZ(9*q=ODU&Hi0LtV%a1Sj2BHAT4I|@< zuFt^5rN-F-wLC9AJB8X~vy>!Q&lTLv>s*uWA@(86m<+rn&#mx9bLn0rmGPyX&w(z> zQfG!koQ{=Q`luWr#Hv5slH-DpaRrFTB!CD=_7I|bhZyb?A-E*xC=%=TyemU@cXxD4 zs%t0|5av1k^!4i2EJ!7OS$q_TlF&?I$A*T!;YXa9PxE0QL{TiIET8?Iku+rE@@i?U zLe+ZW)zL%EwsPuMv4>e`-cGJFggKy( z<4blNnHd|U_5E+`Clm>l0x^y$>?EL`#dRY|Hg^gjOMv4nilVZ{gf?t)nNKh4a0!;# zjl4Xc&JhBq?cjTgzst7A9to%L$RyeGEaU32!prsO{IB zHPS0FJIoGc#(#kfBROMH2N9(i+W#n01Y|mp4S{83--!s;@Gyld7zpBDCO{B7*0OFR zmj<$ysl&C8w(e3^WB}zldC~@tmHBqoHIEC;UL{BR0%`Q1d4;t;F=jy?(B_ooaGMhI zcznb4L9VC|ki0u?9-}5K0GlcBGPhJ!eDqnpl=s$sn7Utze^dC+H@#dL+6MLfpP%Z6 zLu=-@#`ByRyh^;=f-^PLB859HI$&doH^=Z@Eat~xwmWO1Vzr4X>&MRU3E$ZAA#60B zPRlYDP6&K!$&z&F>%^s3ZSM9=QBL2mD;kg35XH&W%s~_nT_s;%Mo#!_OTSY|_uJz)s&W|Nw;)F(LUb{;8COw#`D_Qh+GG6LoTfLKUL>sV0j4XEv)?4-c}46c8xKXw zrQuUd^a%HEo+_?K$h9vE|9;P9J^?}|?HD(r_0bAlYlsDx!dlV}L&?l>thCOYMW~t@ zOP%h_XuE&YzAG={YP#`6gZ~HfjRj|W{e=6}?KN*@wY6A223RV!V}@}IlFQ{pGZMvP z+P;n|jxPjViZMPBPBsclSb~sOyipZbrhXj!G4!Sc$6ho624-p0Yjinf1axRCb+Vtc zX?A+Lu_>}?9Z6q5J2~l*Ha}_G-|IVH+h^%8$Xl|lLotlJ#7-$ubx$$=+FJ>FC+li> zemHzyyuPQP^ZvW;ro6KEJw! zhR@T-@0LaEgS}->xaDd-U^SZr&hUCH`u+wQdJ-o68m~3|SMiG8be^1dXW5Cw147IE zpnTp>MxPapz9)Nn?ibCrW8e$x%x>C72q?GAd8caEU`IA?wY0#I#Yu9PQ)%v(4avID z@=?q@JE#2+NvScBxvO!{qvPeuyw4?PEf+h~JErcJYm?5OgO0k`PG-FHy(T&>I;m`1 zU`%*3U$W)SHDveX#9V%aAOB)W&{x!P>;ADMrVa%QjLPM>DUY3wu zilLqrlL)VlF5_8I!M&j>Wb@KCWKF$g8}VHkBsex4!yOYzs6JLYuaSCC`9y+v(Xrs- zM-Tgh1eRnM?~5(f_B(uYDmoR2*!Gn9caD3lBGko_hMyLh*q?(()dZ&;>}QYDj1CgO zWE>YpIy5tGoeByQS1|pPR(o+VMvx?yCg#E#vG};wdwI<2dpdbAr{u(@S;H0v929(T8!Xdfk9{|O-sJnQ z%t69ahUpfyJ9G`U=O-l*pvXir0>><3x{DcSct)sM=dxXd?E`d790Ho3J?MC6dj0*F z>C+eWtGXMNMSamuAEKKp>js{+KZ|uw%z=)$ujRC@6!);(hK$XRBLa$*wYN{8&Zc`S zyF%@??iYpk<>+}sANjU5L{``O?FD$WuY+~9z1MDOe}>OCL$s)17d5PmDU>SgI&UKi z^diWpm%F82Qn$YgbEGCCy9{r}83$cjOxl=B?j7jQ>4wYS6NGw>p7(If=xgr?PR;un z9mTgloxglJN^ukuZ@;P0b#hX>JJX5iV+!uHkv}?`sxqeg@%{M@hp(@T3n-)~%z3ul zPHt~Yy(xRjrO>&~ZYSA_u^&8B*`&ojHQkBza=QRNaUvv^rvA_vacDkp1g*5}&%Xl; zO{ukIZ`O(!q*e~YZ}DhDSP2W%_-;bRN%<1mK6O~|a_BdIs=MgSmE6L1cS}2m^3w^AdcJOZn!>B%UYRo~b&;t& zE9~=FFzhbqiYX*G>|2#)D*l|*OtjzP0Z<(IW{a9gB**f}_N?|LqjJILkmWHJseTX3 z$rpK({MEifVMh9IT_W3wm#akHMkLOw>uvOAxSM%>NLs59NE2iIY{+e%KvyzCX_+z| z<|2H2vQgGqyrwATb3h=Me;5CD+&nt#bI{%5#*^;i!Lyd;wG>IRC`_+U|5YB=tcM z{Kr@Q0Nj9%jz5ZC;3zs53%2kkCNVrqMh~1f4xA6n@nAiFbbX5gy38mMN}=h95>a9m zY<&DM7zd@z7VsA(vU|cu`)o$Q9LP$diQw>1KzOkR`0+~WlszpLlC~U=OOqu0T3|n! zPSwaEQIS+aS`VLdE8c$LoXfmIa$qcJ+j%{EZ-8;U4X8@lBmB6u^~*0Z4(rnY7!8{* z$fCs{xRnWq`_}Ondts5FKG3Uck4i5qN-JV`c-Ola{jG*X#hiC(Ehuq(K!|8VGLvmC z#B+ANhkjA(A@9R@rSZrvk0phw5dk9a?DHPT)E8uvEouQO`am=h1wJMSuy@5MiG zK+wgs5aHbq4F�=nt6c0Wf(41WEl3CS?Fjz#jnoc5nbbUbAIJDWn@L{tc!TV#TiY z-jc$6dR|Wz90hHqI3IG5A literal 0 HcmV?d00001 diff --git a/fanout-fanin/README.md b/fanout-fanin/README.md index d92373760..12ba7cae5 100644 --- a/fanout-fanin/README.md +++ b/fanout-fanin/README.md @@ -35,6 +35,10 @@ Wikipedia says > > The fan-in concept, on the other hand, typically refers to the aggregation of multiple inputs. In digital electronics, it describes the number of inputs a logic gate can handle. Combining these concepts, the Fan-Out/Fan-In pattern in software engineering involves distributing tasks (fan-out) and then aggregating the results (fan-in). +Sequence diagram + +![Fan-Out/Fan-In flowchart](./etc/fan-out-fan-in-flowchart.png) + ## Programmatic Example of Fan-Out/Fan-In Pattern in Java The provided implementation involves a list of numbers with the objective to square them and aggregate the results. The `FanOutFanIn` class receives the list of numbers as `SquareNumberRequest` objects and a `Consumer` instance that collects the squared results as the requests complete. Each `SquareNumberRequest` squares its number with a random delay, simulating a long-running process that finishes at unpredictable times. The `Consumer` instance gathers the results from the various `SquareNumberRequest` objects as they become available at different times. diff --git a/fanout-fanin/etc/fan-out-fan-in-flowchart.png b/fanout-fanin/etc/fan-out-fan-in-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..cf726696cd7656a71984afd12e3895ce2a34814a GIT binary patch literal 62694 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

j{(b8(f-{>dS&h6WrS>t?rXPgu<)ns5{4 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 literal 0 HcmV?d00001 diff --git a/feature-toggle/README.md b/feature-toggle/README.md index b010cba59..dc2d913a8 100644 --- a/feature-toggle/README.md +++ b/feature-toggle/README.md @@ -34,6 +34,10 @@ Wikipedia says > A feature toggle in software development provides an alternative to maintaining multiple feature branches in source code. A condition within the code enables or disables a feature during runtime. In agile settings the toggle is used in production, to switch on the feature on demand, for some or all the users. +Flowchart + +![Feature Toggle flowchart](./etc/feature-toggle-flowchart.png) + ## Programmatic Example of Feature Toggle Pattern in Java This Java code example demonstrates how to display a feature when it is enabled by the developer and the user is a Premium member of the application. This approach is useful for managing subscription-locked features. diff --git a/feature-toggle/etc/feature-toggle-flowchart.png b/feature-toggle/etc/feature-toggle-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..8a62b1b593096e7512bfab7560e644dd3ac5f442 GIT binary patch literal 46481 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 Filterer pattern is a design pattern that helps container-like objects return filtered versions of themselves. +Flowchart + +![Filterer flowchart](./etc/filterer-flowchart.png) + ## Programmatic Example of Filterer Pattern in Java To illustrate, we use the Filterer design pattern for a malware detection system in Java. This system can filter threats based on various criteria, showcasing the pattern’s flexibility and dynamic nature. In the design we have to take into consideration that new Threat types can be added later. Additionally, there is a requirement that the threat detection system can filter the detected threats based on different criteria (the target system acts as container-like object for threats). diff --git a/filterer/etc/filterer-flowchart.png b/filterer/etc/filterer-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..7870f2e57e181f7af8452390132a432107860132 GIT binary patch literal 40010 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� zyO%IWa`kSoyvsmZhD$7G1;RgzcRs)h4EUFU8U(+8F4_STU_oZJ56Z2zZxZv$-8SmdBZW$P0x1ontYC zbM3IqD7v)$D(FZ{Od^!>Om`wx(=JiFZ{beHwW9X8y@!?m$bE#@h+;u}btLk$@QSHy zaeyvp{+>SRzS^}ua%x#y*iI1Uk>7kZFWTvNn&JAohpXXajY#ROqpam{YjfuNh!{w7 zyB(GlNtbqK2OVj%Uu&~?tmt6fvHCffNQjCHM6Fq9GfUmuGFtdD=b&S~`6JS+{S_75 zCy?h3jGjt#-6bG6ycM`cZ+Kfd}p z9r#|50{;h5jBQaa3o&pvUM3T9UN1XtOW%$syBD-LikFs{2%_v9-S*_k zor@MvX+3eWHFc2qE;NNTxkd-QuJMw3akF_w&yf=@t2tgq07vDhD@_x)5LVHOh2>F} zh;l%Od^%%rPHj-e-fb_6foU=D)el=D;7W5(ydxE!NwLXGUNA&(>l}xX?D?fZ;bba; zp_2B^F)yQ1v+oV=(Grogp5dVNjc-_5I%{eUN{aqGEuxG|EHY?)8G5suv?LjDl;NB+%Ux-lbX{9BkG z4Fo7MI@;Y-OH7)uvP&Jy9THJY2Nz0H9YdK;!Z@fMd`;2Esc;><^tl2|6BtgAv-p;3 zt!W6x&8>&t4x6mhcxl-~mdsx!-W$n=QJ?T%9L}hqk$zu_|W1mVzde7KypTJcI6p^1ZC?-ckJM z+POL@`uP;Hs8Js3K+W#fm3yR%VE;W-ZP;0A%(ZeIO|d49(ANVa4-FJzgz5GjPVd!0 za8*djyR5|eGi%i8XCCICLY*WoWgjmWzq)sQw;~%_!R;R$h-9Z=XCAU_jbf!nUHu4K zhc=%O&4{UHGBB0ics6)u#Vr@eJz-MAZ234C`o25YQ>nC_z(UfywB3muZ3LcpNNcJV zS~m1erP*QBs=OX>!Sv}Rwe>m851@p++0yq(Nv>CfPnivkp`+-L4zBi1vW*;42W6i7A$8*qogAUO`Vw)^VRwu+=BaRNxLrkwmi+J?byGgfL6-4OIzbh zOXlCU6}gZ>9Xh2y>7T3aH-wSJq?SN@O!apZ;33N=SqBVe{T)?VRq)g!@e~915`RaT zDC`>(JOdW$KVt@?=snB}M`PqOpTF&j=x2coqDikp|MT@g5B^`*`JWcwsZJoMsH;

tofMvR|f!UNxZ$m0Mvp*)gKF?eWP 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%0D1ETf1yMIQQP&B^?%x zPW#`t)tavkopo3hQrj_K>p$MT4p&d7?K|T4l>8jhspueCRbw$D$+1g~IYPW>W;Z%r zFN=3P1x(nZnFyL>=qR_#=e3*SU(}xTy4N?VC8{!!kO7>}FVOMsN2*OOklT4(518un z_IFR`YAw_2IW6YJ!F9S!EZx(Lq5~ECP=IHZq)Jznla-icN)Zo8ycVvvSP{+eTsPJ@ zKbKqp@|~R2h-Yq*1422PE8ML z5=+S@0Sn0s&-jXT>BpRMPJo23QEB&J%jDFk1f`9jOC!6r3?5IrGoa`kseTMU!0}x@ zQ>}38m3ko>@s1d$sUVO)&fFrr%JEu2XJaVl7gKnYN=J=BKzDgj5t8{_T|Q6<^04Of zc2qb(GxRBG8Yd=h!(%zBsa31)0k+5s;j>Q9<3UNC{@z`*kD407jh@Gz9eG%W~i?$UBJGp9A8IX%y)u zXO7@VCIeppW2Y#tCe}gMO<>*1G*M^Qkz$^lG=ZR><&+TzHuw$^lqsOp%QF zp@8?p&*5=FwRJ5kUBW2|`Y6m=5}hiyXdBzRYh*bJv5Xgl0fdZ~ZnwSdgP*)V^b3Q0 zdcF#NLOD94D~}1gyP!wbNp;tenuT@H6r7thzp9iIG@Nxp-DP`d(gQIwYTc^OrI$WV zP><(YD4THSO43U^ z70SEg7<7N?2U2rwa?^Rd8)go_3c7%p>#o9WFt#Ae6c*z<%U~i4aB4Gu`rhbHmf61P zw+Ez0;)2|xoP~Pe6+~?bAzHhYdXBfm+|4SEriM6Z$tQ}Wt`HuU^1)v@op#lxOgIjYvrqYyXK+f*_%q#%0lSITkLQ|Y zD0{(c%gbqsd%@rE$5f^4v2??aRvHO#=PVi9^F&P`GK)X4m$I*l{jg{E0pE1KuK(Tk z7UPWb3((`8Gmp(H$8BWCw)^YDL^Jk>FJbcb{{Ayw3#EG7UoxLy`cX{l6D%3<%=X{z zzdQRH%}RjW04!G);-5#2PUFtXX|b7;``-g$eCXVD&jU$u+49QDE*P1Y;()2C3O$83 zPqlfAEmT^kda=4jHug4gN(5pa2SLrDUfwI_E#Xu2YDa0TR*77dt!C4^mYXw)dT}9` zlt4xmLGH&Db%q15n9l>$(;b>zNvV5)4LuD$&Nl~}oB?bivX9{P2v~IB?qZK>-lN9- zoRVF9iGHVeJubfPrPIB#=Atal`7YV^!)4uSXTa=kxSfUj>L`E1G%_G$>@a z8+cI<@tOS+310n5aAC8!IE|HOw=-|HfBu9W&T~H#90j9&?g=3togj_0*%JxXIaY5kIfygMy13!%nMXXVNxy04FhF6<+Az2Y?5 zl_y{}P4VuZ7dwkrE3af6klo%}W&o+)& z8F36V*V#dEGzoH7w{*A1y%X#AcZVX2)I;K*e@BT)IWyL&zCCGYNYUxAF6@!K<=zbY%$PNDg3redP`dum93dl}4e;%QVBQjaI45EE6EH zawYpF>fpzP#5<0WvYr}cMBL9(q>;fs=3$%E?NVfzZ<2sf=ci%glellmLornDi8>Hk zqm8wzEo*kKgUtLv<-@b{PwRJ747A#1hiURy3QQwt|J)FQF{4P-PgJ6}D0m%=ABL=0 zL%9;h`@hq^W0ig)l_#T=PN5PRu1&|tQ?dvLQA8Fas{@dcFFg-s+COM3@jK*+8@hK= z@$P?oMM(e4+ww{NmCDIf|6s9xz5uj}GM{7E^#|Jh0+@!l|NAz6LX{XA?BIFq=6(kJ OlMs>pRQ6H-%l`lxL|7pJ literal 0 HcmV?d00001 diff --git a/fluent-interface/README.md b/fluent-interface/README.md index 8b2a04420..3ae18f69a 100644 --- a/fluent-interface/README.md +++ b/fluent-interface/README.md @@ -35,6 +35,10 @@ Wikipedia says > In software engineering, a fluent interface is an object-oriented API whose design relies extensively on method chaining. Its goal is to increase code legibility by creating a domain-specific language (DSL). +Sequence diagram + +![Fluent Interface sequence diagram](./etc/fluent-interface-sequence-diagram.png) + ## Programmatic Example of Fluent Interface Pattern in Java We need to select numbers based on different criteria from the list. It's a great chance to utilize fluent interface pattern to provide readable easy-to-use developer experience. diff --git a/fluent-interface/etc/fluent-interface-sequence-diagram.png b/fluent-interface/etc/fluent-interface-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..2c72f5aa54b7cfaa1f5a7b0d23a44a08067ba3e0 GIT binary patch literal 91556 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'o|tV&$zVkjc~#1 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 literal 0 HcmV?d00001 diff --git a/flyweight/README.md b/flyweight/README.md index e8e95097a..04d29c712 100644 --- a/flyweight/README.md +++ b/flyweight/README.md @@ -30,6 +30,10 @@ Wikipedia says > In computer programming, flyweight is a software design pattern. A flyweight is an object that minimizes memory use by sharing as much data as possible with other similar objects; it is a way to use objects in large numbers when a simple repeated representation would use an unacceptable amount of memory. +Sequence diagram + +![Flyweight sequence diagram](./etc/flyweight-sequence-diagram.png) + ## Programmatic Example of Flyweight Pattern in Java Alchemist's shop has shelves full of magic potions. Many of the potions are the same so there is no need to create a new object for each of them. Instead, one object instance can represent multiple shelf items so the memory footprint remains small. diff --git a/flyweight/etc/flyweight-sequence-diagram.png b/flyweight/etc/flyweight-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..bcf1f348971584de0888106986db7922d65fd4c7 GIT binary patch literal 76042 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 literal 0 HcmV?d00001 diff --git a/front-controller/README.md b/front-controller/README.md index c04e9b519..4bf3f2e41 100644 --- a/front-controller/README.md +++ b/front-controller/README.md @@ -38,7 +38,6 @@ Architecture diagram ![Front Controller Architecture Diagram](./etc/front-controller-architecture-diagram.png) - ## Programmatic Example of Front Controller Pattern in Java The Front Controller design pattern is a pattern that provides a centralized entry point for handling all requests in a web application. It ensures that request handling is managed consistently and efficiently across an application. diff --git a/function-composition/README.md b/function-composition/README.md index 3398f4e9f..5bfef09d2 100644 --- a/function-composition/README.md +++ b/function-composition/README.md @@ -39,6 +39,10 @@ Wikipedia says > Function composition is an act or mechanism to combine simple functions to build more complicated ones. Like the usual composition of functions in mathematics, the result of each function is passed as the argument of the next, and the result of the last one is the result of the whole. +Sequence diagram + +![Function Composition sequence diagram](./etc/function-composition-sequence-diagram.png) + ## Programmatic Example of Function Composition Pattern in Java In the functional programming paradigm, function composition is a powerful technique. For instance, in Java, you can use higher-order functions to compose operations like multiplying and squaring numbers. @@ -81,10 +85,6 @@ Result of composing 'timesTwo' and 'square' functions applied to 3 is: 36 This example demonstrates how the Function Composition pattern can be used to create complex functions by composing simpler ones, enhancing modularity and reusability of function-based logic. -## Function Composition Pattern Sequence diagram - -![Functional Composition Diagram](./etc/function.composition.urm.png "Functional Composition") - ## When to Use the Function Composition Pattern in Java Use the Function Composition pattern when: diff --git a/function-composition/etc/function-composition-sequence-diagram.png b/function-composition/etc/function-composition-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..4d8410d2635dd5e11ae8c7336087e412a673e6e3 GIT binary patch literal 34500 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