From 8d5cb59388a9dd4248c1a4a3ae7f053500160c79 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Mon, 7 Apr 2025 22:14:20 +0300 Subject: [PATCH] docs: add diagrams for marker interface, master-worker, mediator, memento, metadata mapping, microservices api gateway, microservices log aggregation, monad, monitor, monostate, multiton, mute idiom --- marker-interface/README.md | 4 ++++ .../etc/marker-interface-flowchart.png | Bin 0 -> 84645 bytes master-worker/README.md | 4 ++++ .../etc/master-worker-sequence-diagram.png | Bin 0 -> 54577 bytes mediator/README.md | 8 ++++---- mediator/etc/mediator-sequence-diagram.png | Bin 0 -> 35209 bytes memento/README.md | 4 ++++ memento/etc/memento-sequence-diagram.png | Bin 0 -> 43112 bytes metadata-mapping/README.md | 4 ++++ .../etc/metadata-mapping-flowchart.png | Bin 0 -> 74397 bytes microservices-api-gateway/README.md | 4 ++++ ...croservices-api-gateway-sequence-diagram.png | Bin 0 -> 70941 bytes microservices-log-aggregation/README.md | 4 ++++ .../microservices-log-aggregation-flowchart.png | Bin 0 -> 62037 bytes monad/README.md | 4 ++++ monad/etc/monad-flowchart.png | Bin 0 -> 64107 bytes monitor/README.md | 4 ++++ monitor/etc/monitor-sequence-diagram.png | Bin 0 -> 77722 bytes monostate/README.md | 4 ++++ monostate/etc/monostate-flowchart.png | Bin 0 -> 55664 bytes multiton/README.md | 4 ++++ multiton/etc/multiton-flowchart.png | Bin 0 -> 46395 bytes mute-idiom/README.md | 4 ++++ mute-idiom/etc/mute-idiom-flowchart.png | Bin 0 -> 51977 bytes 24 files changed, 48 insertions(+), 4 deletions(-) create mode 100644 marker-interface/etc/marker-interface-flowchart.png create mode 100644 master-worker/etc/master-worker-sequence-diagram.png create mode 100644 mediator/etc/mediator-sequence-diagram.png create mode 100644 memento/etc/memento-sequence-diagram.png create mode 100644 metadata-mapping/etc/metadata-mapping-flowchart.png create mode 100644 microservices-api-gateway/etc/microservices-api-gateway-sequence-diagram.png create mode 100644 microservices-log-aggregation/etc/microservices-log-aggregation-flowchart.png create mode 100644 monad/etc/monad-flowchart.png create mode 100644 monitor/etc/monitor-sequence-diagram.png create mode 100644 monostate/etc/monostate-flowchart.png create mode 100644 multiton/etc/multiton-flowchart.png create mode 100644 mute-idiom/etc/mute-idiom-flowchart.png diff --git a/marker-interface/README.md b/marker-interface/README.md index 1d242f5bc..c272093e0 100644 --- a/marker-interface/README.md +++ b/marker-interface/README.md @@ -37,6 +37,10 @@ Wikipedia says > > To use this pattern, a class implements a marker interface (also called tagging interface) which is an empty interface, and methods that interact with instances of that class test for the existence of the interface. Whereas a typical interface specifies functionality (in the form of method declarations) that an implementing class must support, a marker interface need not do so. The mere presence of such an interface indicates specific behavior on the part of the implementing class. Hybrid interfaces, which both act as markers and specify required methods, are possible but may prove confusing if improperly used. +Flowchart + +![Marker Interface flowchart](./etc/marker-interface-flowchart.png) + ## Programmatic Example of Marker Interface Pattern in Java The Marker Interface design pattern is a design pattern in computer science that is used with languages that provide run-time type information about objects. It provides a means to associate metadata with a class where the language does not have explicit support for such metadata. diff --git a/marker-interface/etc/marker-interface-flowchart.png b/marker-interface/etc/marker-interface-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..289a2cdb6233de2a9ea0b8f76bca7e1864a287ed GIT binary patch literal 84645 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 wm Master–slave is a model of asymmetric communication or control where one device or process (the master) controls one or more other devices or processes (the slaves) and serves as their communication hub. In some systems, a master is selected from a group of eligible devices, with the other devices acting in the role of slaves. +Sequence diagram + +![Master-Worker sequence diagram](./etc/master-worker-sequence-diagram.png) + ## Programmatic Example of Master-Worker Pattern in Java In the provided code, the `MasterWorker` class initiates the concurrent computation process. The `Master` class divides the work among `Worker` objects, each performing its task in parallel, thus optimizing task processing and enhancing system efficiency. diff --git a/master-worker/etc/master-worker-sequence-diagram.png b/master-worker/etc/master-worker-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..e2e28a262646ff97e4aeab26e8973050246d0885 GIT binary patch literal 54577 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%0D(<1=mayVxbeG~c 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 literal 0 HcmV?d00001 diff --git a/mediator/README.md b/mediator/README.md index 628d976e0..f9650d3f1 100644 --- a/mediator/README.md +++ b/mediator/README.md @@ -33,6 +33,10 @@ Wikipedia says > In software engineering, the mediator pattern defines an object that encapsulates how a set of objects interact. This pattern is considered to be a behavioral pattern due to the way it can alter the program's running behavior. In object-oriented programming, programs often consist of many classes. Business logic and computation are distributed among these classes. However, as more classes are added to a program, especially during maintenance and/or refactoring, the problem of communication between these classes may become more complex. This makes the program harder to read and maintain. Furthermore, it can become difficult to change the program, since any change may affect code in several other classes. With the mediator pattern, communication between objects is encapsulated within a mediator object. Objects no longer communicate directly with each other, but instead communicate through the mediator. This reduces the dependencies between communicating objects, thereby reducing coupling. +Sequence diagram + +![Mediator sequence diagram](./etc/mediator-sequence-diagram.png) + ## Programmatic Example of Mediator Pattern in Java In this example, the mediator encapsulates how a set of objects interact. Instead of referring to each other directly, they use the mediator interface. @@ -175,10 +179,6 @@ Here's the console output from running the example. 14:05:15.083 [main] INFO com.iluwatar.mediator.PartyMemberBase -- Rogue arrives for dinner ``` -## Detailed Explanation of Mediator Pattern with Real-World Examples - -![Mediator](./etc/mediator_1.png "Mediator") - ## When to Use the Mediator Pattern in Java Use the Mediator pattern when diff --git a/mediator/etc/mediator-sequence-diagram.png b/mediator/etc/mediator-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..e79a4aaec9ef201cb1b887566f3f97090930e6a2 GIT binary patch literal 35209 zcmeFZWmKHY(m#p}PGE3?4xZo=+}+)spuyc;f`p*KJqgYr!QI`148a|OTX4IR?0w#I z_E~q`yZ#^Ur~3}intAA_yQ;gos=K;=H4~+xB>e)F2o(kf=7p?`gc=MCyaWskY!xyh zv?S_%0W$OhU?r+33Ip>k4(;JB0`z~7nT(nu42%yg3`|fM49p$0DCj2)j5{j~%)SW> z3||@y41rTtv#J2}fr^EWtfitN3_bK783qm(8wMVF2Mhg!iLizN{JDpLfl`9L;PYVr z{WK5mUr*sB^5Fk<4_o!SqLK~XJ(P&9wT6zHj-mpenWH`PTXRQK3uZ5Sr{5J|1ibj5 zxAqopZ$V!6b`Gw5UV@Z=YVbkte;2b*g8o!-vlXP&QB(nmJGxkaxR_a)St*53K_HNT zi@7DAnuOHf&7uDZQoeI@bK+xR@$~d$_T*r8bg^P#-eU~=_#aC_^; z8_5K>?`a@#FD6k%>_qZ|nnt`47#Z~kp0Dp6SlR!> z6FL6j_B;cZiYhL@5QFJg9hd?Xxf4N(`1qXD+>@m-3)dl<)REi0^u>WxdN79Ih;(jxn z2>wlNX^qQ*ktn#BI>lIHdAe4Oq%MQ++GZvr;)O9pczVAYu zxJVGONAYU*7VMk5@*5@30SLr+LvBv(UfPllLGN92HmK5*g%=!1Sp<&mHw73&0U@%T z(_ZVZg@Ep8A3*Hf`2bJly))>byIMRh=;bO{zb0-$ z?^?X_3XFxKq1egS?)*@ep=saFxfup+tyT%gJ3j-{1hd z;#bKZtiHFup|{0rE7!@+IleTw^S0BjTr%Sggy(oMH|XWTq*{&Ra)uWHN^BrA?h?vd zIFjd(1zyY1PT8?`ciRoafzPsE38+*wJku ze6F{^8=Nb{80@x}tiBbg-AZ*@PJhwNZ<-lT=qj_o^(r}_+;ltt_(g%H4cvgRu+a<1 zSGFp1!DlkJ?_12;ff= zH9S0o7U>D^x|zY`u(kxIyuG=rt9Cb1b&|cXqXtUA*@q7d-O%yNyXYA-5jV4sr~=FS z)DaSbUS5ylZ>|Qnnl@c$3ZCCHqvnA;5R~!E;iS14lAp8Em|uJ{<$an>Y8d{y#O3MLmf$;%fHbE5gqVAd?Tl^Vk*f{36EssfY-Dw~axKHpx2MI)S>$CVGB`w=rkB0LY%jvI7eQGKXfKZh9L!)%iRdq`B+c(V|AcWF1121 z$q+p&1z+j6v!KV3nJ~$ADg(Iu)Ilu}k{MxCofDKpjvt?be1#8;-8s%J)-gIT>#hKU zTJzzZA@-`(ZykjOgvotstDVi4gBjBUS*IhW(%u8QQ#-HcUshjrwMg1y%!;;wzN zFhKdz=Xj!p%Hqc##z_ZjjJ%fd{FuG$f~=*c7v(2PSnmxTLJ>oCK^PH_-F+h7bqq|! zt!|*D>%+y1+;Iz1X-fygvVJTK>blM$@LL&}xrclGIRpz5lt@tZQ?sg%jJM_;jWBvk zuqJKr0#0XLoNuR(@=Uu%3UC+z_K#^duK(15_}(S(n?o>FkZtZ}uA|@bKtdnVJJRzQ zYS;Jtum<;CgwhZ6kzj7tt6BBD0O06~lxO^UfN1qoJ630%V;ceZI?|DbUAq{&>Z-hM z!gKr9J?+KpPK^<@N-#`?|3RBcn>0POWf-lAg}Ft;*T`60uP6yxC|!temrvZyCz;Nt z0xrCM4T^TF!Cb@s>h36LD-J`Y)yZ`YZ^*0_9ONwSiS_7F8$0unKwTO!SS0Ru%j4w`;>=(GWjf4B@ZgdEmH*b2p#Cwa(>L!*8}20}he96N z5w5Ed364H8RhCd>)K>V58^pVdIt6(#VeFNIS` zWD13^VU(TX5z1*!v0#tW>tKIUX2Cum#Auk4sEkjvH5nXc7``~jYl2ujqFaZFA`E=K z*8=)hNN}x4hm+Cmb;158#N0d8n6NAGbtm%dU_tQ|;0hqb856pszV{@ky85rJ-Gf#{ z)O>fvVo@dt@Sj&HwTP$&4OxKfKO6yS6D#OW9^1Mj0lVH#KU z;JNo6gp(o_kEN;L%m!m40gI+_&%4cR^T}9``kI-KDfle3445?o;%Q0uQ>!#R^RH}%Lgnv7qoh6->kCyZiZf@?r z=8U=7gjA@h7|_G#7?jm0@v#|>?`6_Y2Q1RX1$GP^Y^ZH~Ezo_`nNQTDmZb4Z&6!(E zi-(eCt+ht;{`QO<3=(^#$--`&>Mz1?bE#$V^S*QVb5LnbC#1tjn?@v8x;+2|LsxQDI@JckEpZaFLCn3dVjq3HSShp~zkUSbsN-9;qs<+? z{G+3J@Z>=MvwYDYnQKP2{ zqLY#!3NuTBrRjb?lD@n(o;`90V=_?R?iu(l(?GcpQ%E)Xv+3o?U~?9H^BVId@vs$D zzfA1~+0~9+)OR*MT|2k=9_&YlI1Kv|yE6py!hBkEgrWVK0Nm9oCHkOjKR0y=Zw$DaOktRx2;2ZB})e|#zP@yU$+tg~HJqJA6rxw~-Tv+DP8ancU50Jjl6K~0Q0 z`eBCTm)hkiMC3W>cl_%7juAXzVcLjYLzK#KeXS9k1bj8%wrCcecdvq6t zcB#T0gT>TzU!fX$C%{7zyDhBM!+ zKo-@BiRq|qzTKQ>;8lECS+12jxt3!P?r+9+8eo7k5Z}Tp9LDLJi~jDqni^p6G&g{k zYlSQXaoYDM-70pSE-;$r>H5_?yK41%{Z~Uhv+lHaP2ex@J(rE%`a}q`D&6Y2Z+&ZE z57GRYRfSN$j&uK~?CrstDH@@^GnN3^?-aUEy5R~Phb(iiK?YB^9aQ;8s+X4r+)-2kh)d<+0~+ck5RE{#~(B|O?Fv^aa=@UB9a3z-^ za;IQTR7?*5ohEX=%iYz>C2rlk8dBff9~ikB5l`_DENVZQU}4B0KjsOYRs9jQV$!S5U(LB5j-QC} z$7UfkwtS9P6KdN_OKp|4s_Iw3l*2`ah9@CoEz%!FaTFnB$NVZvj?+VRT17HU*w3bm zv`v=laeObHL>m2Af0^%17f1D$7^isd?hY+vJx=l0MSZ+Kb2VH+8CygyY-+1pcWg@; zGB_4kZU8>!6$^lFc62H z0Bp|g(@yB>#Fgy5RXr7CgYQxsGgyD^r?5ZVX(dikD`8mjJc)*x1(#Wosw$3uFmCvn z&bZq;sTutlo*$KlyG8~r!&c~|py-4`I_XZjW%YLK*I6tcQe9Q>&7P|d&Pz8*H0{q$ zb}&{L-{~KNv)}81-PN=z0hd7uKRQ1r6TgX@8?d$~jV4vJR6tR%f9Z%}apPVNI8soH z&gbCTVThim;Pq25YcjP|)+Ra>L1%*=b|o-id1!d@!VpRDKB~dNem2|mvM%pc`h3Sc zV2^&Z@J95QeA*!T^YVOOVzM@+bgfKM$!-IdnZ0Z!0R!eo>(6~E6?bPe4aFLW^~zcY z5yP(U^Fo}gwI(RQr$-2K)S~G2YG%8+{AfvOeAE#Ibc1G_di$fkt{)6zaWRUU?du}b z2*zz_LiwrXTZxo8T;!=$%Y(C=G)i^mWa?yHvo4ZyUI0wd?Cp}UspcJy7>(7*5=6GJ zI*&dmi_S`EWf8xl-eA40Ia2+fzt=7CF6{r#Po>5^6_t@FBq4=(? zt1U$0QH{?ti2If7eB63Y(oy?(wdlPf7+YXd&of@0FXb`semKYsVVopBAQf9&5gW%s z<(RSxTqpKn zr#4P;c@KYR+}^h^KDKcOGW&dO$)UYID?c!QV&Hef_bLjldgN={|<&qi@!djDDj@T^Fu!WO?Q;sqWDm0qLmi=h&vAwj8dT zn>Atcxz(oThap=eWB~qBf}`O^TT$9M%|#?Y2DF5taL=UfKnRi0_iw*r(06d*)4egj zg?%}@Op&NSOisS4CQL2J#T!*nIwH*e#vf)5BuMz!KvjuhQ&^pr% z!mn&YTlJ(t!0c}ojZc4{G%5D;JEQ1IOMbSS<`?Akqdwg!ecd1>t;-B{;U3Khp>k{s zkrs0%Cn@@9tX}MmmDap+gC%1@lgBFQ=c#fu)xb5)6UuEv%#MJ8GV*ND$G_H$UVc)t zr0y|u&h>GsSjcPI(Pt^$@Os;_u_?A)xwvp^c7e8nhvJRa7wSn7TmoH+dUw$Zh9_y9 z@F#9SF3(>Adiu^L!F+GWixw71TURKS{3V2MBe0ozl2aS3>5W@mR-C?6KdmjQuKE`i z-H6(a2{~jj8(Woj91o^iS!lenmwU!qFhykJ zvM3j9{i*rRJf89$#W_|j!F45blXHZGAgTTHl^9bvP}i$UCout)M2jPcs>+C0;LzY6hf7ai1pFPaj|0HXF$z7QW!gANvYg^T;}*TUTyk(h2d@v8#mkTca#Ia@cpc_V~cQnZ{SBT zdV#|t^UIlZ`_0t!Wy+ec?ow$reA3YrhvL8N)bXix3Vq(NI7&X7Sf^aD4S&baw}M8z zUQsy>x<@4SY1YpPNh%6zLefcxGvL|6;>!v%{F^O8SA;9P$6Cwkl$5?(F{`Lg(bk@n z3fm^bi1L)Grb{bCVnbZ2J+3? z7MH8vqoF0U+7?cDS}u-PzoyeqWz~ohx^_~H=-EorI=cMTH63`@{b)-z7Z1ZE!3nTT zBxbSJ;-25(Kd29A-XuTv5z5l?NAZQm^jQu7;2#;;}ZTN!=|E%A>1 zJ|?JryXh;tZCbunGBpZj|0Kjm>xqmrNnR$M1P?TjlF~nt**}@ z-`=HPST>a}&sXlxPqE`E5$KGOgI|huwxrRQ5eSUv_N>1k9)jN|l}DZ{XimdYzR)cgP%$yaVli>zm}_HXy1 z)Sj6;-ayXIwQTSFGfDB&)oB}2wc6CFeLWLKeXU#Uw3G-kJd_frpBIOc1?F^Fctong zllqg5v2}>e;rf}u>T1IBKVMDvX9-H4r}SBe$~rQt?4&`59y~~O8kV7k82u3oBMngSUj+HdHH2za~}#SceSs&4R@M zKTO(ihP@1Dj{*(&w>C5~vr8?!?d4*FS~Cgwac?zqNmMK9p6}W#eb{UrgRPpDZD(dU z3y7x{sF4dN(kFehdIUFiBxBh>Zqq`}D==^fPHG=Oj^jCE_7pZ>1-i;JTZ{v%go;K^ zHRc=U+1}L(EPZo2;orU@uIQM1h^L8}xh;ns$5*Mm8{5dgU>#`n1z!i_AlUvmt=Xip zK9#V7BjM_lvk0-K%90WxN%wh6&Qih|GL*lY0$p~_kwsKSSJ%?ys@2LL=j%IMkQmaD zY38ImRaMOtv@k4MeIz7uXYb^>_hiHk}eQ%QtUk+*4})nscz+`%AAc$_J|=d+c7RxM2F56Csh@-YvuUq@!F?h ziwBpj5_a1gLa0#O=aFhJ8u;&$Ii6I}#a(J?Uqs z;F3PCnogBx(G#QkfopiNwYC0iv=WxjD>U@(nm`uqTnl#32@LD)Uou4>sX}3!h&ba8bMu_Bpz&HPvQ3k>?3djEbBHB;<6GGUMmqY+ z-n*ezt^BEvHeZ^`X@aX6@>38bO|Rz0pVWD!d8G8s$dSqXt_k0@-z>^KvGq) zNDfWw>qn5>xEZalzbc0GBF*iY;w3pqI-uvmu={$=N*|YP=?GgSblc>$E*}ye@kq^- z;^*ZyRiX4oBWCZGmXGO6qAj!G7N!2rci5RfC+m%uJ7ggbX*Agp+)1jR7WU57^yy@Z zD7FcRzZ!M4e^W;^m@@Ef5%-UYcCa-zWx_Uklc^#sb-c(U((q05YzA^uuwX3;5Q)|AXm+S^8IFX+)S#0TUhxG!(T>TS@T(E?#6l0eH{F+IY zX?1hqQ@(s2uM>s%t(LeI(a)`>V!opWTFwPjDK>o{PcR%lAeETBp7Ts}_eD#(=C2D- z6V&x@qSx2WIDOX(MQ~Jb;0T!0nBm?FP^@2;kNfhc zpH-qYIfS6C?aZ+$@A2*M;<9XWyVknJ)Z5>(M#H+;eT`#Yld*zGhXM(zhVs`M*E$Fn zBKQ8lIQ)YtO0M@(l@fKs{xe^A^3S^-9~2U9P^ZOh!*FmY3NZEg$*i4st3Dj?j-r%; z)%N@Wo@N;DkbY=M1LQnplaX~k75>_-YDU2I0ekLEb3^5gJcNY@#5Q~f&wvhQ2Z~R` z=~1;liivzpX#*m+iLV%;06}*?d36TxB|U0jGV|ZQ-=Qqb zX4oahfUmERL9;PGCo2=gnlTC_u*L{$8?uJc(&1C2{85cGx10wA6i4=A`CcY$wO``s zG`%bz_1VxSoA$#uB~6a#ymdWd*c14SCi4z_wgHb4Iyy2fW##lxRu`i8ZhSmSI=QOF zs}yf)KlP-;wKtwGmse}*mJl(FVC^F$AP%77SRGB?o(}M4D$kAK4Us~3BRLdv0)nCK z4nMlI(v*Av4B6GXKSoN1dcaMtEzz<&T417aash%EiWVVNc>kl$jsncdetKIE+pI_0 zG)mWVy}eVipi$GPR40F|kzs>c`CIygoMCLh0S1K4KQ9cg7ud}(Y_^C>BeEt$Oo?F4 z#Yak#=8UjM`*c<_sv(A0(fRGkSyHPI-~9$d{X(IWFPG8cs7o);NDjRVEA-yW{bIwr zIVMexTcr*QpQe$z<1!9`x#$I{+Aw&-a0XZCls%VX4}&3@m#%@63YeVy$?CSK*fM=t zom}m?I=Ph2&`&Ojh*@jDy;$b;Ll5cxvS3?wEJfJDrEOk0l@{AudnyRg+tNiu3$|d% z!s;NGwMf{IApkNKXJ37{ya7MDUEYeg26)*ZvlhZ+1h@Ew4#Ms&L_S=vWbNyAV!~AQ zR5=@h>K>-DSi?NQ$vNS}ToZTaNtQvssJ(TXEw1!xuKXvpv-3CXGQ@jA&PJ)S@m{)N zzLQCqEiOA0FQR89|3x+?E<0ka2s~l6riFgrNRW~MLSy?%b)`%P!Js=9l zfCJUMGULncYmi|nwlGi)0;B9*h0C;(sI7FWJMFY8x>j?M9KjkJXk?6$)1T0V)^XMR z(Md6~PC}ZV#jz^3^T^!-);0$8%7iT#p#(b6j91d=Rb=Tf6HY)zh`ZcPMaTKi`bt*g zmL@Lia{X2Seh9p6xe8)pys#wgkUnWzNk5Ymz8{s0N4H=LDjItUE3n$`d;SCgP+?-UdVM;B7?wuT(<0 zSVYOSqD&zak&WSlhy))h6@$bhJoc9*b)?P3oVzH}J-X;!2cdzb|G~0FXaG+?8l*c~ zkPjjiI^S?Bz?&npK>4lD8V8gg6?uYFo7C&&E5F4Q$PQ4?7eYvx0vxs9m$(E7zDA?^ zH>gbvZ1kOXJYQHyW|wLM)%myGofqkehtgbLMvp zO$#ai-5lEq>j#)bq_xrV{XrW4x@?fqPIt|!j_rQ{@xLnz1EIo!m%tbOXS5!e19%nr ze_tQD5wy{w^)M;VNC`$cB||Z80GqdVr0vN*I5l>cV~*Q9tU@#P`10V zw^j;4R-OS~$~U>z#VLdB7_&KV+x9>FK_=+_flTB#_r7ZWVeWg4sV@zegPdl&x`dW9 z#kLXvP{^h0*Ldo8zpqPUq6|I8pV-dYGG}Zc`Aj^Jb3c+Z&KYjS4ohJKSCr4axJv zq%5KIl-cHk3U)Lo_>^i=fJ^ArX5=aYmV?2ZG>KU8Z0F7C0W2g9@F0>W88}c^dHkXJ zUTm2P{fc^x=$;jWZ=hpk@5+urUlMK>i$`FY4FZL#V>ND17>K1~OH;Lku;OGuV#vSB zQ%m)UemeJ_gbXeS$7br~&&|hB^Y!1oxR&jF0yvFb3l$|`i&;!dAFbNdPXbvtSAX^- zQil`$Fj?mkgW`PT(@asD#!UB%AE}Bs9gF^ec)df1Z>69h-rm?E5){Ns1F?5FNk~h} z`=sJpdt&3MrWrGZvTZjDoq@uT0eBKSJDmD5d^Ld&hUEnT z{LIW4JqHPzSHU7Z%#@8gW0z2X&%jwIX@v2!eCMySdA<9G1<{fz_7Wa9hKY=XAaa!2 za&5-O9flTYwE%(K><{dIqY%E>B}iREZPX4nfd7(vaU)%1;D=}DzGaJKq#1_r;Q zT>7)5@ydeGklnuR#$e+yv>^a+Hym80{JFF2# z#l$2K*2TZlJKFrg=Z^9GgY5@2_2Iti^39X|qBdx?d?Z=eBg$?h=2HmvlZ<%>1BHuT z5>TDKJTW>y&V|gyVAtF_IUI>FHn6S;*m_e;Lq25 z`9`44*zDuzT2$vs=yuW1H?mQeNl9lyK&L38-5C{RGQU&SAmcZ+gko9h=(-3Am_=qO ztQ4JREN}QeY#N)~2SeX(T}V(EjUDB8c{Z3{uTH(6;=!JzGk=4N84L;H@pGyXr%ul# z)4x{H&GIE8)0WI@1$~Hm@y=6Q6HDK3x7nGgoNbPyUh0(af;l#Zu#~Z~fbe)BKB$Qn ztjIBkHUK>zi5x+vj&6RqpVd_`)0R{}Ht;F`_*7+h_ti6dxvn*dv`v56{>*2ASily_ zd|OvV=1bG!8Tv@jN0L+U#z3<%r(S?QXYhlI@j%~MpTl<0jh9JV`&fH(tzn2vB{YEK z5)j{icXn1gicbp|<$PN@ayAi;n|RKDp|8$9fF(}(LqC=(7~}wL zA7B_q1&bvSWJUB&WW!R*;58Wr=IgQqHL-{<*#|LMuEwv!(91jRHaFlP%fTg1k*PKn z&hC;efVhS4_d7n)L>SLuA1X?AUIGEVlgfGDM~j%SC*^c}!+#F?74wS11}YV6xR7ps+L z5|NW=*mN3VdidIpJD|xjw{_#CFl^f5%LnC7AAjG4>t|hE(?(#G5l%73Ku7Z)Z){-j zI#lL@M@T!P37VzJOnT$a`3`rvn=&Si&?!>B59W2%EfK|%*l~kMW$@Su_UTVMbzA|w zsOECsy3?HMRm7@n1)S_HoZ^x<<-<+8{3d9_lss3REM;;f$aaNGo~9?^P(mUNw|edF z&V&Tbf?|VchL*cW*7~!@)sk8HiYLRI^sQZ^rz7R^P7vzAwHCsUG*nLwwX)M+MQ)PN z`~ITR|F3;^4IUPil01(M?LYhns3Q?1h^zvf|4KfO`d`~MIkfy1CPo+P-T&uxC>j(p zNcK3W^=~iak2`WB0xd^+H!Ake-Q5He>W*Cfl&%l?2Nju4Bxt#ih#CHWarK2d3DwfV z)p-Av0wDC;d4MIV`7f?NLSYaR1n&~c|0|jAG#FZrISEZ@`Om(~bdo`Rjl=J8b_o9^ z1WahTUr;~ee{sD6K@$(+0?ZlyLFG4!FCw}H|HhKyKb#BN=9hq1A*EKmxYR%l0Qj1{ zPnG8v;epH_ty@!q>R>i<9K2kofB;QzpNyCRSVGzrVkr__@M+39a5$&qe7Mdbpuw)mM`^;v zS>TUlwO}>A>&MW|Rc+TKB{+)bp0HIFN|gS)w|U5uV&>B$ordV2)06w=Yj5rFe}msR z(9^oc=gZ_iO_^TgKV}{r2~F6+O;{e6`mc1{px;Th@c{vVTUk@?{y`}(T=cO8aC zCNNu?Yr4Crs-8va&5uV=S5SH$6nr_ZQPSS){mA{q&~*F$vlbKNFIjX-K`q^GCf&nv z_$s?)t9kJ_Wkp#72gv!L3#htWyc)DYBXvmU zNP2fx)R=vLA;x=qC~vVQYc&}E-D>0pts*hCu#Jk-9oBz0RQYE>J*2$4ae=+~;6Zrw zUec9_YlmbEz18DzL49s^YL|tHDS3?lYPgw+-$J|pDZUto;jgvYMELh&d7!Re56zC1 zsc7C4K3`tSrQzk3rOo2il0tt8YPmX09?0?6#eZsNe0LQ79u*eT7QK$D%JNa_WvRpn zF^3S?P;`7rUK^ZP=I|6}w@|H!ak8SRB)G?;+vX4|z+sW0P`1wNG)6%}FSx~Mm|x8^ zm-@CblpOoX|5|(@(PQVwr|sgE2wNkZidI!Qx&5cR`n=TT^m~iVE5X*2?o&RqWLfBj z0GdHL6_ohAA`Z@_WqqFOt9ID5+*>RwQt&-ijf#$*KC_*Lzic6YRu0EFR92$~u_*cL ztKZDcrVa};3n`zhx{X=540~(8TNf}rWt;kJNSx?`opw1(GBh^!>Hg`&l6P}PmG5d_ zpLR$YE#TATe!#(0iT}GQwTxf!cP#fNIpCF6@r4GN)Ly^~qoarw+?oNk7N$X3# zSQ^)tne{&*u|ff1^5_&_TnDb$_fih1X$#Ngn;P?b8RTXkiDLJ(II~?W1f4A)`TOHh z4=ed4V7r5+ZzqaGf!S!g7b*NxS_G{n1jC&(TmpmKa`MS&6TD-Zb{D@2*}XS9%r{<|#{HzRoij7nip% z7~yNb_?=t%nKd>Jwp)%pzlUZf0cK!j8>jlt!y98QupZL@$*lCauxl2HuxS;;$$?`B zOHD^E!{$I1HHT1EK@rLep`BMu6$^FN+j6OO&p`rb-L^iZMggM10ZyaiQp!jC9zR8zcCP|aAa z2HcjL2%_)19$Oa;hSl_=keMjn*o-TmUwX!37GlL}s3WsvI~D%o0Y@u^+>JkMp^d?+ zqh@m2Qx;{pfeoClyxQU<7CjD=QVZLuE&_D(4GzDtRpb7 z)-I=FbFy8z{YEO9WQO#zUt=i0SHhO9;<0?uWB;-1F|IV;ax{v{aIY$~SxIxQ(^Hsf z(!TpwbM%Cu_|kOph(@2N`y&Dadf}n})g_5wHm2ly7PqnMdvu=WxH5Bv+syNRbpM#V zRTduGR==|&Om+obk;>-Yw`V?E>95b{_TAYvb>$Rqyw^{B^w#XuVKFC@#m$mx$g z0!*=^*E#h-)7-#|HlxwiYDtc^W0ZqjsciSCrOU}riRtMDzNwbdZhqd+JQ@DP($389d6N7#^bUWJCsjD*v7~p? zL%Yt&@S(Z!P_Lih6d3VTsdhZs?Stp4-rXyW_92eFzQFy3E| zLL>0ieG{*N&8UwQHSB}lQ)hnQNZ|2vB|f4QiQCbP=yBs-?gA=+HM7AXb=TNm9`TA_ z&B%LS6q@j#vh2%l{;Me!rFSBgqbOz5b6awESn;`4K{=x3`kU2OTb%G5X5L_j<+7B0 za97e7Ph)RA=V-k+7w;zaQogkFUiiD<_NpqG@y456A5vUKNo8TThMb-2`s$Bs zpFLM5qVtz^F-B&dm#@=ut}eTXS!B#OAJIB~8T%ZSHyhq?l0y>vo}f~&Z6pUAunPCB0NTz$qcvtDKe&MLwg z;fxdN@9}|<^#M9NrKnXO1TW5sr({ujuZsjL=Rpox=M^3&W)n6HdFeTtn!G#wj(2E~ zdU9c3ZLld54X>^~D!1JVWt)%NC*_W`@@!(0Bb-K%!2NLM`NqNYSV`;3-4uBmHtMmH z=2LEFWpen7eP93fJUR{hFRw1ipDM>RAbE3{bku(i0m!n@q@wrc4S-6uy%=?x74{bl zURD*i=}N?|U;Km*NZVjY)QdnGYodo!2M(XEg&)NTBF)0c_W5W@{8!3 zT87Dd&(HV-$%5j@k9DNac8zV_min3WFRzkt;@r#i_kXmMIs?pV^8-N>| zo4-Q2uHIg<+2%;mJBL;IZ5#VUN2q#@^MhTb=fMI6pPxo%S)K)Ff6<549dPg2`xco6 z(IwZR<1^~0O(GtMGeWc}mcA~9ncdBwCkGxNxg6B;Ba=lkE9`~5hu!5+M?}juf~+;d zb?NMxCa)2GP16xqY|_7IJ~7MKfE@8}=bJ?|g<)pB%PI;3c9+iDF4yqHX4@*1`iea1 z>*@em5xyh$X)$FSJh45HB4|C&UQt8*RkgHa|ftjZMm?;I9Hbwijl!BQSY z-9J-3#vPW&B@o!=gCS&(@3%1}s0(rR#7h_Nu&Lg(Z96cH_^-CA(=*ixSh*^>GGF@v zvypGd16-e1NX&-G#Y!^~sLMZpWpQzB3+za0czplb^%J?bUi+hSdr7!O*(eG976I;l zc?l8*7*0EIZ=1YlaPg_LF8p;Aum^M5J+mI&$Ga4D$j8mDps(p$b-MlgFe3?EhPl-; z2!BA@EBOjLak&T6BNe?KAB*ox|AGd{p~sI~$WD|>$XHoEJaH;}OtwEM!Jxq*LkTvb&@jZW}o!3m)Ome`VH*LOcf$>^g#LBmCEQ}ZY*G=V9r8+ z{Q_9=j0K%|HfG(uHsROwmd7J_zY7J=d?|dW_t-Df3dO-zN0jqz*pxwu1>D z`6bTi?O2mS>%6HVw!m7~S27auG#J|<8k-l8&QIf$IY*;Oos~137K|xQv@o_*V$JGq zQv7q2=_R2zRgAdHT3|bz-qu967zSez3 z@KOsUys_&qGtwqGE~7v^b;u;15jW$m!$2__Tw+2qBKRpO2Hp#H3Qlc6t7w<4>PLYC zI5a!2kXw#T+Nv_Q-dVOmkPi}kE_oE{PnMX-i@C&P^0H6$kWSorgnX9>t;<$AY81-V zyGQKT>s~;x!6TygtcDoT*Xzeb8<^JM^#umzDSRrgcHi3=&&$wOet6?1@vOX9uO{aG zFzbM-jU}iv>#`b{J1w>omLOgmIc;I zy)(>TQ8YJ*GV{llxDtN$FJg8aH;~TYcWhhPUTDo!&s!>om~?G(RzwVMlpe4k*9k>j zPl~;G{9ucHkhccvChE`e%ewj!X-i@Rzyj$k_e{b*))rujA&TL{LHvCR8XlpCgK18E zCXv}Vw2Rq+uc)N(`A~G^!TU7xp+__&Qg=R6u6Be$xqP z^?Wz6f_`hHD0^q|o&0VcM}0EKXH7{~Ru(d}!>m)hstRCnwR|fG7CtFKy6D;u#_QM+ z&oU_=JF($gag0tyH4rs>RKBk-w-~5c-ly;m!NyB|E9VW%I~$X;SD4lpR&A}_aiXr-WiXRf2@2i@`2+EYyk_%--o+4D1zgqL0AJ$ezu z%T8B&b9kQz%led(KzJ{CzeIplVsSyp0S2dK4+TcGC~Q%C&X;N=(_fs7ww~WUv3!`D zkn_X)dC`N_H=CMOSwz=m>Y86o`B`mo=2vO3^tI**1yNz)8WUb59uKa_X?Tm$yIc7F z7yEN_?mfPdO2XUJvg*4B^X1XiKchw;Ej}}Tri&lZeKrN1W2eOxGS<vXp6#VHHrmXm(MExC^G+6%v& z);1Jw6tW>YNB!_dyyv@}tscgdG(!S99T_xpF|`(PrINtsv4P$56mnq%$qgAE4!wtl zlr(XEWa|bnc42Zr!Oq`F4-vZt| zy1#<=LcvM_{AVOb=VU>@jpaAR!dZM8{b>Hx;!$N@G{+w|k<{DgyS;-h-xpV9nAi{) z_-sBZK-SPaXJ9Yi#NsG;^HgHBSG}912A#Bn;VTH*v{DGv&oPRv-&c`n_G5TY=6Ja~ z9NaQQUlevsVy1N?*^>0;`8w^Q%hRpIx%FtK{oQW!lGtyWqoC zh{U@%-(tq`%%?f@vlsvREr4$Kt)WV!!hvkxz880r-!^A7WEHUdFUzlgm3&hg71Wrk zq;2~>I2ZZ90fL0z0bOjLbbIPxJ>a{P6$xcUKc8U@?bkqYQrzh zQ6(X{eorw^X`^1U3|W$_{{sR5!eJ0pO&Y5;u&Z9c>I7T1U3_?Gvup#e)=ExgzJZJr zmR9r47oLgQAv0>SJY5UvmO%&}+dSHQjPV(rNb4GUL0X|je`hiTM^Zt9{nN~j3rwZBNS`Ok^Zqo<&;dIad+^5Xs73`$@9%GI{Jumi z06#T8v(s}$p(XbP>9EEHF$vYVmzsP!e#;@#nF0{&DuL?^AHJ~~QL_B{8=ZF|iHeWa z8Uz2_dF8S&o|5<%nSZ@Y@W7&eLGFP0;rEZgXrwtbNSLs6Z^!@lp7pLO5f88`-*Y=i`b;$8}G~d%M3j*C0};w>SSyTf9-xOJtbg75X|+wGFgpJ9cNA zBGwjz;LcxeVKD=oAEv5dLR{y?hA2u0XqN#0z+O$Pb*+uzcf#koVqR^nhRX$7K~bDkP72_?5Uwn*qyBez3_`vQJ|28+eMY1+ab`;d5-@!Ko`pwl^yJEh)jN(-5M%Qij z$LOGT$N{ItmXrikX2Z37B*2(`->IbZQQMSXN_)=0bzQ|1k^m@$uB#fP6amVAFZ^%C zKx{(H3O2(w;S8`wX6p;CU{6h`qL+T@Ir-b}LA@wx#{1v4-xLB*7>PA7=h7}SYD7Q% z0AK@ADUAUCHl06qiX{)-NlaUEUeNuC#8jcdUPQMUF7$YW3Bek18#zdstwIrKAh>*7^X`3g}#cUe8L97{25lT6HO=5w9^sq{Y>Uup8p+tqJH-^ zP}1e3=IA#86LC0#u^$u%9K+n;%`c?qJKjvg(&x}`Yy|-XfP@We47#5_X&x^!`)Umr zg-RtyZw3qgM#%n+BWD31R=Aobs=5a6B|iSa*XUrOo9)lx4dl`P4-sl)Ot^bj7aHyk zRss4EJqQY{PkI^7p}_0E_mMEfVDjB(`sau1>}~pKurc`T{Pbr9nXHl9X1u zq)WO(q`SLCcmV0{M!FZ>$f8p^mG17^H-hhe-hDoubFTC0{Qa;lSkATX8Doq&#&3){ zq22emsnc}Z)?!}nP-Ej&`e;**g{^dQhD(5{uv`)E12Pp#Kao@0d&)z>M0E1QCdbtjC>#w^B{h?$l8uG2>OIKiP3^5woTN4L=QurF(|lLTVW75clyplS@tyiq)IT#5 zL#@Fe@3X=BOs%k(vO=>F6eB1rKhCnIy?RQJ1Gsh@|lN(&&y4HPtLyZU9bn=eTOq!iu4t)$gR zMG8P((Gzf3#Sr1%6cm9FYZiPwC@?|K)@lHcV@BL$kJshsc9S8 zfpLCa!MD1~Vc4BX(N|4v5gkjD6-GqDp=FoQrw(Uxd{b!Ed*6I11GZdz19|cK`?cP} z5YlQwzm_ejUxqaKHsr@faC%0TQ}-{^~0S0s|>GYEk?4DL?VXM*y6qL zg4~X@^Knzy3dIjPbbDHS z4mK6^#>q?^{-pl2O9T?b*z{)l$^Eu(JovFg1X2zoh-O>elBC?&*B!4r(sAmRR9K7^ zuhGm~F1Q{`_vE3sHuPW zM&-NRvV$s~)EzGxBsuB!+7YU)m4}Sn!r-M%^TMYB{Pryef)j9nI;2Wb zjn}#aNDNCjQKY`5f1!+S_A);=IDw6H{GSXas!-tijZ2bd*Ylm+U`{2q3^d|qT^j+_ zx|wp%-q|aAzy>75i`Bwen5Z>>aDCY;-nch4;dl`|VR$H3K8V&1?Qx*Q`C+cd?3VUNE zc6#QWq^{=|!ru277hk?5Jnr-DDg1w^{W~}^)iSp0J9E@r50Xv@7u^RqR8E|XMb~p7 zY?≀s!xYCG-b?PISO`cSBHjxFu;2o9G$G}=Q8@t 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 sj|JW|nWn=+{I|Nu1D5Uo-Iv~@W?`27KgbA|2 The memento pattern is a software design pattern that provides the ability to restore an object to its previous state (undo via rollback). +Sequence diagram + +![Memento sequence diagram](./etc/memento-sequence-diagram.png) + ## Programmatic Example of Memento Pattern in Java In our astrology application, we use the Memento pattern to capture and restore the state of star objects. Each state is saved as a memento, allowing us to revert to previous states as needed. diff --git a/memento/etc/memento-sequence-diagram.png b/memento/etc/memento-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..8d70255a129b7af67fbc4a978a9bc94100d63dd2 GIT binary patch literal 43112 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 D1sVS= literal 0 HcmV?d00001 diff --git a/metadata-mapping/README.md b/metadata-mapping/README.md index bd2342709..3ca71dc9d 100644 --- a/metadata-mapping/README.md +++ b/metadata-mapping/README.md @@ -29,6 +29,10 @@ Wikipedia says > Create a "virtual [object database](https://en.wikipedia.org/wiki/Object_database)" that can be used from within the programming language. +Flowchart + +![Metadata Mapping flowchart](./etc/metadata-mapping-flowchart.png) + ## Programmatic Example of Metadata Mapping Pattern in Java Hibernate ORM Tool uses Metadata Mapping Pattern to specify the mapping between classes and tables either using XML or annotations in code. diff --git a/metadata-mapping/etc/metadata-mapping-flowchart.png b/metadata-mapping/etc/metadata-mapping-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..88f7d9953cfae52b877511fbc4a2dec62037006a GIT binary patch literal 74397 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 ZzJ*4s|1o;x0S5e&5Rnxw7u5IvzW~l&qiX;F literal 0 HcmV?d00001 diff --git a/microservices-api-gateway/README.md b/microservices-api-gateway/README.md index 72b9b521a..4f03560b9 100644 --- a/microservices-api-gateway/README.md +++ b/microservices-api-gateway/README.md @@ -38,6 +38,10 @@ Wikipedia says > API Gateway is a server that acts as an API front-end, receives API requests, enforces throttling and security policies, passes requests to the back-end service and then passes the response back to the requester. A gateway often includes a transformation engine to orchestrate and modify the requests and responses on the fly. A gateway can also provide functionality such as collecting analytics data and providing caching. The gateway can provide functionality to support authentication, authorization, security, audit and regulatory compliance. +Sequence diagram + +![Microservices API Gateway sequence diagram](./etc/microservices-api-gateway-sequence-diagram.png) + ## Programmatic Example of Microservice API Gateway in Java This implementation shows what the API Gateway pattern could look like for an e-commerce site. The`ApiGateway` makes calls to the Image and Price microservices using the `ImageClientImpl` and `PriceClientImpl` respectively. Customers viewing the site on a desktop device can see both price information and an image of a product, so the `ApiGateway` calls both of the microservices and aggregates the data in the `DesktopProduct` model. However, mobile users only see price information; they do not see a product image. For mobile users, the `ApiGateway` only retrieves price information, which it uses to populate the `MobileProduct`. diff --git a/microservices-api-gateway/etc/microservices-api-gateway-sequence-diagram.png b/microservices-api-gateway/etc/microservices-api-gateway-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..9186b32322a781342e9c02284485ebe3b78fec6c GIT binary patch literal 70941 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 IdO!640Gdj4WB>pF literal 0 HcmV?d00001 diff --git a/microservices-log-aggregation/README.md b/microservices-log-aggregation/README.md index c23b1fe43..2fcef9b70 100644 --- a/microservices-log-aggregation/README.md +++ b/microservices-log-aggregation/README.md @@ -38,6 +38,10 @@ Wikipedia says > You have applied the Microservice architecture pattern. The application consists of multiple services and service instances that are running on multiple machines. Requests often span multiple service instances. Each service instance generates writes information about what it is doing to a log file in a standardized format. The log file contains errors, warnings, information and debug messages. +Flowchart + +![Microservices Log Aggregration flowchart](./etc/microservices-log-aggregation-flowchart.png) + ## Programmatic Example of Microservices Log Aggregation Pattern in Java Log Aggregation is a pattern that centralizes the collection, storage, and analysis of logs from multiple sources to facilitate monitoring, debugging, and operational intelligence. It is particularly useful in distributed systems where logs from various components need to be centralized for better management and analysis. diff --git a/microservices-log-aggregation/etc/microservices-log-aggregation-flowchart.png b/microservices-log-aggregation/etc/microservices-log-aggregation-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..a73f948dd855dedb91edf4d92662b1a883a01644 GIT binary patch literal 62037 zcmeGES6EX`_Xdn3QbhzoK|lnQqEzY9LX{#-KzftjdoKa$Akw5sN2I9q5?UZg@4eSZ z?*sxQgar8F^StHxUDyBQfAoC^Z*q{mXV$D)vu5_1vhO=FZ`Bk?@6g`C!NDO_Qk2ug z!NG;&;M{f~BEY6FM+ACcfADOiRi$xosuM^sX8729MhitvRU90DRverU;W#*#*rX3T zI5=J}ad7tD(o?clRmEY)UK8Qq-lD*{jlH^s{o+K~;o$vs zje~>Lg#FykzxChTeB6KM;==Q9|NHv3!yiGRyet4#iN4)CJx@JV6;TTpCvG!K7jr9a zUnkc;0yyHnqS#9(D^D{T!OFkYx zJ}#^TmxrITr z{%=jr9{*|~u zq1ojFaVVoyC=LK81BFL+%W?}D;kOnWE$qA$t@5I@%#Ifqj}hky&}(>R>M>apYXbR>NJ#dl2Xq;E z);?-O)zz{STwL)bOM;|a^+&EC`nIL_f^l3k6B8cXOT;1VYK$!1oRS>VA0vww;r${y ziS%u84fBikcG}56pTdO^Q#-!6ZagApzL2xJlrig)gn_yy3qCF$kK+cYG|$GgTOjcJ z!U|N|itx>T`A^9FR1-O4Vjo`3gjU&0w(0tuidyKhzU^!L-LySirj<}ROsOHqLG0~m z@A`uAJ?4$|a`Fvo+y-eW857Eran!Ea&?TKqn?Jpa^!fpfOKtF+rkNytY4zar@XW8@ zbS~41K`zN3K3Su4S+IGRR^2;RJ^7QYuCO1?=6V25IB!VpRy ze5OwFMp9fs(qZpo^VUO2QybIET1lW~@i1+UA06-6O%c{U7cp(R{1uTGvrjT4x_VIV zR{r9dtmrmpCEj@AlvyGDdczaIibuD1qv8D3q=#`|uW1Ni+0@EPa2SzgC3`s1-vqJD zu&&XgU`+guXTUX2dW5@RP8YAcIHTp|_F|*5G4W>YeX5<;aRy4(3Gs!~RR29~?)Ooy zO?#Gn?e*nt`|=UpeasJB2Lf* z%Kc$m^Vo;~izGMQeTIZo#ax%H53CiGB>Z8>C?i=8d%~OIp?0nfV`2eOS-VH3841b^ ztBXM&8*kz25^prWHYt$0Z7=Rjt_^l-Y!>0}Bnf58RS?rBvVA{1tU`>I-m9n&@#P38 zyZT8s@Mr_janh59x#x^);5*kZ1$!!H3CP~)=C7ORGO0a%N zgz<_xhyP>x`1R|)R3F*n0L{pMBuXV==(aqXF+v!a~YE*<=r=Nw1NvY zwY3)Mtlh9l6U0I$EuC;s%jU+$nQ}(uJCkaX?U4w7S|LZ@lJhAZ8m1)a*ZF51_+Zc7 zf`_VKY@3>z(msE7m%Sdzm9W^f+SD;Ja@1eZp`)WcI9}}(^4xh#$M5Y}f?Oh33T^oc zQMOW7RjvN~`9)Ido84^5;E@4tV@O)0uByL$F)0VEuh^)qTYqMH`#^>GZQQzvQRLFF~3jjk(3{&N=v z1%18kTU*wpKY!NM+KlK~Srt9JM`!&_A)&gZr6qi8DKA2{4|(hGnZmurW|y|=>h+#^ z2?rQyM+>lS&kKisc`+zq`BiF#7+7UaSg0n47WmVGKgXJ`B1 z*D(lTsPFO{;4vB~eAr%(NerqHjNZIIk(#A2n> zYC$(*Ze4xp?S;E=9S}1f#aexH{4HUAD5G}i*n51%Z(lX*mEY&qiwPd*Mz$mqh8G6(3$&0!%s=$)s}jA zdA}6;S+y*jJKebc3XPmUG8QvtPMeFq|4jB-OsZz6*Wi|Fy+^ON;YLmzLB|6ZxteQK z;harZ|MqH1aiHGhvm)G{`GWz{_Y*&)0>00p-)Z1$Wd)oHy=h*(sYyna8et*xV_MgOq^A=XuXVxYP=6q=_PD4NF7 zUA|@yo}bsJm)x72t?4U;ErD$smO=ii-_y6Ys5rP<-;33|G$gaBhxcC`h%oo>#|K-s*Wkq zC&Bi(|BAAoo74{-PC!8IXnstWCppxTl3qUQiZpwEp|pu{c0VY5&E3vkY@Q4 zFSZK3W?D?1@7|C7PYn*dIogBR4z+bSU)y_iF;D@nm>0|Kj3R6Lq)vQW!_n^|+mMiq zUi49TF<$7B+SX7GHK#f$cc8G#f~_iG(&^-eqPXUjEn}8MK)hkYWEcoF_Vu>e?%St+ zX>F3@gunE{QiHScV#_9|1J{x=QfV+oHY1r2IZbE_Sq$#^Ke>kvMx77lsoM4Bai@*u zH8>J0r`Fi^73gox4D}yLigzG!vd<$$z4ipM1ng?8EG@&`8N^)~QyfOJo0xLfdlMpP z{3>b(S{5>FKL8qo+voxAbF@o2W@YFn4o#ko>9U+DKKcp?uY}#`g}t-49h{GA6N)_O zH@tbg9idx*&kx&c*!JUe6sWk3!V_J3qa}wS7Z@$WD&Oi&ljVl5t&b^iYq&vV_CAaC zE};JFPY&-tsb(fz)CTPQmKIwbMUH*N*WvT}Xjni6-d8p74U$A3Q2KnMbJ1mIKlpB% zm6}SQ_GQ|n&c?ELgx(vobKiyTq0YhJsK>IG!XYCSJ4b2YxrZzt5cSJzc--kN6>ZXa* zZZDkC@ONy|)~P?1bpGmciuew&t3=w_d$7lbRwPNHO-$t_x2#6bT2wN{MH(Spm$`3z z6f{v?^0zPQcKKDV+M~UxrpWc97%GH2?nn*&W@^aX+hY${G=BDg?H2CSd?AqCI)P!6 zxs`9lv^CEK{|_b8-nUxDPG}6x6CrcG#nTer?K<=@Y_XxYdrM@{V_d{*q3&gm?UGi& z8#9GyHY zTl@SupE$)?D_Ms{tue_huY`YiosPceZN@_j3kSVX7L^qi>`!VI)HvWdLGKP zE`1JnsXlJ!2Dj6p4u1ERN?(d0b(3w!tOdPj-@u3))HvOIC}Z~GR%ix-O~Z;riHMZeV0HWK_=71 zrEMUXv|ma9Xh5VOwp`gJX|&`#W(b1Q;NzP%zwUyi8rn5yVD#3pKLW z^lFdtHEFg#_e^jDceGh~jh$;8zJwM-3$miz#KY&&j#qiwr<=0@hQpzZNp4I2K)war zEFq_=%Vz({&uvG3H_JX9r`*-$F%1MBAVMeF=~HY9G_t>GVR`h3fR$t&dezxx=Yd2W zhaqJaC-J1{Hd*f0J1yG>-#{^RS+CqQzqs}>__iV`-GLem`7zN8{m|<}sA2pPss(zn zH2JfvWv%kG!@)^T`Q%zE`P>J3U8~L-Z_Ku_8HO32HJ!(xP8W|xhX+ZnK7Ubs*Rp3N zd64|&F0}*&6z(Jm3*E`s&LyKfO#oni31QB@xlrjqXk{QiO(DO9gRcy!d4+x4zMl=d zXQtHowt2Usg;681O?weIx0)K`X!vK;E}7jLVu!_GMn{L`&C}6a0649UKu=ew-0pT> zu=ykgrQhQFqra-y?L2Pw`hm{qB(Ur}YPc?V3(%$$0A>C;UB744W$$jFtGkU9j3R~E z3-1H-hGzlSdq9wCoEzU43DnsnfQErO*EFtG^72)2ecIZa=AKh#vzxADbwZ1bzyTkW zB{B>NCAFySF`&t@BnsH5?saTd58`022(Ny7)Iuv(#4%<1d^sYP3N?2Xp(+6wE>_8) zh5K#3vHJ4+d)^}v_jh^`i4L(g<5cJ_BRgCE8wG|ImjL7uvA@jbM4=+LQvv|ds4b#= zczX&s&~Qmk)4RoBY@2Wi!7F$5yvs*40F)EfBF1fL4N zYML0z5{A-sHNN~XAgXeuys3!1RA2-8B zP1sJ_t8~|NoV2R+&9<-A;~xWOTM5ow+E6{*;39tzk466-#=(37D9rei?bEM4_1$9B z`gfoBomIaS(|uy;m16pp_RmURCafG8(}P{*o{qSEqCdX3&Owckylw>O@jOV7gK)am z*bhErn!Y*`nAC|X>W@sD(kU~dv0mR^jyn0>e)V-S318-R)zNHZdvVW9&0vu<{a3YP z{c3mZIr3VYgn=VK-^y-|s9y&JQDe)p20=62MQN9Oi`SxGf7u|{CpxbG%KglB=X>b+ z3K!1l78jA@RR0?c^S3-po9xe5tpTv$U)TGR*VO2qJTLuNmX_Jdn~~xa6|dOEq4)R+ zyc0jaEMyD0*uB*n`;D%ZM2=o|`9&JmatM6z&q}M(9+P;u`4CcQWY2T6rn|zH5>8yz z)pfrCqQq?bdcVIUkCfvz1+Hlz!mi4|p~~^B{(8QIA!^j*nAG1uuyNI*jJ|?7yfay5Ff1B#0ZCuAEuwS9jO2C;$u}jJ*#s_)3f4VLx*|nEAF_&K4 zj&%n4MaYU!&LS8JPw_})IM>_HFC*u8nt+C9ijaaa-^L=TvasB=Z6$Bo%Zw*;p+`Qr zM}XBX`?5O6%0$N=WJ*)>K!ECM2l?}=%%r>@mCe{9C~s@@&epS;^wN>ZQ2@10sQ~d@-AT!BYjh|bb}=$L_njBHX?o2rKFasOPK819r9h$E z(SZnh<68oz)jnVd-}7q%h&H$l*~te%u`jaP)f}P5B=+(O`L}rV9xW8g0j15PZ9DhW z)tVj#eXM-mC-vMSM`x@~wDPPJXrZn@*W6pu1uUz$ll1ud=Nqfm-Y3m3o;v}yg5LgRN zSSZAYt4ZT($9*l$k1|mP?lJ42IrV1TNWBfH(ixD6OtPKhs?DYah9wT1$1!0QNQPB` zG_4Y~OY7Dm?}XSu{Y;yoFLny?kL!WlzSCb=D5jo!na6W_)v$M^9Wvw9VS=Yl0~Wel z(nvr{!c&veHd(?>cLpQ(HWo%9x+@@2Pka0Cywd!GVz>3FHv!+`Enq9lE4NJQHz6B8 zMv7}0HMlwYYe!q(b6`Zv@2Z@ifquNjHQ$b>m;O|FcJG~X5XukL-u#@mYLe?wW{W4w zMnf}QqNo!wf!D>}1;n$>MxQ-h)FwR8M(}eWOm&j)a;d5P4mU|E>!!OGdKr2p`-L&8 zeg>Zk#KE;%O6I$f)Ef$ple4J?XDKOu=jshbSc@OAE%z0aJJhiw>(K!YlqGnOg|>;z z4X17FHk7Pm<37WbR}Sa=IiNlL?aUPgl!Tfaam^$tSE-tBzb_gmv-`Zv$V-=~Zf7`5Vg1=xo3k+-OU0jc&T1Rww3RLTiMxidwup4ANUQUa& z@S2`a2x^!KVcupMClrK-Z{_ew6UGBhzPZg6F=9Ia5OXXXn{gkG_&Bj2ce;850?%KQ|Jp08tK%W*#Jef?or(teGwNo1!Aa^HbBBmF=#90C zer3bDLQtoODWtXc%4)NqN_GYZX1kd;n`)a@^lZ309)mOooE`#gtZt=5kKc(1gj=AR z4{TI=Sy`(CK{w^-x?4@-TsO35UNwmWC7|He;P$~HPf>4~!}Z^=4aWTKi?2~ns&6iW zF)*_t1xh)Ps~mwsjCYg82_3=l9aXqx&IMz}3ET1Ca?s)t^(EF0>4teb&(@xp>Ge-Pp-_E9 zc2S72{`wWd^ocCT0Eu0=v&YltM2F zLBgt*Z5M0&0sF(VvZ55HTE!~o{fM9M%O<_tZ%qKIbWKsSiIH_7OAe>-QyHUq?0dzH ztE`M4$Kh^Nd$A zh7}5tIy^M4fEa+@CRXX@l{^H0*^~%$J&(E+%1Qj@T@gdVB#J%Z23VJpn!qg(vQ(FGE8;ld<60I0 zb6hd@fuE`N%07N%#XHGIvtE2Qfsjo-lQ$8wl25z5i%fz&60n%vkh<=vA!jfD!Tq+5 zeOzCm06l%*v+fL(&>*P$!mQw1x%@j(NZQM>w)+oP-x#aen8n0=uT~fDQk}!O50jm5kT9P4hI^4=;_U%-GZ>2}5 zw~F{Lw#+c}v8dfH>uS}>s0*zhWGj&c+L@GkE>spU-YNhJS09HqPy%B#(fLX;j!(z0 zuadsWN5)ke*r#jA1X$K(=mh;T#;3WTxl}16M6=_Yvod?bYta+&Y{xurP{KM~UD26J za~Y%t9I*6xt@$=sXxuay-mhRbEmaAAgS0+@>zm&nvxd2?f9&{J-b3G%QKnbTuGi|q zvSG!NKCbF?Xg&HlJTNyQVAj;bDX=xx9^N@D+srobQj$k_rjzp z+wOS!(GTM2o_f9LoN(c#UaJ@z{1{7`*#*K)<(?}2+ATb$How!Js;8Btr+kH8RPPY= z)kp(fkL4oT;BH-D*n%tPP$s`{w|F#qWsqiBXcx=c-~0x~Q5AQ940ARIA-Q_m=!O zN@vUaWA5ghb>7y(*7B%ShGw}BMvj)mfg9t!U{9b%AjL!4MCB_*cELb>S5(;82`=3CV+t*5)>gw}J5Ua=3eiiAMqnBlX=qJqg?XGY3gSy)5GM?gvDu z__NQapoIYm|=ZP0NLP_(1Le1VycTRW1P-x0-^rE3*<+uL#eH2-{A zPi#_2hqt{<`(@L&I*2pS*-9edcSuy(Li*TrkXKE2Fox{L(3LVdF=A6lNKZ+Vsmxag4dIPHkv8xo#RSJG9ZP z00as8B9zfXbqg%jFQ9%BotHw}dOLH@b>@X`wF_L6Y(VkpJGr@scc9@vPxLI(IoJ4R z?5rF>3AG;$b)21Kg0DcjK(9cs#PM(0_HOw@mCZ5slpf7xYNJ7npDx5)#-!k;XM8qP zLzxb_SyOxkScobnR@Jr0e%0T|Se_4bF(}f?W$N4V+Q90+7j`DD0vh2|c$P`C ztbD|ZT%caLvtj4t{TS=3bi5)& z7rZ9Oo3wdZA?VP2=HZgp;1|>!5f4w!s}2N$G{5%0)-}7vM0|DIj}@b(+w0`Z6BSW) zwv0%5Ekgx#V*DJf8%QAnZ`IbX1DlwRO#&1ZZEGhUL3hxJE*LtfS|47p9IWo08cLeu z2w`3d6vyNk;nj^BLDxi=*n$=gmfe0IeTvL=%1QYex5?0QlWSOIgFf|}C!CCH-v*)v zQgfDP5V`R|fv}tgRW|T*37}t`P_o^av&5+gi{n_(V4ImvZ_A#oqW*e{IzG^_pd%0} z%zw7r06gFIfZolb4-DIcRa%_Z`N#(tI6q8*Tym*yO+)IQy49){(PmFe+Tp7~KY*8n z+XkC|3|G1fj@jv+wgxf)FM?iaJR4lBTe??At-$7PyAB~Zs|c0rRtNlewZ$Dm0dwbn zYjEe%d-iBbUDxe2$o&3Wv6Q5(CTf$r9GbLjmMzWNV|&w~__3H@(Uk{4$vAuLDJG;K zs6Ve3ctk7Kdjy7saDN-yeQUt``Oyr2C3GN)mC`-AX|Vj5V%uE_HKdzlIj)1A?lSFR zFaOv-Q0ZOhrdT@LtmCKAvYH|&{4wqkFP~%KA>T7y$;4ys%vVf1w?LHiE85l>Ff7#lRJG3wM*Of_ zk5d~Mzn|XC!eSQok<;4!Tw}X>wS*y*MJmmi3$}~Q0VEEvf5%juXPjQwq# zx@E7{V$MprxtK-=(9`Z+@cZcUdrCQBwCFV!<<6gSz2Z?drmdzqMM7ovo%x~@FFlZ{ z_&I^!)Lakd?t8<4$f#jAQFE=FkMVn&D^^#tg7jg5c-j!bm85uYWr*k;LYnR)=)PVu zspw{$g+lvKczS(x27b4xC)=4ae0^Dgr* zYSrhadsrq|nn7!Y4j*Hc1D_pgt$4THD=+{wW=5A@kypw8q~9e?09-bfqmK*&_Ty$d|!;YFZ%tu3D7*N*K$?5mcYbhNS8F$L)xM%js{xfykN={PF*7naR;Md-d zO3l}uKIt8RE`yxz%#K$}qAs43G-0-CflG!po^}WDv1kiq*Gfv(HnXt%t{(=mUwMTJ zlBo03U)~(}NnE!OjaQGbFE>Q0+O}agJ581YQ!nr9tXRDo1JK8X&<Hs_|@8u&qP$c^I$EPzr>W!mne84!o_^ewm>tZcdNu=}!c2?i%x zD>s-KISt+9bRbK$doVWpp5YZ{acnSYW--W3G|AK zOVAN8PIH`z?@(L9d9_eSi{6^kqot@>u;t*b*!0d>WtY}8GNOR|dOc(9+us?3-s#0xN-;MXI;V|i&-3P!k8<-Fg>QM`)vWvo91NVCh)((z`gV-3 z_$X;HL`RDGK#af%Z(^6eCdl)_NwfDguKtT_K0Q&-BVi^HV$N0zee$2OS0a0a) z5berELJ+k+gjFr~!HBCaKtORXw%`oIVQZy!HS`#{Ug%&5JTS@>;lIV-wM$${}d{%Hg!@u6082^)H!?@ zWE-L8{CcmFc>`2KPclJ7CW-kTPz1u`D!7&^aoR;2+-ua3s;K&?dlgrPn&7A@gtmG+ zk^eTBPajK%yj^0caB9A@04|<}pFmEGO$CZ9_@}+68I(wVTobjjC2H#EuTR#r)716u zLxEoXfF&)vn=1FlWwEPEi+lo`ihw*0`dXd+8EaBYdpTaW@#Qa@3ZdnZKPt5>c&XNz>c zB-`H%etYJ$GSEPYiFDr4Lr_Tz^6M`$}nme@-69r6&eU_X`(Yu}ii(Tl77A-gy znnW=+ks~LiE{mS`(RH)!S)O(Tcqh;rQCqkjd{zvC{yboUB^9a^lJ7{|Qk4NO=*{HJ zxtwD-?!{mX=W9fBZO3!!0s`U)5OY6`b=^qiAk70LFxmWPw_^0lWsuCaEc-e-*5_mm z&8*#&vjj$0u+jV)XxWVhdIqnAP11v@BUbObXV+0&__Gr+&Q;{@!N_ zBTmr~oS)GW)R`PJ{|2AnH2!9vjlbzzxNWQtb!}OAQ%ZaP)J-SK5{V$TjTY5jdA}Gq z^qG9@5mkaTaO8MNpwwNu_CyZEw6$JM)qi?O@!ih0Ubg7m`%JTS)4I^$>;7o_lL^8A zf^^j(@B5}UVxu!n-(S?a$?~shPTln$*>G{a|Gd(v<~H?S*|>H){R#n`k1*I~f~Fn( z(c|E_o50ZL`+{1!@WR+Z-TR`01A~vLtE&X-D`;xmi)L3-xCyk6SNFx?zt4^O}HpsChjA3R@C{a`dqOAU9!D!z#C>tu8rRDz#upI;9 zhFxFuA5lkepfi7M!taRrW9p`-rsprJzd2&QXryH%jnDRzGhm4sw?aIqxfj~MvB?fi zDzh%^By~PhjCjt369Qp<{F)m#So=;C-tYNLZ{PL^E34HiFX`N~2W^sLeu*bj&0j7o4q}Rp?eNoDJ+Vhck7SW|i)nhLZmRu}ZVoRK||4wf67UQkP-g z6iv@eFUDxul>aO)u1sbEV7VK(xb|%nC-&gW;NN{QM4C)*h@|o>v8YAi44ux=bd#Fq zO9Jpl!SxVo;xD74u||im*H*@ALg#FUhliOKE+YvXob9i`m6Lz;<+~6o_9_4Bl_}?$ zro<9R+SR2jDtZh-X83Vnuk+aj_-~$DA_p$muDNDa^ZzG5Wasvulid%B5B^W$|0Mt4 z^V05B4&$!$A9|1!l*0C8hn*dJ7Tz?kiGf+)ECcE;@Y4s`I}DqJxCE!~L~djh?b!cK zSnA@yu6J5y9;5!C!(CH<^=sKUoyJRW|7MvSHYi+L#BaT}zbdZx(bUp%+zk~Ga>IP7 zM_%0i>oHwRzz(qMy-$z-(2^SCrL4T-4#hkTjxok8U*2M!8NrtW{dM z@0t8HO-fg#8eAMqci2JVZc<>XkErt{Pn@O~4G4MqMHR~SdI z@5wS40;)}VSS$q%cxq>EsF0MG|HjbbcvOkQh6{4|k zy@qi~rhhCHW=hOTcH&4MX&_#gZ!i}0>v&}dvCQ3UbRfO;m(wYtuugZ|`~3NjGl}rz z?{eIQ9OKKLIt}%$)^Ck;>%8(L^8C9E?L@BefuY*ZyF;*j%ZMu)4`0z9-8q)Pl0gK%G%T=BQUu#jKXgQWE+x$>M+$C?Fs;OO&P zxG~C7roU42Qq3vv@HxJAi+^Zs!K1viP;5#5$QRrBA(gk?aYDjb81LVx(+xVIcSXTQ zlaA-AM5yp`$2(L+g^iy_`xUD-{Or8*>sEpqTE^V31pjzU>H)S-G~TkPVLeTLVQHF* zAKwJoaRM8B%Oro4jcd@w0jqp*#P%z!6-^%od`oGLG&25G=2b zLGiMXGz5>Ws^8dtZz*T%dKXn+!#sPZW)c&4ipL|+t!$4w4B7E4E@-C(p4)Yv*e~vt zY7n6cgP5O-<2_~haB5QM8}k^qUs*~`z`bM~hFY(^f6|YB&aB-JS`%QGT((Z==hNR- zF3tS>6Y~H|8{9Gd6L&XN?a38sacfkBP-HZ}J@_=MyVz8Rwce7JHD&xTqcH4+kUt^9 zwoC>qOteZN_}`Af!7F%*uHqZKe?QR$O!;p0Sjq*LJ87rg4@Hm=BgXCat=xFJ#AA8J->nMr^36r{`%-&! zw3Yks8S($+VJYbS#OTUW7u(pk7Opz-@{11FAEXqp<1}8*cUhiMjAL+OVq(E$c4k`N zLQCsU?!U~*hY<+~2^u;X0}aDz!)j}57fenG@kA-4`h1u>_Jwd!eobjfL8^VaMnCEZ z8V0Z{m%nS=3BV;KCDk#}n5U}N={Y_1Sp2``zR5o@u_1m1teE=gV8001Ci{2$F5^G+ z%+*rAS$sNll6o@!EV7|>i;Tz<``E)2!)KlFdg7nhH65m%jhHmrQezPo7SE0Zof7{w z2{Mim;@LawA56`Yco+Ra^rWTP%fe5~Tz3)y(K*j4QnBG$!=avRK(Nc$;ZDnKrM5kj zZ)(=CuNFFPpyb^!=IFlzE@R>uo~OZZQO%u2kKfS@?Bo72MmpBTc2?p-1Z)z_IG%5C zn4mAHRvz3sOv@8D%ii2JIUN=AU#p`R_3yAZn) z^#{RuxY9Z}XzabXnO1~F@r5zv>V=*M;m)i`1RQikkW@EZEXPa9T707y2^xsc11ugH zU#q;sg~vi$VTp$#&m98yY2YG9GX~;rEpar0Pc>pyn=Y|SSxAButG$3|ll5x$u8_N4 zNRiQ1==a$40mt>3W#BY(;(PY1bCU! zit2HY_Pp06S71TYc7r|LKTnlhz*2E&5@S?*F;g>Bb7{j_2SXYBSmFlU%S#p1irC|j zHuCXH3U);t=%agY;K7RwK{um_ONYvZ(qK&3)v4swx2xmM%dBPZPMbLHH#e9qIz;z& zUc@N#0S{Vk2c&y5SKi-6dVghuwA*-d^k5XAA>wniq+0Pfo8iSxs&mG2l~;N>de;VK z<3sv!+tGF6%_k#m?b*5bRzjyNy1ui9(D>}f!u~14c_LhadCKM~DVlPxahMn$&f|Ub zS-YsNw>?s!6J@R}e`hnAzK~$(J;&YfbjtO!DqXr9T9*6W=0n|siyyW1tJ^t<&MkVK zqu#_fu4f93?nND34dCUc!C!|prx|v=)8umuliDyCkHsbnFz~WpLB~++nC+Ea#P4&- zR(r6|;emI~V{zAC_a4u=P_n8Vlzmy1&>w;Z?USP6v7=lZ9E)k(t({nu#@v(2*oGC~ zWkjPF1S~!JQHMAFiO7VvvXhf))p2^RBotv{iuqc{ZS)G}7dVVKTwJ8qKo~x*>B?>M z6(PFdT13w6dQcx=B9yr|DuIJGZB~)tPucQqKtt#mE-}R1s2Fl#6VAb;N;8DrdeyOz zSkFhV;wNo~;jQIKmA1)Y(!(g^6s71Mtwxpp`@aC3tkpQ~Wf@uM-1d^$#yrSUUG&D! z1907i@;z`{g;b9m!DnGF4u=8 zoXdPP5?R&L-zvC|Mg-|$5}rHxhCfF2Dqu88pv%6bP9dM87B!kBHOz8TeW`=}zWs7d z(62O3!x>&MmUEV+A}t*5wvWFR!fZ=330qzn31-5zDg}o%F2i=g)yR#VXb6 zfa|$|fdQAshEnkrS2JPgj#^-jvDRVfgD5h3xVXs?U(v|X{=wRj$?SYyx}UYhGk{;pe~L@d|9~D zNlQk%@U_m>93wZY{{Elv928DJs?=}l5(1vH{WZTk_@VlA12hQ1yh&xq@LDM+j5rF_ zdgML7Uzddo{r=6R@EiZf?M#>9fYKD(6V(w=yA5O_{lmGq3Qxv{DXq})a&%b+cJR2D z!d4k;q7ojNd29`VcKNN1kcV9qzBTN5A|4C!mxA3aS_gC07WMB}WwOMZ8nrZ@l(yzA z70De*sEeagT2Dt7+g$_4CAW`bY1$FqZ+hm~4*Rx8T z3}XIW1A~K3dv&`)F4wqpg7)uhdE7Hl7wZX*f#bg5wXka}qe@ojNYA@u7~x)olJ{Ij zZfg6aE{pjrgGc{u{ zO!ZqwAR+e+TN^=zDIMdwNCEk|hm@c!X<<7UtCo;W&}Q%t6kNia2!Nu5jEHT&ZvaA&2GsuCyw z28P1naG7O#KwuyCT|2yscw2z^Wu8cYw{K)Ba(%=PU0*I_H(@EZ=jAbuwElE{p<8Zb z)rs+od1^cD5CtwjM6^CP*u9Gj=*EadKNVcVZt3^3eg;k(n10vW>PaMl>=jsK^B8f0 zoxQZy3*}lkPxwoyJTz5BTM5k7wA`nXfMzHFbAT0ojpGgc zPSfu`zC7%fCF8o>lL&PI)MTF9-!~K%RMu4-6BZKAP~-WD7#$eoa9UlW`C36(lY*tb zdFUnzOGsL!ZBfQ@0BoHXFKe&hy1}dFLDuAB6xo$myAPAU(5)4`vk`Eat7-@S7$qP% z?}|yTpxith)Oyk8K;5w3Lp^^*26!yjf_Fl~(_)Dq5wWUCJkHaG=~&hP)Y>CGo&W-U zkEbgtD?N}YoM0G)PzE4Sg@xNi9XVVBT@CHr_xIxu7q4!F{yv^{pLNzKa}Z2yY`tlm#tVov%s3Wq2PM3pmy~oLj^#)?=jA^JrJGzw6kTo< zfTfdj$RvG7h5U0Y14QGl{YyONK>;OK=Poxr?(Xhkk7l=FkW-sH+bO&XigU2HbA#!1 zx2eD83-7fHH`CYl_vq|cdg!hezjqt?`EQc7HE2@bWaR2P6|R7N8YD0~>-7^6{>i4# zka<49&qDrZJI8mGRA2~rG_vZ5sxWKz$I1YPPFxsFHw=+gko9i{byH5aQQeeu;zRTr z+9zDXEQFJ{Yl5EUe`5wUDE9Ci29MF4oYO;?j5)Htg^CRyynj6YNcn@54|ZD!R{pq; z8)Akp3q0MwJ4tgIaPJ8yIq0X%vi8>!68q%_og3m9MJafJpyF5_N9#e@q_cy!bdBTc zW9lrL+nTm92Rhi!{&ur71O_ws;H95)iO}#nS%R^yPLNk#mt^prttx%cV5Ii;H%Vtw4-_DgPT~N(e z08_g5jkR<#S&Sa>UPWlv2@+aan-_!`Khg)!q%Ajzt8fb_jrYvFR!;i@pU%l|M8Fp5 z0^v48*$*G};V=s4d+kF=sgTnSN7aMr+>49BLC;iDOni5(Y>alifF1D{8=RAD%6?6L z_4em`FZHwdT`J03w@n7mA#VUTu$C*GjJ5lqsqW~L}Y~*D)h+XA-vsV0KQ*nL8%8bi`HM)f%bu5-f+}ug!iD2eZU(Sia zAUNkiqtFwgzTbjY?n%R$2Ik4EpGcF3eEWp`9*bi)*I^~xYpiU0zSgQ7#1#VY6EWY7 zM)aU5AAN?rA}%iX%h0)FhMKwk2ha5R3E6invt*ChAc5UK867v}c>_kW-w!YEDsa9b zx3RGSN8gA<7b!3VcUS^-UwI!We!*E{hh^gRxkC=(#lmb&A%R6e%xV;3{qnrtb$so3 z1SpR>aUlmTH^WSR4%{Hor`XM zm5)mjNIw}IowA!eNa}q;hRPFmk#;Q_w>H%GsBKYk@7H)FVf|@1S7N)_)7-5qNV)KO zqr>+IgW}$b>RCBDYgp55oDZUoft^Ex8H{jp{f;7DhD-!p-UMIe-L!ij&bb-NnDmGlVzeb!> zQ|yK@81##;(;0N~LNW!3{ZzV<(il13M&iC>UbCe~Spcg7)yKj!k?4L`VF#Bmu)u~h zBleLc{2cVSq@1*B9TVuMztfvQLxZ{UTFuQcjKq<-&j};oDiQio~(zZwp|G> zU!ix#JEe(k_Ga54n_RoQ<)s{?xiH851$NUtwyq8Izy}@a2h6@DYB^K`KI6;4X1cER z8jrNbX;wq}A3ySEFIC(k9Jo#I9Eq~9l$#sR+J0uu^Ty{r;C$DlZ45bYR?A9#IAL7n zaC+421r1++X@T6`X+wBDiip-Vz#b*mJDwOxzWg;hIh&3Xf!Ji|dr(PTZCxBo?4~R= zny_>sAUy=Xx%^x*{w!*K=YD4=OygN32&k^SMD_U-*>mh)etcLRWMzZZsG1==U z7V;4x_G23GTkpQIY%F>lRqhAgF2OV7RD8a|-sfYi1B~!le)x<9B)CG5_uYQ-XW)0; z^5#<2mi>7bhPrv}wU<=p9j<{IN#Mx44wDXWg;_hk>QS#&NI@$wu@b1>$%^Dk&ud!p zaejCwk_t~Pv+J%K@-squ=CB@k>smTpr_15XB6MXF`cWbIX8|!~VBRoDphP{-ER($7 zlAcxWNoC+~Fhhk^p#ycQ!%uxo_lv!J)isY|_3Fo!T29^)JJ3OrOd2fqN4wVbuWcenC;k3%SPkC$wbTI?>|({X7Al=cdxa2 z^|PK{J%1;4Wx81#W}B2d8N3i{B6w5j#B((@4}0A;F7ds`4}JC;`9WBXV-k<&z!kk2 z_aqf1y~cTqau+GiZJwY&4^?+AVY1sM zU#cN*w4}LI>e#-r=pFMk0}F3e=Ru^@9JM+9zQSKzQ2?-MEan698;D(q` z+*K)$XdV|zskZQ>=&~pGv!#9nK(Wg?ReX+j7mJ&qqm7~Tw1%u6$eE)aRmojGv3S!* zN2QSuP=xCAx7~lGY-Y7ZiZRTF4w#g9p^A#Tb?B!>paMBnDy5=s>nX~vIiP}s6kV7` zXpGL@iks9r)NeD$P|8A~pH#H+_*Mhvq*dy5$$&fSGmUd($43uC?B{*fhDA(Z3xAc2 z4&Uo;KRDPH+jMS=uUz3h!HhByW;ee!bjv8u2|H??vF*Myzpn_zE|KvaZ^pW_X>U>{ zmpQ_rdn*VB6izJ82(@_b;xavueV)bg}L_v-^pXp8+aqsPqPPcKE``w&*G->4@2ku0QscSZR+hSg!dKKA6 z<~8G~q-eH(E%dcOXewJP=jYijH$)1YoT?PI9|yZ=rrp0|_1R}ka*x^uj!nBiR~o*}r`|1l zqrBfx`M%$Q)OMrWjdvXWn`$g2 zmOh&&VzSrsY*V65kzU|gZoyIc-96;MhtH}~Te*!pj&~h36Fgd>;ekh+CCBvE?xFd8 zY(o;L0+~#j1-F!mpKpn0Cyx&1lJzGt?n{-RVh%J^rKUQ5b(#)^OPCa4MxXZ44&0K^ zo2Kmm)wM?7dZSm*Opv|YZkp%z#pmZh=E+cs)7|~@8c1d-D5RKLf5vXa?l;uBNipW# z^>r_Qr3WL{Gd)=>fccC*>)N%kE6J`a8!;>mQp=~J8r#f@eQlUPXMPZ)rJb3?tzR`* zvs1#o@3+KCAM_+>p}j6acFqa5hw$?_WXLnCf==T0z+&cy-Yj5EcYPGFa->*Ir{yIg zj9qe+7fa9ROG?*jZq?C#^w?G)f5c{5qo89)-^4%7ciP7ow&!_5!QHa5wNv|&ykg#{ zGgc@4;Fmy0MU2nWyYXs%h$P~QjjHVsle04Dp*aSOM*No1w$e2_t*@oq_dk+Y?>zV_ zIuP!q8L@+{m@`?QVxBt}QprX(93kGL!)6x6xKU%b6JL1WIlbyeZs7JM6zdpLLYJV`3GEpsiJ0OAGm_DtUP89qz_SgC8F8epe%JWnko33lQ`R=OgQERM@qb#dpEK2mlUYE*djliZGitPr%m{@l#A5xDZ zefCE8h?3WJjm>Iq`eHfVZcbi?EjQJF&Ttoy$-65=`T^UPcfS$Y6@1@T{OR>dsa73` z<7JD!aE7*_p|Tc@#%;GGwyPou_HHyfup0IOPUr(+{M1#O2hzGu58rhFzQ-%3+x;~b z^I&^dS!Kz!lGasy7M;Hi%3HOjwC|UR6O?*w`FTR=RwPGhk9^(r;*~~b9;{whfImc+30!{5#p$VTp>3ttKe5O5$4!F5g+?Y>E_tDw4{}|E><&$pGH6`eYKklZlxm?QoC5+I%6eU42dYX~`(L z(Fy7AG-|*%(rwHJwOZV(|3O5IkOkARg67br%YSBS!FN(;@^X;=n-G+y0-11jHA@Z6 zfASu{ztjOXjcOt?jrEUAt%58_3d_bQtNlTD{2y88zY{gAlwf9|(h`37`tQUIFbDZ- z;8W_dloTQV$+I#2S3rE{{-4r=#|lhB_1tZ+(idOyaLPhkxdG<8BT zmqOkf63NH1)%`dSmucRot>5?Vqv~PijSWIUp@bxEr^38UJKr02!faAJ8)V9)z-|dy zA|y>YqHYs0MXVF`M^6tWKXrDq_wPV_veSJXpiiM#j6H^Im-M3UzUTErKz=) zb=fZ{AUq%Be=U~)q6W(G5I1 zfP}jX&kndE51~h_!e2fzc@+jezf#s+L9eU^&FjhMC%{cd@|}tfZdx)172C9Y!$z{k5(tSbp~(>_?r$BK@zXy z0~PbXJ_(Q%0LL%<^BoTST>7_PkxuCVLxjD?LHR$J3*Nx9%+p2vrY-$_`+r~g|7TxH zdnY%_zxq9%1w{Jy%7TLx?Q9({E(n_(GqlQvm^{zQy|LR3s9?FK@~HH*w9@Lv>!-I< zz<`o$=vYl(0i#&!PNb43W|x3i^I+yvSd(d~HnQFrF!8G?T45kP5U2T7r0~!jJvQ|_ z|Nc%2jO%`mfD66?_P7|NPe=%UvhF;v#=}MmOHHb-zsR`JacmNdtGMZh%e5J(|4w#l zLg2Z5P@OjEgE{`^0Ob`akJ8JkR|XD0a~)`l!bWe(j3aQj6Zk8d8bTSpj)|)R@v~Gw zISbIYN=}xac)9c0ZwpFwXk#h{-(0@vZs)UPwUT6~|GL^>>i8$+&+{w1HNsMSdx!Eb zesda}0bA<2r>?b%ut?0@gAD?Pfu-Z+^|VSQ(z@d0NIfDXOv*H3%!Ro+xb9g zM-O8A>SX`pj%kb=Fhq%%KXF@-#)1d2ph&PKi>F< zj{!QEDhja3g7gZa&;M)POy7ZZQ&$CY{QlNcOO`eR><;#4)#{w5V|(fd0NV=0ChO-j zUi`-~5I}+ym?Z9mJj?=ee7`?FpMDnY_O-v=*rs$??qc&*?w$LRUzsB&F||UhTzzbp z(m=W7Yh1q+LfDwi@IlHr(9(NnL6B}i#5#Gh)Zl`4&S-D3jn6}oGGC{&zrlEkXj>Tx z_}Rkzd~Fw_g$FTtw@M9R%6NGw@ayPHnnBcf)}7>-j^$E#|KPVHH=okGeD4x2ec~pi zkbeSc^Yc3iDn5&TQPqID`@~X--2%NBnMlOLQxDYdY&^kzzZ5(FZRUttBH`rRGBMB0 z3Ya%4?^b(R;IiO@M)v2gH3aQ;AF@|`5ZYht32)4HKriTnYVgFMeL6znO1U?&@0cS- zh^A#(Jg**q76C<$lSjfIbVp0}(I!r73)s2Ag+vl!v=7KnC)sykl4XG?l~TxioKncb zwUZ|_xi^||(yVF+LWQ%>GF~azGhpvWew*dsBsxq6{`urn)QwXeJRKJTB5!3tJF$Bu z`!~nt_sHPz#BA7X8s6Fe{ z_C6kKa8OTk>o0fcQ!3x?krDfIaj^!%`w!{@k63SW~o zFDuKY*0ppM?X=t{h5OzQ-6|7e4~iHdT0E+7g4-dn~M+IyDs*kvpq@N4shK(W`EI%Px9UbY=ss6yw$X>Bs;T%`NiSD|g|z3OqR!f-eGf z2D^vuN`1sF&V`G<6EyO8NMM3$|7RR*NO!)RngznQgdIlXo@fHfl|PAY^uBq z>d{<**ZW~}s}gOywuYW4tl?EW{$^Wxk-)d7I&ej>)cSl8EhWF`eL~&SPV=0q@<=Nz517j z;O1CiF3&p>mWzT0u6q)I9nEmmLw;@0sxh3Q1XOkwMzddbo$El9_V&NlCtU!wcZrj6 zu2vnxfWBexvT;e=cRGT{z#~&R@h%6+5%`*+{$v=u z*bllg$7Ap#xJk#vk8vMhislnLASuryAl}pPo{oAmS5RnZsM; zHaYovcTSZ{z2wPJPi;n3)i0ILcj>zI;Jy`YiK4CQ1+!AJO{by79}`l50d>UflO8UZ zn-YLfT7L0YOg9zaibF6y17mhJyz(6t$%y<9oqSjH$M3(WaTqLQCh3@9kwX?H`6k_R zO3wEEiLf8Cr)EhdYpYnYeZg3o{p#qYgL8XuA^fkjR#7 zPOg>S<|vPWMIm0laC8lB!em+TVMPJO^biV)wa4z}?LIyxlS$)xpf9vPb=}Viq_aw& z@@|tKu+BDKhZTadT7&z}Q|MPmXZacd`n?hraG$n|W0f2>7M=Y5{jb~Kvu^S2`LrW~ z{Wf+KBJW3Gn_vg^R>BtZ6b6;MsCBQ`b8{vVZRYKFdzQYy;SIZo&t|3?!-hlnj(?~d zrs-%J0)hmzan$9FL7u7yKfi!7^@YAxP~*)BwEWk`7JgTNG(V`I#{Pgu1C+HN&mbCu z&N(1Borh^9hGrMrOMyBeaEpcFakkCFWZac} zhi^{hHb*|Y%Wx%HKJOzwqVHUGJJ_{qdhW51IPMFvzIs!b_0S6TuB68oP99{ ziA0K3d2K!0Srp0{_~k9}G!GQC_UteyL1ML3Z$5hOkocS^%JnQYG1U#OudgT6!g_~W1J$LWNEEJ?Og?3d^1qCUH-Ip9OYMP##Yb`igF`2FnfG!Fu z6_+$NX;zm!r8cJJ(Z3yz4Ft%Wr2X=SlY4Eb>jK zW%U|fz0`r-T3DcS>^-Tzur%s*Bf_)l=rsX^`Gz#p^&9N*jyL?J z=OD3&YS@V}ZKq_hcUfB6U(TsNABs^`Z&Z64nI>h}2tEqG=5jDXGx*H5({|=QPE^EY z)T<5ShlHXBcqx(vKy5d}IX>N6*J0aVmPd+=GUnQz6Fzr$FQcF7U=+~S&i5W9?x7ak zdDa+~C-!tt)4ckQsw z@?h*C)w7-KRATIuAe3Ew?b0Po`2_D1`{|J?do=fj#YWq4j9w7|bT2RIqYgQ)Ncbx>6s;QTE?WlHY*Y)f9b;W6iw%rKBb$G zFm>_-#K&JPa=YAm0Keu&c6TM5IFaUdY)l+d2*cIFW%wCRT((;s)1^1$P*5qRYhx2c zcAqDGI{s`kC??NKfiN9#X?5tmCwlYYqmOommuXDV-zqL+MO~)9c?2BsjE*VBVv1JW zbu1H2#;@hCzy;|mDGC!02HZIwbD>7uuzDG(TSMk)H~zpk>1)-x#pGjfEhS?Gg5*>TW6!qOyRM-n@rV;9nO5`>yI)e253E7)3YUC z0wtbeDq8v+Y?_^-N`Mo!-wl7DD9k`ns4_pP07cP(JmqbEP_we`%NEMD7TupR3eh9m z=lQmMnVz)91c+UzsilQX*{=4)*pMCZbn+DNxMuN_(eOq-SN>4c-PtLroM}F+QkS%H zbjI>zfB|hTx{j;g{FPU?G~MMac7Ba($~`c9r;BaSb})bCf@|t>zX^6kv2jXQrPAoH z!88r}PaRE#;+J_G19Q<|GGPl(eH%AdhP%D3^LErjRwNMu9PHtpNEhzQGhK` zn_oN{7Wg0}rPPJe18k3Jj5#Cp8Ityh-@)%IM}={tWmQ9YEkEWDyFApfZUzSl1IoL6{D7%Ucdbgdc*fDhndo3FJr;@2GBQ#gY zyM+3AXpgoRG*);Sx!W3p(+>ydtBFw{&x>@e!=AjW>A^HKoYl*x_Hu}!1zkC@xner&eyKZCiz=$)d&yH*8V;+xz4Q6Oj0&I?vCJ5MtU~oF=$8%K=2ndM+ zPedj`?iciy_k)F zQFxJ|XG$~@bXT*2$S2J75@bP;aWTHi*+1#_Pul1Wt z8YkINewc_MWL>(EuEX$lPy&;Elo1CoX9CCyG08OAXZ<4RD*4(tIhV~k1*0E@ouSKz zo*jXG&Qpy+%BIy?&PpDO`fFf{>e2kjX+*;>^V!QWiJla0+6z%YuSTl~mkCWcSfF_! z_Ie7f5^K4G@)hY*gOTAuK|!m5wJ>q)k!Q{E$%uN~!ULW8MSj&vronz#jq?=J;A(fj z1wv@jfLc+I&xDWHekTF&^B1N&jUokK6egJ3Dkn7xatk z-+Gg8ZGJJf=5qwaT5NFXgJBO3waA>DzH4_2F*9Qb;?2XPwQH~6K59y=*cy4=;aqK6 z{+t=3>~^82Bl*RqO;UJ-d!~5aak20|twHtMKmrKKt9XI{-)~9Ihau7=q`IA0b}8I~ zQN^evgzVx{@hArTXYt$H*4!Qe&jqIlf-?wb9NY8S3az7;?#nAX@oz zXrJY60r$4U#Kda|vCxYrOVj8}2SxG27CI(H(P?GF{rKY1l9TLsM@0o36|-~v0xRST zM??m>mj0L2)lm*}x86aB54}uy|M=kED-8?^j;iFL6V-U>Vo+WGS=w8Zy?D5((8=o| z298RusGzRHxoIsg6y`7*kM5SGHw|hi^H}+Pn+=(pOOE^cRmt%ogTbfzVB$V{;oP`8 zSDV5*K8>sUE(d~8@QA%&nA&JX)v6xYCq*H9wfB*@YU+FM)ly_a zN^vusrV7mvSh?7<=3vQe;N4TBYvd*HY#&x<2fP&%E72;BR)iI)%nqQ2fJ$O+rtMH) z&m*{YGQYR{nb|F|A)$wHA*D0)D+`(A1;#8i5e5{8MoOU6vG2x#6|X9&*H@b4qK3=8QMdBBdV&aEwhYDEMUtjG+ zClMM5m!y>shIXU%vABAOyU)Ac<6s9X*s9L2V)32P0!Gv$ybm>EnuHyqYp__;HP+(? z1OeyxOrx%1B-J^<8EC~GE|GN?kT8P1ad5~Mi~dyw@59@1EoMHJ^WQe^CnegbGAnoQ z^kZ*CATA~K_6i2|r(at6`a|73*5){NY|=oPU0q6*K7O_P=`x{e782RU4eibiRX5OA zGP$%AVkA9C?O<-Ezec1h7B;iZXMpNvsN@Ty&UK$Rd+4&Gox04E8>7~&R?InvqZR#b zD^o)uU28xnH(kAx?mNuOUyy$LAmw|!4(*_C2>qc|nrNC`ZbSDtrtr5k?C(M+nO2$5Tdl8xWQ&>>2 zTxi^3bQhf0)0~P7^VLy}TT!;!+)*e6s4>55zdbLN_n9V1{ClKmn94G)Ctr(yLjd{C z{`_cA?O^;RD32J{6yDnWpN-ZP5H-`&BWavYF{BQO(V7JSdVV3B583*{=qhj&TmH8nNMJ04kC zDIsU;4b~ax=?7MA@@YEpm23}>Z|jx5P%!W})-d8p5Qg3W-W*udtdfRCl&|aNE5oW6 zYP=@Ak>!KB&CQ>f$dwZ^y!L{M!O=k#ZdsiSPCwC3%^#hoEI@U?Rj9jG%r!|D-SfPL z5e5iHh1FN2{O-eUbYgDbu&9g-Imv^47CKRvG(QvO*RNljsV22GH^=D3XOuW$j5*3* z$N(tIvU|Fj*PWf2xof2r1m8eh?PCF{KFcD24m!&a1{#x4tgoqMR}#iP|$>tZp!0kjSM&ngVZ{+sIe(>@)PF5 zvY@3EBPIrud1Lvk{G~p!9VJm&zY58PPBz2UP6Vt}TEXcG*{SQ)mSrmWWn|}+0L89H z*-_JPCi`tY+sv>$G$w51WIh}x3vhy&$=4y9hjuklTycD@N5o_nUoy@PH65SxzEiZa z#Iw2Vy2L6Zlm~t5^%if3+Hjo%-!p|> zYr(I4XEMUR8f>KZ+M^H4TAdK4N8d7jJnoHgu)l-}=3_?{Z^oi%=7<`=qxZ~ML;Kf4cdiU>xG^~zpl21$NLM!uKm(M^D(2BK$-nhW+Mn{^oc}LoyemqU zej!`_{(5q%U4zwPaYTCjp*jc1o^I~M7FZ0lGw_xhqg-NUzlTQ$MX}i-Th%!FR@&#A zDnlD;jyAcd=!One_a^I=MrHfSg;DGvcE2gitNkV;z0x1edj-h}4sJ|HLq57Wrs*7(JL~A_0D%Wn$UmGJau&U?&6)MRoe%A z=r2sz>a#b4G9X}}qs(GieKcJcG*xV0uSlC~5ZrpQrFw$Ej%+SEV5>d}pyehrXJ(qo zf8u0$FJCGb{K%!l+e(`Z%dokl3`(5hs#bIvOkTZxT`5*vTzu2!x!qWmLsTlYan#!T zakLLv_qhwf@HmH?V#pn6^z5{O&1lAsJ6f*l)M>w90wE3gt4}ZS66QgCgxu@d;3{4B z_P)vFQ5*7H$aURu%JwsRYA0=sURe*F$8!GFQ<@l-UZ(uiftHD(W=;Y> z8~TfY9vmxI=K?>T$4TdA!0%;q)js}sw~Kf!J^s8#CONFQY(&HT(kNrgbZf%iioG4m z;8Tt12eN)>vcWiRx~F6Q)u4j9p|1uwt7&xJFC(m0wLhH;YWY5_w&w7slncx1Zqnt- z6y2S57JmIRhc}?6nyHK|dKw;bVOM6@CWnO;4yCh_aYwX~Nl6Y)Mnx%pq4|d9o}@=g z+8(ivSXa+46DOhtAao=os=7?VRgk@MSTQ=rm@rH!&Ge2qe%mCL*3VThI45B`c_1{R zcmEyJs>2$xKgH(uZX;X7u>LBpKGyY~=k9w+g2e~QUZPAV=#vdt5b>|1%Q>mWuH$)( zm|$TB#Fi0-+dY+P#>W2lh>*V&F(iVEd?x{4^$#)~ZWc3%YvU&F^!KmP>)C>-It=o@ z$@9_#z600&iMS;iaBkZ6(Z_8ACQ*SuAYQW9hXu_n23i%yau`iU8P2@G%*77>j*6~) z1l@gRtE$TuD6C7s$B$P&ZFW8=cB?;+;8)gRS&?a%-aCzoRskvlBfo~i&l-@MrmZT& zJsML&IuauyTY^tQC(2K~*ReW?%S=AgTm^XF7hcn>+wf9W;?uAyAfIT}_)%^S&%w2S z!Yq6T9)^Mtsz&s(Akn{916DyiL7;_w06_a+*!W+Hl1h_Nl9yzG^Gch74=QmzOh|XxIjwz9b@DDjsQYP z{qC>952Ck$Q>w0wEOK^1rOCi&bd)}v6$$F1bd2Vo7gss=K)Y6MO3C)>jIVQb9r^h< z;-MmDJDEmG=~^E`h}T-ECq1kNBd|7cWZFG)>6N1+agxopn>c4tMSU^NF zT^*Tj{D(^2y9A!3h|B)-NktHaap^5S{8y7}9}vbSZ~wk6K$_IBT8-Oki)?hlwb4?c zp|e+7==BsnnkIR{3PNj2?mqmFfJ=j(`>zsfbf@E==o#^Z7wA(p%|5q3ZJQhjA|aiw z2!1d{KtOJm7nIg0@NB#5$(}-Pk#JWS?|h{(WDzWwy^LNkG$cftwGb~83a1NMId&K3 z&kWzX7={n7I_H3uKvfi9pIZFyKQDkKu2tW8^xKY3KO&_AfLz$b=<|PmrZMQKm{__qbZH6U-b$Slb}&w)2=R{+P69HkEC zOeWg*nVRdhX1gD0Cs66sr7a` z9yu`B!=$}q`BAR4d_lzP!ZfhGyFMX_h_xNq(_N_x)0xWcHah2=PP^#rX9Cg9Gi!-m z_`p0RsrKD_H#z~^7fV)Gn-OoeR)n1i{gzB_Ocg(BS%3Nf?Nlp%+7=6Pgl(T|oK zTeNb}`RuVSIv_feEU~?^mw|yKC#QPxqcOdBep#M*yp2=jf;WEmezrghe*9Ks=_h0n z`qaIdaqZ0iXf_E^4p9BV&w7VoCja|Bie9`dQ11o6(EjJiKQdGQJSxLOLDyTI>I#~A z9zd3Up%_u9ov$U_ydr1B8sc6I@l&z(_k=t>B+9Rwe@+*3jU%L?PEpbRmFKzCXTT+U z0fme>xlBMnxJJbN?qp}|yr^Fp-m@z`pjNB$9PS;tPPD9myrcFs^6GVFtB|D`D>8Lf z6^sU6!}##t_DQ-5zE=}ev|3jK^%Yd#Mb}SF-sF)~{}E)fzd~XLDs_EOn(?O1PLV^2 z8L*VdHMDdW70Ha4BLQv_0Gu;ew6aw5ytnG{o!kADGJkKJE^;*f`kF4mpTI!;#AC=1<5VzDC*8l zDP*X6k`6MkE9HFp$jH)m2n(EC%&3G@v%{^NNxY$2erE7s> zJL7lW`rk_g5DC0Ht)TPydmQoqqIeE^-ai>~^`C(RFObGNaUaJ9#(!Q0ZX^OtNRDUv zpZ(+6PQ2IqoKSS`KdpkP{lDV+buXaFAMsnIswu1;9b*$joLXkSDs_)^-@v14 z+uKj6=tQ66^z5vyBf!z<^0xZfc0RhgA4~l_^dmLi$Ul3QF=%BR+ZxBG^w8@QNZ{-J z_*uz_F7lX3mf{1L$#5bK-Mzbda__Hjyo`#fwr6xd1tv!xn2sOOt}!N!a{=GO69CW{ zuf3!l^(W8O6qOVObL~G^T)5Tvo`Da45^G&!eb&Pje5xE54QBPfy`_yfb<Vnx37%<5=r zHi+jY33$D(c^$P#!>uQsCrrYVKX=VdZnm=xU}SB=zAhDbkrBu4gT53 zCV?9n_B!0=;OG}8Ls3yuGXH#I*)*PJq5AR#W+Q+8T~*ol!1eZEsAIng^x(DbxRlSX zp?=rhj5YS)4dtyPXeBwjk)V8#!mp!tLUH{ zYFOc-CtS4!|JAn!&QxI6DKPvnTIso1Uw60STL4Z7nj9;v39zJm(Nzu?a5##n&*A&% zm>A@48aX|i>l{ynnppg(R>au1iup>9)rgI$#@6jBI>$;?sRLck?bQd3{IeZjJJ^sk*;T-k(^B6o~=jq<65$_;eGQ2A!1&JN0E;Jo@{6k0w zmgtxq5i!3gkN~J%aO8?g{kgT8C0-9u;>4obShKCGG$D8S4zH;sz$(Iyl4&ZLg2Poi zQ8UfaZ!?gteP3A);2o%A?DmzZkprajG19`~V%$x!Lnm4hpzD#Y9)6`xPoGYRvER^` z{gqH4^{8BUkT^Ce{N*`v`L6W)al28e3lg;3BjNPPsh$qc%2#retU3~71;j+Y&+7c8 zpd7=Ykx>6y0m8)K~*2aAVsG=gZMMq5R*RMA|-SY|-Z|}>|sS8|=W_}=8mMO>0Gh28zu|&wf zEF{Qt%nwaG>Ad0Whyggi-ED6bznwVP3NO|0)up|!8E|c3=;nu9!<|B7x9N&wRlD(p zWIxxHVJ+I*e1@gEvmGYmkQq?B2SdC-V=ZD=XbYA23Oz27!ny`k3Ru<3_1AQg#l2}b ztI*Y4%C4H&>7j#VI9`ntCiL)C2}{Jy(jS;kVfpR)uPM-r^(wopT-hIf9VR-OFO;dY zC^%HsHp_p6^Q`F#Dz>D`q}3OWcUrh-w>@dG&^_Z=yqT^P2lkRnJ*Q>V((3beWSLIe zeHs>aC}N$omJ3rlyKs%T@_9~P-iMdxb{Fb30*;3G{1$R~+7|JEl7N+}(&NYPE6rWk z$NeOpW#t+k6p~G^c-HbR8e@O1ffR(C(d2Zl@wJaX0piXsVAYPK_gBR)8vM9{{e`Pu zR0ioxkaexDmkUZ2(p|FEMDG@Nq4{d|@5_ZU@{mgv4-@;py~q#^N|-ef@8w*F{v!4l zj&%5rjc@En)>deru^}Vj!T7Zemm%9s^>)^60lBdG-TD3o^bg1`LbFrd`(v|+9$(Qf@?Z@dG+-?s^!ho7-O`O#v#p5Re%HKJAO;2`L^sVOD6beiVSoU;guu?A`@|PwJ z>;$%{7Yn2I@*gMOE?W88Xw{*Lw>&BQLVd2}0UB5yFQLJghL-BU7g$_$7?XiwYihUz z+k%*vp!%65I)P`+Y!{~Sw3%<#cz`oEOp>1D^y-?j$81l)Tuj-bEAs3*^#BFZ6cru%%&cID)xRau7sonNgMpqyQ zATC%Seq~&k3pMO4yVTu)A+kch8kjmPh@$v)x0ZOWl&18-i$}I@ zU$~m%CR;9U`Rn5yUjH%&s7zJ*Fh28DDPYR7ES$X@+hT9Cy3-=!;k?lomt3i3ZoiFI zm(SIO<$_XkeW7)gBAz(Tt`9G`!0d}m9=b|^l^b{X)bxw;=NerTTE!#r9>W6MjZG<} zsFFfQ@cO9BB*Gr2z6Qy4&KWE}vwv(k*LdxhZ>dUT8PixW@v?`SIVNslgxI9W!!jqm z0Qzj`s=rQ4e*vPrwpy-3Ayt2v;jB1zb`jnsei@Ddp_h?6u3+U1x?z^2w{KwK){#)$ zqIoiU?OnQB*}PX#2n4@Oz8wM9Qs=sdzJjgVOv1zTpo>r`gUNM}U%E-JY*N=I#F)Dw zxaH-d!`k#xI00G?7A4qMFLKohOMdlI-)?nvc=6uh7UKXZT+g70ppUi|D>+ha_m<2} zVEc=TaEl%FJ%=p0gx;Y9vn&>Rq33Y_eLbVThW@s_%O>OE9?Rt(eRD$4mV&>dM^p z^|a+C-O|I_20`=n)TTbglE)Jd-WskRci@)e9AmDwF2DeZ*OU0jLy_mgv~j(<$uhH= zhvic!eSXCx?xv7XTXor`ua~)W;81rpzH4$zqr_Y<&#_k|!-GQ#G?!!te*CzPL94)q zvxQBZaOxW7Z13`1rnulP@6)$*7w#_f$yMj+uG=rjKZC02&?ED_PK1$8wA5Da>e)~y z(G6U>xv5jY5v5UR<0?_E502Q#x#_b97t*^Ek+ZM++;MJbb0eHVJlm5_?yiQf}#F*=F1weotl`;$||3Iu;r5$!Y%0Am&Lay!_JDOS))JNUT<%TYQf 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 AS^xk5 literal 0 HcmV?d00001 diff --git a/monad/README.md b/monad/README.md index e63d830a7..4fdf14763 100644 --- a/monad/README.md +++ b/monad/README.md @@ -43,6 +43,10 @@ Wikipedia says > In functional programming, a monad is a structure that combines program fragments (functions) and wraps their return values in a type with additional computation. In addition to defining a wrapping monadic type, monads define two operators: one to wrap a value in the monad type, and another to compose together functions that output values of the monad type (these are known as monadic functions). General-purpose languages use monads to reduce boilerplate code needed for common operations (such as dealing with undefined values or fallible functions, or encapsulating bookkeeping code). Functional languages use monads to turn complicated sequences of functions into succinct pipelines that abstract away control flow, and side effects. +Flowchart + +![Monad flowchart](./etc/monad-flowchart.png) + ## Programmatic Example of Monad Pattern in Java Here’s the Monad implementation in Java. The `Validator` class encapsulates an object and performs validation steps in a monadic fashion, showcasing the benefits of using the Monad pattern for error handling and state management. diff --git a/monad/etc/monad-flowchart.png b/monad/etc/monad-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..0db0e5e12195ff16aab2232e6c63920d856994ee GIT binary patch literal 64107 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

1wes>ts@5L+fP8+00ro5W% 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%0AQm}I@SC@oSj0uQHKs7 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 In concurrent programming (also known as parallel programming), a monitor is a synchronization construct that allows threads to have both mutual exclusion and the ability to wait (block) for a certain condition to become false. Monitors also have a mechanism for signaling other threads that their condition has been met. +Sequence diagram + +![Monitor sequence diagram](./etc/monitor-sequence-diagram.png) + ## Programmatic Example of Monitor Pattern in Java The Monitor design pattern is a synchronization technique used in concurrent programming to ensure that only one thread can execute a particular section of code at a time. It is a method of wrapping and hiding the synchronization primitives (like semaphores or locks) within the methods of an object. This pattern is useful in situations where race conditions could occur. diff --git a/monitor/etc/monitor-sequence-diagram.png b/monitor/etc/monitor-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..94f85d2753f974c35f4b63e1036bdbd7fb990ba4 GIT binary patch literal 77722 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�u!GT*4 zH=n(}1<#*@1rXfHX#tbZTH~>AL07f>F7}Bf39PP1Wuk;Kw~pS88mplyX(*LHW!^R0 zAWL@O@!w5>PfG?!Q~G#Fd>8L464%E{;rC}%aa|5W)e=pqzhWHC>+Zh$(5*AC(XSC_a7DK1Gt2wfX zB)5nE88Nh%K#QKZxL@d(gr>5;iwTf5IU(Jq;Yt466s~akIviWJ>&Elb^bxVZ)z_)} zA9IdKgG=$8IfLr|SYm+H0$kT&`KaZ8diJYfB=|XGNe2`B@44_FOj=kH?lOA%W0W1F4uxA0z0`o;ZEb3}tL!TC0DVdpL^?}sXFE| zN@xQ#Gz}0M9kT^Dep`yK4-wSYtY!f{G9>h4cXzOly}b;ng%s6l;903aI97>q=0$87 zVRi`4x3Y%JSG~^)bm%ZdLh0Jd0Q%v55yD*#`m~Hf*KbQ*Qbf`-pr&G(0X=O)LS zae#@xeddpvSg| z(U9>&9wEiOeV8-Ng@@OqU)wl1W=IxV4Yx@Vpv(vLChH6G-#j9a$o$^gzz@r}od7!W z*|1ex=;V!->tkS%09odDRRaHJ%~OtntPb92FC$#F2MS}NINn6_GNxB9DK-$m=}s`P zyhJ=Kw;ugoUX`jXZ4chlfeX5?Za`MZ`nL*)kKl_%7)|~M)!(2%f@^>~jew!>TX!Rl zR5URx4*jJ8*!+g11&S@VOp`RtDJ4=zdtUrSx{e;K)G{!~KJ%x}ge{Ar7R$2REG?Z& zG+*q^Hm+JCWfTehgZR1cc^fDx@ND>v2D?i5GPPj$Wy6xZK8+@u{-mMCH!dh!u-5p2 z=dk6gV@M?3R!RR4o;L^>&+};zSf%r9qfA$!+cJ5Lo*WJNNaJeCu@xd~Sy$QSmP&i| zZ8VuVo*SAWyjKzMBxavxgjRHKEQ((yC;8g6%4UEWPRzZKF6e!&ZzM{Yjq)XcSUEmv zfZ9jc8a*afa%zG3!Mc7GJ^!l$hwADH;+OKc7;ml^(O949!l4%MvmwR%nW0Kx87;Tp zr5UKG4VtCKu58=9B8Q4FxKKzQ0u0jU`-6YY{Evqcu7}sQATpEx-<}c3*+mBuiC++> z{$d<0J_*N~*?%V@l=8Hx6nlM`mPBZH_+6e}QB94u0w`p8?T6G1+bQ6luj_5`N*JlK zCTiYr1L)ab&$)(moB#5a>Eoc@UPcp%Q#}S2=ID|h^pQqwqGw~(b!_+UoA`!?N?&Y@ zvUcY(dvz>2GBFG6M&iezgQ6ukkLo2}=cSE#NCz7yE9#W(XYJ;?!WP#dp z7yZ=h(~WBDH}cua-h^?*Iy7mXg1SJ)&ge*%MXachPYmz;_ zGhB*)kl)1V$fqaU$aT8jvcHQVuGrvylniB{TE1*Lonh+6H5-mLvpdbQ725GQ+aG1h zAE9fm&)?u1^J0d~lX!kH=5R`*b4ext^@bz_z@$FKV*M35IMmXW@2T*WJ5+UwmBnbN zZ$2-&Ku*a`4ZFeJR7JYX0t%aH&#ry`{D}C44HP@H(4-G`qarBX*SiKl>2bA~ggt?B z+Us9v#Jexd(^ys`f10XKQMv>9(r&lo)h4%X9f_Y*8M=0?(ciuW*dMyujRC$V%GUKo zqg|0gS5Z37!)^ekX*}kk%uUsTzH&9| z^{m0%-s{qMX<5gZoyiOHl#(0i5+3nd)Ih@SZ?#9J3mRdxFJ6d5kn(|9M!c}L7bo|O zA>~WMMYWix2kiS#Yd7cEt|fipDE0Q`RQ2(s4ahH1L5q2HJ0edM4q*vf`a;dM=Xaeibu0-*gS+g^mYPbWnx zO$9W4o-5NUuJ6tl`k%S6-CF1yw81hD4rUoBD!qAvNb6YLn z6`4JN!=>fr4r@t^HL~zj&!jjbk#K&jmvk1C)O5Tvrh-g5<+1}WFHmYv4?_Sdt>&(Q zGmEPj0TV}!+O#MDE8HrEEyJSRbB zMct(!%_ytW{4MZklZ8ZYA7f5sXS1cf5i1IBq_Cw{0HzV0Rhj+=t#Yb2Q@{=zJ1K(u z*EVj`;&rbM1pPpeoeqssQ9}4$ZvEM=Q!8@4sC{Il;5ORDbfjJMLSm1B7CK?@RD3)= z%`uBtDt4mN+CJ(JE`#cPOn~_TK6|B3?it^!m6!SynPauhk1ixp>P?IpRnc%hS^qRs zv{941dGN5Qmq&J<1Wv2cnl zHmJ8y8JL8Z=&KxJ*+&y2qXzkn%^3@JBV%J7?c%4KW+?+k#H0epnuM}t>*~y(%fhi{hQ^g-NfYR;^iMxH{`jJP1QDfvvr&y4oz`{^qQ9)B}ib?3;e8 zw^tUz8^(|{Q!h>NK7@V?sS!$aV5e&L-WcU7$azm!j|;XPbD5M)=sg{BXCeH!nd9$#WtC*g;;5it>-?q-^#LqYQcutK z`oR89)j_cT%g_w|_@$6_WL1A|ybkBqEAFb5Rsic}<6T)bTF*o`@0FX>qgp0;ZqaMD zF`G|J6M1*_n%lIUjhpGIVFK>yK>+B8x z`+XBHuPUQ;47yJfN=A)yEjl~+Q}m1vb}~8nfcnLpc8^_N-2$7to3rkfm`_nr_y=BI zR3ZSl0i298yF7sS?~6->Hn}JrD4G zzf-C9@&nytif)0Sq_6-bH%sC%2YGZW$ep`80r3PoR%*j_r^mb9n&HHN=SFu_IEUSS z$gJCrn1EK{O((;S~Q10#gfdfmlkTaeT#E#>OW?YL({ zCu8`%>mvTgI&=H;`ZtY%0;4KVI6LAKmi=V7GL1zk(NK1yZPK;^xBF2<&Ng51!SN#V zH}Y^PAxe@D=&2E>08m*S>l;uf{q#G*){vxx5?9ISBADrB_SyGYFB>#RLPSy&4{sac zSrYAVRFop;cKS307f!l?mu?M=Pp4(r5eqnJTC7;f*iR*I5<-TyDAY;@-eaxU5@09g z8i=44#=lvoC8~iH_|cg1lo3Afx7>+7Ybv@oIXZt>&zsAOo`t>A#I&Vgfsth8}FMl@t4UHqM{vQ9L<7bMT{)58I^H&K8cyg z@Itf#y|YJ20^6k(UE6&O3H|2k8#WSB+-WFNCT^+UJmxjM{lw+&AX0ZeJni=K zjHTx7=@z{;^9RB5*H<=9oJ>=nQYZS0XOz4jYjcfEGm@ z;Pm17i?oz$oqZ>$Gt!)Re3g@D9WO?7gA;f=d=EGlw?%HpgNm)3rv5*=&ezT9ywcB6e%WB}#NRyjQpY$;+~r!AIwE^o=P?so$=J;3-V*Sdw)&B% z2eXUrsL0m6@hcoPP?0V2dT**XwX`r`NsJmV$FDIkwiGg60nPjfOWu^I^W3@)keTZx z0oC~hoNOeI$~zO2$MG1BasgijpaIIOyi-wQYH#%h_L3vVp0K)LkT8=g6gs(bVEU3FCFhe@5~P)l&SVLD-TrA=r;-B?~#Px&kO z*|wzi+K7m(Y$<%aO{-{{V4^f2QA9a2fVo&dFU_$5vrY4RC-Bt+lkIQQY!YW>vRKxO z`bh06C5Jko@|^VMlP#1#JxN{W>B3!~e zM5JfIjmrub42Kdo49-d-AV%ufTa84ZEnIiB6a>VP9lB|o#p$~vfu!kgb})Im>FL_E zKE`Q=vs54s4ZIf^6xiSay{NyqKWL#pb%g7J6*PI6sb+0e)aIaU;pH(&^}$9pTMk*5 z@g1DT+5kxi=j1!ZI#awF93hK0ak- z#B|wu=!-{Nq_d`i5qB9Cw@`nA?UQVt=XzYSBMKEUwVYOD_Q+4hh)w01TT#~-{TFuUt*zMmD#gXIg%Ig6k0YS!M1jehF+Zd zV#J>;B$ioq;F~JX+pRG@wz!(WRL#`T?oz4c$&`Q0O{!I^);8s*Hyw z`W{HW$>d{R=)*uv<042CnkBL0uZK8X^QEvm*AXOp8eUDh1-9@a<~sdQ`h~?w*86x} zsGHllnrd|~$Qe-YeZ~L0jC6@D`-nSt6#Pu`dA|hK6MGWhbR}e(2LB@A03;&vgA$_i zx6jz|3>1F|YaR00_1b1UN#33+)Nz{OvwNnEhJ`o2_zK*RlcBaAU(LMDvh3r`Z79} z8_XE+? zkGuP%`gFAaAn~{;-3$Hq5Ph4_zZ}hLJ*TRT5t9HT`tQRA#GgCDyv-3K)^5hM4lEz< zEvgw%*A|J*N9*tGzBO+RTf0%EUmw`C+sPkjEZgrFoFDf+`^71^!z(7Asqg+3#+!uu z@GhoZe*NkEmFg-eUxirZ#j}5KIAOTFURih*7w8*h5{P5Bw!*gEcR6LR!y1heT8rYS z;ay)0gVxYn>{?cKd@p#o0Z;Yx6V7XvJ!gHC>H^@iB>)-WNZSrC;w~%(3iafSXrw2c z)(*3tWfpn~u?bnfnzI3N=DNuc*WdlBlFugHf{a`CK>wY~3Wd5xRd%rz4~SNs?d>FN zgCD4!k8mfk^Rx{;)^_t-M=%(E_jBa0t#pFTGI zdDCPUM#y9b>F};rY@01d-_u}~-W^at0VJ+|gTF+tEvQJMGVg3HLgKh>ATr2ws6GuCz(Q8m55H+d z-w%Wq{h0N`9g4z^An^J9*JmrE?|`HdcrK2fN*T>R=p&k#6y@9a`iy)A>HgeeOQ3%J zx3>PDu8A@^FX4lB1#rypH zQhRGXFNYEZneK&C7$=7<4%i?3Odc`hYg#3Nf(X!Y;W*$h*FAzMQ}MeMgH;r;gxnKx zg`$HubmFQuI$H@Ij+?UDMa6y#jo9S7Fe2BXET8)iwKXCi9vuBjk4;zeSwcxefv-9^ zz@LukyM_?p+;iIUe&!MHs8ouzx9`$>gUcG)d$f)gT^kUlh=y8hS7{`n=Q1Mmr7g%CI%!>{}Gw*UO+dkaUC7Bzg1{x=|x z`xfXm-W|e_=l{F|5#>@FXv|w5aUk+Hs{ZF`!e4>si(MlNAN}vHZQ28k-9SJu|68#6 z*KK&fVB-D6LFoURPV{Fs{@=^|-mB2w*l8*uOhvytadEgt8dCkwr)J?jSGVz&UgHUYm!D)G88Lne* ze}7qG9V!xjqpC4Cd|7iNA+u*MCdHNE{O$-Plo;el1X;RA$3-)RAP}ppu(r0QDWbO{ z&?IJH<--+Z1z!xnH!t5%8?%52{wdjr;OqPJ<7RTfXz%koUsuqTo_X^aMS5@*Ew-E| z>ZRTTiC@wB3E*3wJURaxSpNy(Kx;SDK*-gf;$iqR7|{qW0~K3VBZTnf<$DXH%?>}_ zPX3d&U;c`c=jo^Gmy9G5H14!5P6q@J`QRQx00Rn^h!ooeexivf7`%0=Xl(8+%CD{3 zdl5E0RP~lrD{j?cJ8MHE4DP80Q1Cxf4oaG{H4wV_ei!f4YHSHD_+F9~tmOp>nI599 zSPAVuLKv!r�~|oDBth6C`>X=Rn^qOub8BTHBAx&ZVjP8w=m>3zR{H>=;d4cZ;NtC_Ld z*=c+@WKhe)qYhTK>7sD@0@-s&TPQ*db>+9SZ)Bg;^Ez?jvuJL#Js+YH;PgGi6Q&FU zkwA2Rf@IVaZ*9LYu~r$zt}`*Fc1+d_B>`eHp%b1z#RJ5^!YMK=&=bbmY!rX9gF0*0XNf}3mBdf~ zijp04e4v_jca=@qQC`3~F*IdD6R4``rDtcR{uzv=3Al0O(-Eb&zu)lDCemeqzK9R! zxbnuDWy-rAXmLuzWTqFduM{Y3*mAXuoN!%IUkn@PeAJa!6#SAMZ^aZ{gy$P794(#iR*u!dbA%$Vcwm)%+B~fS>(I2CgotFurI?QVyYyytDn`w-q11iZy@L0AkIsE zG?4F)kD^&=k}&Unc5}Lm$vQhT1D@>}Jn4y!tO!}{418y8wX++?cTk-$*lcm&{c;hu z=*-A>+AV5ZI`52ez|F-qL!Rwrl&J*YDNWE!rPM=Ffr81Bsw)cjZ>es#v>rFbE;dsiTb;WRucnlOC~zr) zqJIMXp(FFsunY)oa$;iknwHTsR3ZWEG@rr-EgPPd$&1f`3`|7u7oR8-pcGo~#Kc$v zMFkZuk8k!M#89MZ5881qi1$@{1?KKlWy|UGPTPQ5Nmx%W^}{1Bj-O-A#&10w2KY{) zE<A=A5)3(%y4hC$~=(|bw$ZyWk=3{vOcP2L!)b}9_;@i`6< zv4F`UG(M)c>}V_L?YH9LpncOeAi6oe;$8Qy^O*ZlRp1uS` z1k>Z(3w9cME)|pJA3vN}GARfg`SmB>B;M@aTf~+UF?WByoY#C~+}&QbUfFY+TD^DX zeGwG-<4Z+!1W&L3Gr7~R--veUn`@_@G4|R7*;d11)e2udmk=Qxf1M?A>(*{d(Na50 zC-=yl&#t-(vb5KG-uY&^`S2!W%{7U z?9+nJxB8DU?^4IETnv7Os;O`Eut{8U;N0+i4FtBPxXDwG1R~%YM`{)*tTV`~RImOv zJ}%f}=-L9)k*hJ2{*zfVa=!j`*u;m=L#sTg{wv~-sXk2|9v!xKqdBdNqfc6dMV^20 z9Tj@p5J>yJ#X#z9*r>+-&!%&H zoF~^)$b`}jZU^2J*gY@Jo1XW<=8Qu3I3U`5$3Dc)7gd;hF%KhuDq+vk6^!iX4U{b| zcuXzQh1>JxAt9w*b=Kw%6NO;+uPRtRX_qlH>DKUkFCKQ6H;e;L5o?XC6;xgcwYEP@ z|0-F(B(V`F4AhbgYugO8jHU;Fh^#z6>4VyQK>@+ksTZc%mfu-E0?0Bl5rR$W8G z9+QZ*j3Jt?(puX-^(kdx?U@aln40ii0mr3_LC!r*PB!b^V5$^(_OJq+y?yvMQJRw8 z{`$%R09nlUj6Vh<-qcIquUIZloAJe(mN){Js+(U+PwQ`A2Lw3JNOc9`q4LU<&}ZUtudQ5GYj5o1r$4q9X9+sqa|ZMl83REcO<3bn>)0n-gxZ%D z4?wzt$7|^%%h0Y8zQAnHus9~p`LcPV?I({xY@>@w_S*I@`U5WtsIi(xdUWq@?WgRM z6*P#2%wl3=u`tF5`}==>dfMKm8b^9i)8)MA7Nq!CPJ7r5(DSC-BZazkdOitg+Q7Pn z*h3bo*``Q+O@N@&LjsQkz)3e+*z#=#)*)Y$wI^6&Wxys4!@wM{?2k#&q)mLBUS0Z0 zQJPk3ZRkdWu(EPUv z1{!OoE{T_$R|$`%GcqQ#1fY1R2BnxNPmR)*P$1JB7@{gtB{lnm9;?MC8)F<8v?pUc zYC)!gy&`)g0_B{aGmo|*wpObcIGyj$BtF;_W*tgCoeZ4G@x-4|P|<2~TTp0w`%F9Q ziRy%v0$l+a`MvX}5nZY7xwbQ*dWAohdNl;E82GN!A)+5QRv+{67DZ&LDcUukEgD|- zqTmEyA7}{K|9|bhWmr^Q-#07>QqmwugCMPfgyam}B_%B--JK&Usg$I2cQ=v}QUW90 zDbfsG!@#@8Q$4Tydfwyx{vOZmCxpEx_FntH*80_d)}EI$c7C>vq}f=4jtw=GuHZ(Y z>N*A%fQ9hU(0y)}9jwV+`hbl#NNGy>4RJC-LKbobXiKJwA>R3nw^^sH0mz^c2KP>D^4dC`C5SJFA}hF#mj zT5dA^mXFnKi&WI1nD2{)9iI&3tJW-Js5opryFh@9z$GvT5PZLxUK0G*cMD7Q z2}wEY=4A8%9*!H$o~J{6eZ1L2X>!WSTOCujZ1 z(m`{SK0eTu?gS&;K7Kdc**AAX@3i?8^D_l+$0CJ?W^#4jht8L21|o2 z8Q(dJr(A~;?;P6L*T8Oe#AhL}c_pzZAK~cyylzYE4|NXyFlPECr>QS+;3{IBW=^gi zl<;EZllcMi7$m`b`DXH8l-y zNrwzR>A59qAlnpyY$Px{96x)G{bx@KwLqD-qJ8T94zZNt@NSJK-N&kKQzZ?9a?BWX zFqJJ1rB`$Ow(eoGJw>aE7hEk02|`RIj9iVH-|(P|u=%ou2wubd_Kjz+E8WypcvOVF z)Xx}tgf3@ztWAjgi)rX;W?j?{)UqFWDg&};O|PCyK%MuV zA%Q!7>2OqbGvg6lx$!$7sR40N|npZ7?zH@fNA%v1zq2LO2NE0}l#S5won z?G!oxl%AjfE@x*mRMDZ+(lnT@#|mOi54(+#^g2kfRcQFBCA>n(F6@KyL1SFEU-Rv! z&>1B^!jR8kC5iW`uH(LX29y4z5g*?q&ij6S!Om{GSQz@5Y&WtF++#&enp;?U3EjY= zjgx&I@LEbC!8_mkUED=KWk0W)Dm2MRd|kJ)ijDCN)q1h2Y08 z@X9@|6y$hny}y1m9}p>sqLqGN$@7-z#a0S->jv4NcX{$w>&x#Zv_xsddCqsKpHFLH za7Gs$Sy6<2d>e82+9U_ACZljDCEd2Fht}QvdG^l;d_|p!svfm zbjw}*wL&mL#)uw|e<~WJD%q@N&3c%)s~QVQ-|h zj%%w^3nUIzYE>YDcf)H5U@JkD9wN^WY`*lV9R*$6Vg()#NM zOG?^u^2w8_GBA(Hx}mKo&+sKl@i*ye1gdRdy>jPmf|QUB8Izcr$|J}He_tUBve(RS zkUSGHChd_d?fui0 za88ygKSNSG;C+|q72u9KL2bd7FIh~L!OUTV`U}65mvSWd^ZX(anSUx^)Mwz)9@~9J z1iW>xJPM#hwOxgfrxxxbr3A>sZ0VqzkBP5wq=U_xDXDsJqVH|^>+9!OSt5}#0;Pbg z=ET9o7iJEeWhae`r7nsmXA!IN9H9F5y;3}dmb|}T#g%0LmSl-*!E}yDsr%Z;Iu93| z_oZed_IATwufa0Fnu%J<6R9?r)CcnmwF+jB7^dr442Gh;xL&D?VK0e70>ae40pWl& zbQALjrCvAHw%@P1ONHRDdrYn3su%B^L}+%XpmeWc@o#~uR^~s0F*6id;Z%B{e;Hc)WZ>deM_xp1-k+HI&_ULMR+!T zotHlxKIuDb)kUMyBwAY9Vh1up?(kJ<;Qd+?a01Q4qFb+cXnvnILZ5+Gw3jnE!JqVo z1pUG*zSH2u75Ym5zLL_Q7Azq2Yefp-17_|$R5f}u0`dxg>$$U&o4xX9h*+UwE3$yq z)*(cC3YglAY3A3%d0!h^gdk3OQb$L?O0^-{ZaDjr?$tIb;dSS#YAa!4$d*Nb`-9i* zd4N%;(n_Bd3D+SbmcqXthmC6BI*7(N{T;Q?Mlb_7dZWg@Rr^(2(dYVbqWz*E3p5pa z#^3f^_sB!2XCfXj35wFTC%i5CMRJ%`fR*n|h8O)l=CklRWUevU<72OKlS|W z?Im@Uo)T`Pg6G<3!_tw>4ny&1K2I|)Z)VYn0^?;U(d{}bHmJ@z-tGvqbcq}SWfK4KF;AQV&I zH7W7qYw3Gy7X?{V_)As_z8=rnKD;HE`UVs=zNgRf|CU~Yji%Rkirb9#s90Tx-NZ*k7vfT*-N>_k$ZUOUu90srhlqg1}Z*cDN}aAB z#Y4IT?8*;r{STPqS6yez5L?1sC`{DWo44=({F#?_tb|tXJ4Be%@NrPlSvtrG6zkhAgcXjmMtNx^r9;!~g5Qlqn^w~cdt>i6G;&HiqY~)G3!ZRl zAB#PVIsjj=-B^;hvA3_QUrezoL zSQY`Ge;xZ^?|iuLd>ns4PM7j2-q})ERfS$P2J?asBn^Q`pPVHFxmfEtW))OGg|>aB z>+~GfvN^(<*sD}vwdWTT8s#V34PRYF;6BC0<@Nb#eqZ(=8(aXBR7n3UIwslFR3@@2 zlGdYUw_<(*VIVaW+5Q@6jLb#%m@@7ckcS+Z+%j}~)L)s{wPyP@ZAz>Rz*)5Lk<<>7 zAM3MU07ho1B@si-Sv_$iQ`y-;`suNITLkH-6K`#8ruu?GuzohV^X0R_Onx`{h5VYD zF6FBY!tLQzH=Dzkk*Ielq@t$6!m$0qzNOte8-9&Snrhd#=6>qWw!2x9k~WlW>Rqj3 z0pD!6ybOX~OWsmeR|1+vTG4{8EeD2S&F|y3E(C38%ju)SQBxr5;5`NryQV1AaGH(SU|W3$>5!KY;OecStHPyps#k=-X9PW~#G zwx&GQb4Sg5UxNJWeH{Q_W6ahuiy zZf0<*jc`Z3TyZ0X%^=0ch+3<#AYpp|XEGeJwXw9V5^^PufxoLVJMJZZI*%w^dNjHkDcXT2@KV}R z&(0uKgzL!5XQ?f6`gGRT>Zu5*e-8iW^n{*b?eK+#@oZ^cpz}FS05Wzjq(d_={7)?f zC!zB+w0;#@z=<#0$9olHb^I>RnUQav$*{6$MoV*&(Qu|9U4TZPoZmTwG(XV+EcO-v z6YD8=qhg40!~*qcKZ2~g_MxnZN!e$1iN?j)+jOII8K1t}I57`DR3BD7Z(19I@1nyv zZV+c}$4w`%9uNA@lf0C*rLd}KPX`@caR_ZDW{az4)Z{#4^dEB#$dq6!t*LQK>cSot zJ2=9*F{?I$jNZo5OFV^7hSyI&rNM0ckpQ|&eJI%&nocplfBtQK$HG5lZ%ZXvn9DV1 z(R21K%0fJGqyYCA+!$Y9Sl|eqmY(nk+;a{U(^i$B_C^H6X|PlM?G zV$Uuq1R^u6p1Bks(RTP*uf!IbLGVJhCc7z}{(J@HHO`~!Vq8k@F82jvA-y`=!1*6v zh|n>I;1k*%Cw>FB*%xmv0+*X-Z3PD7IgN}VjVsp4@MU44^^(Ur-)38TkF2g%JRo(G z3n|1~`a9X+vbMD{g0TjGlG4qD+`+*)?3Dc&c34F)1|5qbW!IioYzvyTuazn&+R6c> zW=2arEEYXYY56NF3gxb_arYz)OOpL0en=()zT6`bC9eJ<)>Grlhrsske> zT2jX%zZ0Pwi?;oyWf^L3a4);#u`$NvNa*Zw^Hou#*|RBtWG^%hdy9&N1R@*LB~C1lBYY%GCG?bX^6Ls+ zXdOa>2{B}7oWbNu2N99t=a*zdm|tE)Q6R^xNHxZeI_*tjs_&dk2iMjV+vYl_=p{H? zRM1{`ZAB#k@zgc%@zv&8X9zmF7LEVPW<^oZsl&neLy~tK?4j(Hgz1Hu9-H`+_xmn`?V~QeuBI*+^hC&!Jkg;3$k# zlV*w)ixHd3z-J)!i{gb0kGxrAGj}Pi9cX!oNDd#Kz z=|^31jfT?W{mPG`YI=I=+TtDM}0n%rJQs-Qrn-|c+IxlV2PEr-eEpQjJZKWA_prsT{2zp4#7HN zWa_$nG9u4H&UB2^GB8 z7-J^HSVAIS=>g6d%C4O~=313%3%09=Xgu*yel(UY-pNV*`a5o3CX??gxyuK=%biMc z6c#?vtkpc_Y*cpIZ+ey(JJlBC2bont=RC1o+0sEx$1^g?GmS_xf50kcc3ksI=no~2 z{sCd~%r#W?GUJ8*+^7-AbvQu)=IMe zoVG7R?UA5#sG?8P<|XclbFp7dd#dQJ^cVd5;U|1}hlJ!aTfW%c>@@pOUX3SGld346 zuv!<1RY2=~GK=`520#6ufE1?%u9grJlU^H31nu9wVpSv_P`Qfmem0H50L8w2;HCar z93>-nAR*WagdM-}Vw(1cSg6m*=rWGxP5|`=l{LW`RSXKR^*W<>i z556Ulk!2PkvgT&Eg=1g<{oztABRTn-rq3-2PF)vU_(I9=T)?Sc$L-3Y$?N7csj?#r zG3U?QA%g8dw%OC|v76jc0CF~3iGIiC~Pj#KQ(#FHI zM;*m5H}m702E@nq-4bZaFGIV)kS-J$!ZyMZfx$UGLM(TVaAtGp>d$ z`B%i${Nq9gpPdB?TuPLvZQP1#S$p2pT{Slo*lyYpFj0*S8nJla zJN=U6R&-f6xWCC5vAoC~eql1;;)Cu`vpE+hDkUzK{ezG%)bHu8g-u1#)NT3F^isuQ z+LQawkbvD#ZC2jj`T8qn!KfxzK^JyQHLpYHp)yau zVa0FrK-h}0_sU^or?tZ4G7o4z&yLAyM%+TDa~<-b_3et`rn&!-Zp(9?bF$*v=z70t zH|%?C%=he|U_oo=_YtL~#dh_>cT|KwX0zV95Y3W+ZmcDQsASxwskj~rY!6QY?TzU$zM%5snac`o-Ndau6FyMc&`jtq`g{| zjy%<8(schqdp+ZHW}jYs1R8g-y1D|?D_BhHoG(b6C0SGtCfUm>fxX!G+vt@9uPOK~ zYY_V>r|P~W1mvp^%ysMCCM*0q1wHgafAF`=W20@(Sj#J#CG#sDIM7XlG zUPAMfj~gnpJGkU!3zZu0)>O&#D2+Qq(cD!Tva5xN!*_98FBK>P)o$J5|-b%%`PmAcw>8M~~o>Cv|3h&(qzxzr{Rk{W+k~N*&Lx`R3~n zrAZkDGd8cExb+Kmi|`AFmXzIHPL)@MU8(ty6*LH};D>~_ZwVnvb{um@{=+%vGXy=X zi;L#PMguEtcL03XoPXZSVIR6hjQwQ(Y$@9qt&#|Buw8oG+;QL{?r3mee+sg7~ny|tgvk-X1AM`X2SMb3a$ zB8ZSZ;cCk_Jx~2*40AYtX^Qi7oBckiT#>KNM9b{B%pQe#_R+lmFl5IE1TWoPlG89c z_)+j#ONOesP3d4wzX@lrhCPZIQxe%>2<;KK(%*T8ulDucNBlzaAEUyDorhUU{=xbl ziBFA3L+&t%HX{}w4yx2l#lowx#2x)OkKxpNqsoF4r&DhEjuux67AdbRQhizxdyf-l z_nLMrea>ma3mPsW;5)S1i{yec5*YY(>dL}j>yFGt#t+hXj7w6t)gL`-JAK#$=-^sX zCf>yx!LRa5=d|-x^EE>SR0Ni@-RB2AX2fAv_qN0ZXBH%f3}Q1~8>ox1N6@0IRi}PMc0vq@&)! z<|t4~qH!rQ>MX5Kq{uU|T?;6z76J8v{6e+H72Ig{F6fk9B-S=nXWjR6&CVA5EJpho z`ol9b)XD&5+b-NjT~)S+Wj#0#2Y}?>FMCt(pd=4NwpNWbBvQxWTr;41s4te=>)OnQ zLf-M=(U`S>ONu`81%6W0fr;NX026L|taH}QTu$Vc9fOitS7q{=Tb~tR(mioRJ4QfE z_pY9N)2y91gKYPiUNBiL>5E&3fz#2Cah6vub%oBOXJ@I4%YGJQ5&1aYn9jB=j1#+I z#z9Op-Ru&#)W|=Ixz~COmlq2ozUxObJT9J+u{bs#t?=gDoO0p~l)S$MG!6(l=$^YbVRR?9S>)>!p-_iGk+uuy?nX~1)xxJSZ=*O+> zq88_taVY0=>n#?+DwxS+CBQ~yY0or^!A2`AtHPzZZpzsz9+x6v8S#-nFVK8Uw6;NE zl}=Aex=g{t%OA)Xi%nB_SEr<)sH!%t=6NXFz?`rb&LdF~vp6Hlxa>M>EH$R=*cRyu z%h3zhQqqEGBPY3NTo)Gu33Tn6!VvxRX5=U zlc+?g+%s(qJ)Oc`LG4D=r+Z~Li$zKljhS^1i5!YrxYZaYzxXe-+OnxX2%r!F7bs2E z7Y|Dr_3xgvUi*a(r`zH3r_Emz;CKA^kZO<4Y&3Q4mPTKp4EU#L10Mm~Ojo&1N=!2( z7hBTS#X}H)i#9@H1yPAVeSoTi#oSwt>)%0e0$wQw)(LJ_X(8}h$Ey}H0dwGSP)sN{OWDT-AWT<#FXn^H% z@Pfo)qYSXvt{p#|A}Dinc;xO8_frI|O8<4aY`oFSq<`B(AteC-lbDC(MUUAf5x;T9 zTLFWN&~fUeg?Y*a#ke0lm~>GWsHw^>2M}ZN!{Kk`qP#n_fDiUKQpn;j+RZHw4hZEo zqBw#Qn%b2ylPKCYE__PlDne9+ho1d%rP$If-Ms3O4^C2=8L%#nuW3ouQ?+G^ad+?; zx{W3XsNgpKu~z;f4gkKWyV2_u!Rb-UFZzN2jif@=K5*B!mImqE$e2W3%PzTieN!2D zL>4T;6O}ckox^&TYx@7fDM%`Uzl40b2;_U_fpAW}NPAHs?0`55iH7Q<5y*a$GoRaA0d1g1fLtpO^rSyI+mQVhBYdDBiEs6^pr!iH{rUP>YtVp3}IRZ3iFnQt9 zwddrh$$%`r>!<2Zsz2L@Td0(rP%4MY+S-$ev9adw=4!W4rypjt8~90NkB{-z*yx)4 zP(wN`!FRALVlD3&k`(>z@kj?{%ZSi?@9~)kM4DKj{F%MvY>FVH3hca3?@M`{x(`!2 z+*Uiy+`SEOfL-m4T4VoeUfP8W`qYI0X-;%VbNlC|R4Q@sn|8?`Afnr(z_H*K=dr)x zw;>^5lQGF2p)a9?q=d#9pD5|7Zve=|w|P_Us(N0%qVnwPDL;!XQqTns=&0cObHP z6hQSF3<5^|#yU>><{z#Ku<1OEn!8|Fmt5SL5)wlH*hV}(Ev`$74%}0p|1%W+VZ>0-vVfFm2Jgv~d;i}2 z-}0URJ>~!IE9P}ylalS1*AZEn?-B&W$H${QA8plC-<7x51AM^joZdb?CY2k!Nxue< z72w^Az9Sj-hiu&;lijPZfY?|W7oqm06QhzAvN=-$V^j@TQInJl+WqFg0z|P205_CJ z*L&nJdReJDhQhDjjB6ssj%IoTdKm)VQt(BWzIl~GPrq#SWyuoTLXsjcv@~ps2 zFb@ptD){Ay;O}8QB^x05(nQrMvoPkjH|s4*ELF*? zRirmJ!vmGEYbTZ1=eGg|jD}7maSX_gIC_MVbZ8SpmUtI5l(gs+vTdDR^dR%fzVUqH z7c6AJlLr{S0AS>jH0S#F0|p3xoSo0(tYRKmEMvt|JdIEFQm@{({>}nUpFmD&IB z7K5d+Yvwn#i0&W&2|GH95j_=!DitZ?#1OI%S937yO;>cZjWXn1*A0~(Hs4YzM(*>KS z@hDN4#3bKrZxt00>Z?w4patGPQat%zzDVB1Fs&gwAq6pm!s#f6>W^V{lb)}^$R?*| zzvEF~_^H27^?-5fRXt4O85Fh8UeK{mpaONsz!jtAeBQz$BRtHf`xHO3<};{+jk8qW0Vd$a-P|ypd&Qp1*V(8L78iV6#s9 zXur$jXVMMEs)2r)`7kMj5>PpB(4hYRT>>wWswR-pE#?2i$UTM*C9m1a+^2y}si;ULRh3liQ!Chrgq3Ba{S#^&B(0m`}tVM*zE+Duc3KN z8n2X50dcE2LPNj}1)Wi=OxF&C*kz(50YU}HP>I{F+FWe&H)rkl{Vg6BGzTig&pd|Q zkO>`)#Q@9Dpe`Vm0{N=C!2I^Q)mHa7R-r$&WQv zvl!6&zxDs!+`}vx7$vq%Sv45IJ8dwdpwj`_t#$*&6E95Fk1lmfXur2!^U}~05C$X$ zuSrLc+hgoiYg<;Lx&sV%=b^L9?hu@|hRn!o9B&?yj>|(b)!Vn}V_mU8HJR+EG5n$g z9%bUtKb>KGE$-02XO*6|FzKaUYGmQ|lNWhA1C)R$50gOG;85EJvCWpAWOR2{-{t03dlr7)aaWl~6(#jRfi+=1|B zPJ_A;JRwITq2+8D&xp`ayB>GnjMaOObzbo=EcXD0H%`6p-g5^sZk4F)#0-&qgJ)#G`PsS1l&QJ(0CY78fue(bF%DRQh`_K%p<(2yz~I?7A5L!P4ENEhmq8;q~uV7G-k7! zE*u8ECigDRAQH@ehh0vY1-dF}7pq1$U(x{e|E{o~5an~7P3n`T9VdJu{fizWJ##6q z{QQ!_Qk)(U(6%PXUXPNyVWh0>#2&Qg)wJ>v$JWt2kTt_`5irf*&}2;c}Lt=nuT#w zGeZm|(!wy&95#e_;u#kkKZS8bHl?$E-HUyAWLKY>U%t5Rx46E7BM!|Q4RSv;u~~A@ zEj|3vZi{J_4fugL_H!mB`Z08*bmaK>qWSEkft#32n5>R0OVbZk4b;h`6?weZWjq{7 z6E~i{68CtzDw+fY+61s=7`2`VD4VOVA4fB%SE~4LCX1$jDak7v0uX}bMiy(^wifs5 zdG{H5*GpROA6Us30CkRtUELj}1&R8m(;TSXUH54RkS$n6x&Ns;Wr|_;EkK133JnDz zVu{5u3{W~`Xdp8}n+cvhS3`~|g45~nG3FgtS|&9$!=L7Q!2k;53q*_-Z_|WhBA2hYS2rcJ!?n4Jv8A}9DVbi8M4&g(LA#GdU zLMs^vamO4}DGaY*qc7nA`_F!?MiHJC`Ks7TeFvbTYbF;HP4(cW=oBQ0i9G%(2ItkV zV3#34Mv`{=x=Tw>kr&hisO&kRXX!0ecVn0ZS_5$*KTig`B0V_i2KLjiQNsWN57Oue0u(_J*_dCSc%ob}1~ zo$QA-Dy8WvFrZ^8Z1trsD^n#hB?>-Q8pob9uTgK0zx2z~CAxT-7K_Vvkg?rf4B{O^ zc1rlLb{QHGHzgSv&b(KD;B z!&K^_n89+yU#9^BsW{OzK#5)04Dt=+0|84`BwuY78Ye}Q45OdfH$>RjTMH?FiHinE zv!TvIQq4Nc%_``p$;RR$t>7%vg=}&GlNaPnj-$J0GrF*nNLrz9{E=VUqKl_rB%y)ft6=t{PfymamlG5+{AlB4l8ba4R{~RO}Zf$XKV?&1jEA zC1l&)e|uK_{XuZBFBz$5k?B^>ftJ3;k5PTCsX6?0FR+Ejtba16lDRccD5^kGd{#!k zjYA9Z8?x2rq0)Pte7;kvHplJV1LduRdA1++*9C{)()5z^xjK?(a=DMm&N|PS!8E!{ zx~YTkDT&Iyziqv{^CbN`OO2`z?&{9zi5tLzv(Z%YV{$nG1!2-21P%jMfY0BpB1;|M z%_nNh7W5z62hbEJ3somM=FkMS*DFTZ+(=u%cJAO?&odT8^rYa!Hyo3$j@Q>$T$v}Yd-5bykWLOal zUs^vff)C9uKSOA)XNw6ZEoF;M)V0K4fxW1&-Mec~3lds<%{4LU3h=_(3(B0zJHz7G zC7NVPaTGVsfdvg9O~iwjAG%xLsL_DcUWzBbdE{-B-2c6wMR4-*qf3`$W19;aG$*6D ze0|#dlzp|P>-eS}{)8(LMVRV+T7dC3<_UCutC-63U0Gn^tkDf2n!A_b$Aiiw0Fiwr z0HG%^M(JkYDU}!qT7P28(2@S`m?w2f(wmAE+0q0_i(!~E1&Y!_-VN$CcLbMA`rL?# z;H^U)I9fF?Rrd%b*gFjR_E919PrzupLKl}$;Ern_vtq4F9Rl`tw(*+lvhhTqkJ^6b zMNJ(X(fSI1h?U)mfwe6`U_0d(y#a*AMu^<?LVRfAtv=V~Ghw41IspOcey~~NcOAa8%NgIPJQmI}kc5jZ2*2Wo zPZ>5k2aod#AP1XqFQH)+yxuiDX2xz1zB*S=`*8GVcKpb|Qm`A7wmUN#7j$vbZR}AC z`YFdvs-^~g)j6oQb)v3UX(p;xhg$r`ecxIuiz;0mhW%`@fAl}ye{OgRaBx`U=d zE;uRU%_6prNQ;!fk~*8SW1e;E+4ZyZE=)b?e!AnSB7NB!Igxm@fKduR45!gt`Y{;FKLQ zM&F#JR*U!Os}t(_zBumaR@m*8IK@}&*WAAzZDn*0z}}LL8sHD${MA z2=w>FO*IjT`!C<1-XCr`u1ft;{I*xmi*_O9sH{A%(yliyIw4_Qp}chuC9IbIWj4a- zB#vKWk^qhT=}d5Zk6q~G8fH38meK`hES<}7Z(r#bTw0yXP3Bp<7OBLt%E>(;pXs+d z9~H{0&OnKv9!xhp0}5hjC51PiR*jhW(;KPu zWuvfU+)9?lJvLWozBJ;W`#FmCaEfpn6)&lZ>(z1Zlfjjf`kzzu@Zo)7T+%d{aYK2* zf$R$blRy=}^Op-9QJ6>l+x7=A<%meZDN#Uk*}54)APKd^S~FBN#AXT{>%Z66V*ogx z7dD4aqHoOx!WKY?3+~7DWBE^-uTO5kXkhrZLf|9(W{IoT83%a0C}cc zn#y6;_(21;^H{`w=4u;|<%~9Hb z&h0uFu~`L~o`rp@E#fWSHOF_K+p^Q3lkAh_wO(P^J&G)zJ^ch^`neC^HpZF&QX|BB z2cze{rqS?wDifeP)exp^$h|+SmS}Igu!(mxtyH{jEi=JlBPj&FwVt&ZRdePk zVy~wI!o6P3%v@R0MAa-grcYO=lOS3mQ}?U1?M1ZGt;}dreBi-Qx!|Jc%g7b0HOrS~ zvNU@qZDz~sR@DM>2q>>O&>-i^Vp5De62_-JD14&3W}1}V)PLk)d4I&h*F45!@rF*3 zOJH>@rlTNy4+Ta2AE;mTZYB2o^QUHr@elP_P!=E(hv)tav>+we%5z#OWla?4YA*M zlf@k*>_t84bX3oPwBlY*O#LjsZShSN1sC1VW5J~O#K^E_lk5XP6$UkB+}AZnnqRC4 z3al(EW6F{oinn!v`V_{&8Ztd-@u9Y=BMri(?WitMrhQ4|M=ILWRPcnWKtPQGMA+*a z@WYB4(1&RKpx$V;-GUaWmo*dU>M(ezFNw?1kn%udQS9XT8fV&`z87i8fJJHzs|M?N z5sht5o>`Zcf6PStqhl`ijVXg7=Ki<99JM&%2Ti={Fhmw}+9~GI(#%k_{|4`k-T?>l};7ipz z(c5JIz@byefu>c%Q#6!{8D_~8F`kC$dN7h}%qI85b#=roD9Ny@?v)*;b3r)vIg96W z9kmI*EeW{g*!waSZTLIvla=x%O+8q)s@{!=rUV+;3{@xn_J{6nG%E`~^4HLQ0XAv`FLf$e^v!1y z?E}hCQA3YdwiPT;0%#(SUP@@AL`qIy7FPMpsKAeTF=QP2$1i+FBhrTElexV|fi<9- z-}Em)aO45>Xlm{_CHVOteDF6KhD1t~ku+t0$9p6+=!$+7WSLKS)435FNcNj~$jAm; zv?*@z4hsS3oi?iC_J(}W0OfM<|OmfjIZ-ceS2tn5_|i{qL80{TlahO&o*N(yC4C168D4 z?7j0;0^2{|JAekwM4<6ip!tNp>S&$CT!LoZ)kN;wS;HSFsB)-^mvS9T^hnn64`ucb z80wGQ057II{T;LS?;pV*fnv;fm*(#uC^22*-TdFCdZGmEp~p7;PUyA)&NrCd$NTfj zP__#HWeQ1TY70(!s;E~b5Qiy=>=o!*F2ebn83H~jkw+6{Qj+&nOg-V0YDQtuazNkg3*CT3A>u4YRGHhsJ>4<0ll@Sk}~@;O@FBp*794 z^b-F%lMb0!`Y%$fj5Zdn!Tj{<_{@#Ww-kd__X=b;EvRp_>ua%)1(gQk%9Cx>dm^oY z%+eurap_QZE2asEKc>8^{nujTnE6jM70Csfz6!LPhrY(!yC)9K+3bVf)P#k~a&90?x%WuuTg4eQOJ`faFp^ z!C9dsYa?e$AyE~jCrL6)LelE5wUAhC3!n`C?!$iir{fwXj_Z!4H5xi4Fs23ll?7Xe zktw`D&LDDx?{y$A)2|l>*P~9)U}-jeoSiuEs%L5bCk_$VISR1S^cep+>OY2;E^w1` z0;9$M4Bx+xEuAJXqze0;0RH5^25S!BPLtFnXZ-_s|9k3lz^)!$MAh?~-T2?P`S;5G z??wCHk@kPpbEA(IG0+#PBj%shZBhxH$?8BI=v#h39H5{=Ot=s8{)T;YRC+S&prx-r zb?Sg3{EJx?Xe?cX)IM*!O+rTc%HypSHDI?S3P8d^y#qMr>)y2Depq~HpMgxI8rOOZ zn3V3z^C;(mfq_~e#gp`{JST{se}smICV&O&1BI3qySBCutjpHX>;9Ke76acI3afyW z7ZKq!TvJ6?@baO+)*B>|1U5p)K6J4g+n3ifFfhIF?{smT&S<^&<(iN zryd{m(y^wib1~EOBe~S~V1_9m0^&{q_&wxAPj@BrlnYi;LMh1$)|03OINryooY(l^ zxf{!4jc+i|htg^%xpz;ILZOKpJ)$Fs!WBLvrt5?D-cWl-PxiSdxHnNXqT)a?&0@@W z`R)x7@SzAqQ071MGBMn5!BKfnC|iB&CO+pr&%pcD`XP?Cb{_n{Mfx8}MSvnOTSWh% z_5QP5Mq3sLA@!SIb O$w?_omWjW7^Zx*b^*}HH literal 0 HcmV?d00001 diff --git a/monostate/README.md b/monostate/README.md index 33a603502..5a69c4a3d 100644 --- a/monostate/README.md +++ b/monostate/README.md @@ -34,6 +34,10 @@ wiki.c2.com says > A monostate is a "conceptual singleton" - all data members of a monostate are static, so all instances of the monostate use the same (static) data. Applications using a monostate can create any number of instances that they desire, as each instance uses the same data. +Flowchart + +![Monostate flowchart](./etc/monostate-flowchart.png) + ## Programmatic Example of Monostate Pattern in Java The Monostate pattern in Java ensures that all instances of a class share the same state, making it a great Singleton alternative for maintaining consistent data. This is achieved by using static fields in the class. Any changes to these fields will be reflected across all instances of the class. This pattern is useful when you want to avoid global variables but still need a shared state across multiple instances. diff --git a/monostate/etc/monostate-flowchart.png b/monostate/etc/monostate-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..44e93e200dc0c0bae5acf46843e94d338d99772b GIT binary patch literal 55664 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 literal 0 HcmV?d00001 diff --git a/multiton/README.md b/multiton/README.md index 34e37866a..f1df11dc2 100644 --- a/multiton/README.md +++ b/multiton/README.md @@ -32,6 +32,10 @@ Wikipedia says > In software engineering, the multiton pattern is a design pattern which generalizes the singleton pattern. Whereas the singleton allows only one instance of a class to be created, the multiton pattern allows for the controlled creation of multiple instances, which it manages through the use of a map. +Flowchart + +![Multiton flowchart](./etc/multiton-flowchart.png) + ## Programmatic Example of Multiton Pattern in Java In this tutorial, we’ll explore how to implement the Multiton pattern in Java, covering its structure, benefits, and providing code examples. By following these implementation tips, you’ll be able to effectively utilize this Java design pattern. diff --git a/multiton/etc/multiton-flowchart.png b/multiton/etc/multiton-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..bc3c119e62b6bae0411c4ace524b258b5e95b1d0 GIT binary patch literal 46395 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 The Mute Idiom design pattern suppresses the handling of trivial or non-critical exceptions to simplify code. +Flowchart + +![Mute Idiom flowchart](./etc/mute-idiom-flowchart.png) + ## Programmatic Example of Mute Idiom Pattern in Java In the following Java code example, we demonstrate the Mute Idiom by muting non-critical exceptions during the resource management process. This approach ensures error handling does not interrupt the main logic. diff --git a/mute-idiom/etc/mute-idiom-flowchart.png b/mute-idiom/etc/mute-idiom-flowchart.png new file mode 100644 index 0000000000000000000000000000000000000000..846c3b32d46063456796226956329a27496212e1 GIT binary patch literal 51977 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