From 2aaf712f062b130096c64fb2467caf67f19bfc90 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Wed, 9 Apr 2025 21:31:30 +0300 Subject: [PATCH] docs: object pool and observer diagrams --- object-pool/README.md | 4 ++++ .../etc/object-pool-sequence-diagram.png | Bin 0 -> 69597 bytes observer/README.md | 4 ++++ observer/etc/observer-sequence-diagram.png | Bin 0 -> 45973 bytes 4 files changed, 8 insertions(+) create mode 100644 object-pool/etc/object-pool-sequence-diagram.png create mode 100644 observer/etc/observer-sequence-diagram.png diff --git a/object-pool/README.md b/object-pool/README.md index 56888b017..9746c27c5 100644 --- a/object-pool/README.md +++ b/object-pool/README.md @@ -35,6 +35,10 @@ Wikipedia says > The object pool pattern is a software creational design pattern that uses a set of initialized objects kept ready to use – a "pool" – rather than allocating and destroying them on demand. +Sequence diagram + +![Object Pool sequence diagram](./etc/object-pool-sequence-diagram.png) + ## Programmatic Example of Object Pool Pattern in Java In our war game we need to use oliphaunts, massive and mythic beasts, but the problem is that they are extremely expensive to create. The solution is to create a pool of them, track which ones are in-use, and instead of disposing them re-use the instances. diff --git a/object-pool/etc/object-pool-sequence-diagram.png b/object-pool/etc/object-pool-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..2aa438024455898aa3bb87e49770f0ab14ff0f6a GIT binary patch literal 69597 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�oJsAPIw#B!+E(h<;^DFKnYd({Pchx`4$ z3f&6jzXXXsp1SHE*c;D$><83^6LX<$fO3AP@!mXk=qFP2z*jp9?egFU3hEJ(5Lw=& zdS6(0MyZLy7|17h3fz3CC787J`DB%QbVlp5pJdcf z>DE^3TDMKQbJ)z{eC~H*%fV*uNUmuaYP=$Qt3XxPc3#?V*s3Hx@OapX7^tDckEAm>}@;ZDM$wwNd=#j0yUg@Myvt7<64iaPJB%de|@Lm=4 zv3%y*F!!9BPavr~D@fJ;Si}%LE;kmZ`A~S}&~!iYUGKB7ED}$TkYDefIPXQZ9Q{xz zlSB@q)N^p4Exd#qF=5QzhuV+ zIfCm1*_d0^5t2u-`jRW{m0Eobs}@Q75mfQgesdPB6QREgiVN20h~Yg+Y3^%t7tEXO zn*~Kz*6FL1MF zPD2vCSpDQ(Z{UH``KbI-QN&})3GhzY$-ag7cA*85H$V%oFsf<_ zKJ2XbD#Thn!4s$;zb%1Y{f2U0n~t4HVkyH}p8|`XFFn;%^IIUr$USMV8G5=tVZoLa z(2a{&42rVa%cE}i@IKaJ%Tw2eT!xacN-w}#kzHk7Ro8$S_SDG<+ft}E$Dlo`MO*Og zCr(z_&w;SwI2%x_if>%dAOK@ zK0yl>8aMs%-)-wi6KQQ9B$Y%UTID_!9<=RrHBW;BbSCFaPqyhnFod+2IX}WlYwrDx z1Fx~7)h1@h%kOLuL1Fzl!kTVMwxz~VM_&lqQOtGhW#2vcEE|hpJMk@91}LDw??Vi6GsiNUkyPZ`{&0zT&{n=X9{6hS zy<8YvP?0&QfcbKeU!Eg)wXj!et3A5QHcK8o`gAK&z0bC5=1rBs$(#hkZEl80^^|AY zR^#Q+XBF43pN7-qSPzM3>X*@3YrJV~iW4sP9p)avy+sQ-3oEU&xE!rkDbn_^ES0kc z0@*e5{F9Xrd=EVs6yNP_%|bQjoK zQX~bu);d$zfq?9jRRwdvN3D9X)y%!b5Tp5^)vE%bM`jW1Cgsx+40&!jH1Su4GJoLq z8~1sF$~wYw6pV+bPg8e=7nwjGJcVZDNDtWC$FCigKSg(MSGWl?~ED>;7_02{Y zvj90tq{ccC@ARvlvlqn2o>Y@LTWbh*VVZXBof8C(eIfuhbQ><(;_tkWuSjtfoLLAzV$~+?=L`9b*|^47w?)HrnEEw->cb4! zus$mhw&5VZ@$yaN3?6j+vNLWrKaw28DCys@RU5EAzj>6}Lc50N13J7#La_yVV-NTh z)*{(>3rHFb=4I`Vk@Kb4#{EyQPa+72L-^X-c|5+Fg;7(;=jS;bhk7ODY-w_h`*7+b zj@{$hOsFG2H}bvGc@U3H<@jCU(;&tLq6|s9$8-?*KzQ3UNs#H6rWw;i+#>P2yzwIrO4+bHo9ltyw-Dud9-+4xf7`J*bSDKm5?vxw&q=a1#69SpY^i6Fdvj>5$s2aO02QP-2nAo zcfI+U!xT2GUI+0uSd)2#u!pbDK6pHG*AVsIe*Z|iPcK!G)jw=3!k$<%Xf9H?lLV`<;x+`o<2NR30+wYeD1A;k zscvezdn3L;I?duTa=cOAA_o_ioLn1Gi)kxs?Un48Zo-vPGEpY;^;Cg5F~Mt|6r2Tb z7?k~Mu={K1|vx}X!(rugoRD874ecEr~5 z{s%a-N^Tw?R0flO*>rKOAzeL~0>!HpNjsSA2@_ooby>b!-c%!lv%W zP7|A8{jC)0Ow&pTCh;Xv5UG~cx!huZllOc69hM4~A8J?3ZbgQ2$!V{v{`wPzd3wJ2 z1$`mzVV!Rkxe10#x)yn2T5WMpJ?H00^WJ6iyQWMA$r4VOPh0-;{O}SlO9N$-yOX9B zj+Fwf!4asb=KX0XP@pf5etEK{s}Mi)z&HAdgws1@$QR0~UG&pkZ2h^8@Pabcs;~L* zWjC5=qu5EI{gHhf-&9Z>*oi8aAAP)&hCy|PyxjaOZKX zf&9QCl~z*)uNb7oY-I-+WAgWD=e9$VQP*w;p_nFAxuP#8^Zlw{7=em}LeN#@wzJkQ zs*iMD&g>4IEQ28hlj`gAPWPQpq>)A2<$c8x+@sfhC3Lugcftz>4_%^XUUXlmnurba z>fTR=Y6tNNa8LAB7-U@Ug$mE)?x!M>ABfEzgyPexny!prN`Ai?{4=u53`q^PoKh6Q za@l0jm%&X>s7o#in^m<5;u-4%-CT)sqzeuOsHc-ZEeYD10J6T{@(4F4=VBSac@X#1fC_N2k-L7Iw>=drYRNosG1- zr1Wdq_ACP#DyKp|sbtLsVXddXM?I>g#%PhWfclON_YMacgW|7T$}ys6v_GF6d(S_`x{Q(2&Jak zi%wfsFt>&UpRN4Or1;!0)w|lbtnNOCuqKicQTeFih`Lw%G6-r5R1SqP*8dJ{j|qUjAFGm%BO#tBc2kcE%!7QV)tL59 zd+S(4igPI!$(!n|z`IDka z>R)Y$Lpz&={4Rvlu)PO2mB~yak-|3UH5c_8DpypE#Yvl zq`o-0jpW^hL)>sqOQOVP;CseJcT8#Pq5r2W%e6s|i__F5j9o64+EYIahClJ0Lyxj| zml{r`hKewtlv6${0F1G&tkTF$@+V||^=d`r{_Yb=`LebxX7PiW5Y%Qg`^?LI(GKLc z3NssBM(xIHj$<0ceX1p{xd*(n@ugKy%kG}2sFqt^r?d19 z`(hs0iXFVT4`SbZAEq=j5QH`oJ7+~T!RNn;0hVIu`F)ho35TX zf+RNSkv!7S>(~zN3>#$?LpU~)UaR|{)?lk3pe42PJU}biPTarW7sRs8?EV{x&kD}L zK?dRxwPLPxTT!!?n04^x`YJN|B8#_h>2#1kY@;L(i)@#K$$r5#`1w}nn^b`DgcxVR z$y;JHP95GR_$^=vq`;>-K^E75ccPjClbT-88Q=$L{GAWnRIlLKzRjtKo*!`PW|`V# zGit^ZuV{S;QANWqrMRZV%1fl+769ZAx|c8Z3H*q~FDDZ1#xG9FUiu z@CC_&IxM$t3Z9!Y!Wh>?zkz0t{|1}o~f7Qe{q(NuYnn!cjI74|Os5`0O zu3@hEC>Pr_cQ9llaN=9r3ba>9-#ujj6lM_iaJ)NG3od0@&!`cBq zH9?z8KV>tz{*p;q%bF`@NS`_W!Ov>)-{IAg_Ul4VJ-E+9@jpL;n|(#MT5B%)l0M~4 zGk+X2yw69Vxnb-vKi9lf2(h( zUZo_@y5`$EpU=;Ls=qUFPy5z6@#{z%P7-($FKFIcH`80Gay*L|z};lvX_%AfSnlE# z@N0*V+%%v{lUlzlQWZK9NAU`>)pXB2;2Jrn8w=wiJ|x-PsQGoc=3Ad%=fTZW?%gsX zGOpTA-4sKaCg2z&?NyS*;!mg>5Y5AcLN^CrHy-0}312#t3B7@(6s22R>7tV5hR56G zEy$Pk3mxG-z1_@Dn~9@H>;(iVl8$LV{`Px^ zStq|(Oz=|X5igHXo1;Dl8H~vD<||#(W1y1yG5T;ff&sKceL_;)xec=HpTX^$FnALM zv5$d({QQOMEWl7{G^YJS-E^Q09Pi+U;V6#CU{_+{pHh5OXYe)X>93ZFkOXYfbd>;5 z;A&phyg#RH0cs)fn}|0`PEIY%DShLNSt!^iI3p`K0+mm83#UbdMt$F6tuH$NKla`; zD5_=)8x;ga5WxTlNRlMkmna}vBLzGei*(5y>EubIv&oASg&i(f~u0D8n!k zh9UFq!Enxd>i)S^_s93+7FE<#&z`+|ukK#m{j6s_eFjd??=x*nsaWylo)Affi#EOg z0TT%?MTE^dTGu`rk1v)C(lMIfmp>ipY?~{BR0f?@UaKp4pX$yeeGY0=Idk+-zbWjP za*c_T=RutYEfe0yI~AGt0m7)OjHH8H^N`s=RBN$u34hWxp8Elk{X|&GmpI8lG$GR9 zXMW8xp7&bZSxgDVCuHj8ZqIQggq@GtSh+suvEU|>C)Hq_TN{a6o!hfjT*dH;yx)uB z+u37>q;T)1N5HH$#m2{P`~KV=)rhnf3ptykgOsYH$c$PnlJ-W4yqifQEvgv&T-}o1 zrHQ#Da~d%X+TLE9{AuWV!!t6+^G3Z{^9|=3N=2@WpD}3Vh{k;hr`0Jn5F{@x7E0j& zm1{N~epT_JXTS1U%F*yTFWtlyW)X$(*^pO2%Om?8KN>#}94982&c?Q%K)9Ly!H(mc^P0RjzAYCH-6C znvT@vEdv96(=FPtG2@te<26@#O_ErVl>HR=n=UU($6Q=6K@ zn4}P~w$Vr9Iq-S*ERk)`#`1V^uJ_bgf@$=AYht{PylUc4l&OE~zO8uk1JnJ}6XJ6# znDgU@d`fdv-@3%M(SyA_mFxh&qnHaexKc;*;8m~3(=|7OCz+BhSK~G0Rik}yJ+|%n zT3WMY{81CMmdF01o~X7>aJ5f!EnKTPf7=~dIHMlQ1%Ifl`4f-xZh8jBYI@i(`KO(V zW=>FVLPB6hRj&Caohp5mscVSnW%wUfNFV{hS6a&VJqB==Vt5B`&Lk^dkL0=| zD8sIbZD8pjc*^v$6e4t!KvLy6;(Bsy_pw1UE0e@7MJM_2}t{%xG&6ZSU?o8|VJS48uaVR^L*lu!#L5@Na; z*m1lZFp@Izs}yKKSf14%3j&{P6azA<*l0i(VZb+RffFT2axJpliVLOy!4n{|Z+S=H zitNAnJmy&b=!D_B9W2F>;5AuBA}=Qq^-W3o5WItX;h9}o1!!PmLA?BV!Nil~B=n*% z*AWRLy$GBG&!5%<9_kAfroIU4QWM7MX)6M3QtGt85-cg;DT2yrY;n+CMb!Gv``r7W9Q3#0u?nv_-5DJZYA6siBD4 z`9*>njtejem=bZG%O(!26__s)XsEF$kH)sH&CQ=zBj#Kodueh?!faP@xqw)NLm2t- z#algr2AF*Cma-b7NWcYr4LyF#rK-i}^#2sN83W|0E?GX!YgnXc5;p=r1~2iGpQ$;~MEN5;C@`{nxw#bIE2PTW$K`jf5HiPvDJxU`Vc2aH zB>gIu|IvD_5KAEV%W0w?ehG{N8tb8?|6+XrHv2#U)bo%f=U>-iZ%wN0ks@aOZ#I}Y z2g9gQ1=jYrI|5_lRqqF9Y4-or0sF}<1?YnRf2IF4&Hp!+ z4qX0Fjsy4?Lj0oQ;_M3TJGLr#w{G248NJQBH0Ssrpk0qilgsAzP2rhiXi)^y?~S>OcMaFSW@_ zj_4qW5d1*2Nnjdv5;i?Kew5C94#_xGY{&Zf3y&DMehcW@W&0WYe{6j*AS9K6uHB{W zsxfJEJ0qWc+A!y|R|a06E&wR>{Qey|;J4SE(hJy3+~aSciw|E0D-JLEQ%4S9WYo33j6IH# zP_)>7t;xny?B=d0FCXW$!aM@;%41@2Wup`#R*^O2G&5z#b42!1Dse0)=4Q5!w3nP2 zG?MW)B&+I=n@jzQ>;MB+A3I>tz^?^e>Q(cS~+k2R&|0FB?_Vr(AQ!DGI%?NIN_3j8-GzHR_IQ z+IJ8>iD&lmvxPMoucml9pH&hEKB9QQW?K6S-*PUcp}4h+{7<_%16}06$<*%GP5wBW znnIupB=5vrT5kS-?NK8Tu*S6TQZoMX};K+WdtkAP@sH zvj?4X&`X#K?RX0X{Ql5tY7+EsYaU=7YMWrhG?mWA(PeKAqMVu%pZH_G?7CqM29!mdVgFmTIe^2%FOsc-EH~ zy5~+2(%ZOyeBbaVtc#qvB=rc2=8I3z`P$zYZZY@Wvg(m@Zke++$85AA`ZF$$ji#w zgr(FKuzFuiMp*wTb@R>UxS{%3fps;$!-vJ*SND_t@yxu_nE7r%JdWlv_s{ZbwRq<_ zh{BaU6m^3;{pGnmZMxrcy}5FLJNxsJPv(UUI#lZ1hIN_=+^{qSnxhSHu6{>Z-L=xh zlB%i^^k<#*?9;R?sB0lxQ$Pzhi*xyuTGE`+hm<&`o*spmxRg!u#CkJmiPhao8Y4qP zmcqiqn1b#p=v%?hd;-imyVp_&{pyiyU>|ey_2!%^7ZVEU?nHLOH#q<0Ou7SA9cu>7ps5DG==I&+ja zdb#iH)E{Z<>M8{9hp@0Rhi=wfPfJExmrwmP5}gyx_k0}rpFukS^mvC>GDw|dhVkVb zVWLDufVfYjdyDfj#%Sd0sHw#LoI&K(2fcB=V(c&JcD;~IFKhF@~a*CItZ<*^EoFRs|L5%;5a8`|oJ z>RehLTZ)V;t)Cpj_XgsQp;xk3MwEuogL3J;9kNQx>zz+~8uL%J()?Gr^y+3ks2H4~ z=atImNRlasCF13iQMEW?n33G&_M8fI^#U4@SocI9euvZ5l$b0pT;7jnBoS6`T5&6- zXyGzRU`;%qFWo^#-ZoKh*xfhko64u<5o`8zJr+CdC^igHTYgVn76qiMIVF!nW)2cp zg49~$@WH0bPK2;F49SkIU<=*nKPUR_1}u44_@FdXu-3bPJpc1kmxC1_g86D}n9 zHJ%&+>i85($)~}ZiU#FXy8v^HhTTkVpc5XuBNCYx0<^Ld9_gKCjie!Ug}w9ihJ*N znVt(kS>UxiLX8w#drnDShN>n}Zhb!=O7aiGkDf4E%WYZVaGRfJQiDX4)(?*C&0Brl zn?H9Gb2oBoswCnMfBSY8u}f|<1@P2ZR8Mt6h$)$ZuA&puS_&q-UI3c%tanW_)?S5Nqu7#U|dVp=fUYcZn&MuIRi^pJt;@;IPM z1C7!%ad~f%lixRkPc*is2P3k-I)$eO9MzKVb3Xbc5o1MN%0uV3pX;+f;0fsPLwPOC z{1Y+RYVQ-z&rp;UA5gW3_l8@xE)iE2rcA0VI^9G2=x3cjUg^P-hKONw+)1sxslv;@n*>M*n|fLyHBi@(qii)~nj=G0 z%G&*k0w(w45obc!8f~h8qbq{u@ovs@{)QfPA(|V-omy(*Yx6OAv15;4z|p+wD7Kok z%3W@#Zko@T4rT2*2ul`m8L13yo@=0~pVCwnU3?%^IPfuUakZE`de&oR5KV4KeaPA+ zy!x}PXNr|BU&`U_3>ek9^Lqc5>PHckCVNy7F*TZ%NY}Y#7pF2;@(c)~RHf~cPODD> zq*Lzl7If>qJZSJl-;dmq64jjp-}>I+PnV5{7Av!PhSR1Zmn}+R>cke*c^CnL+JK$c z**9E|Cx`VAE0345`YboKmR72W2IDNfIhMZxJeW^ZkHkHO{Fy|Xt2svlrol$_^LDPp zc6`Rp$k22@Hc{vL+LZmF?3t*gkTt_o)V^#Ov~5Y$Aer0L;6Wo*lxMGeII33@$XL5r zW#~W0Vc9TvE^^~Ks~JXP0&O;q%Di4L0so9{nmUb2*qrNJ;n3~PVpcMFC~O2dYK67` z=)M+fnQ`M=O~4Qsy(#`#p2@zLOK^4={eIdv>?~kpXC6{dV=`=cjLebxfX*^RSy_%3 zRp*uU4<&kwJa*5gsrx4RGJ{AHN!#CsY^(2Es+ZVoXmUYS43LkMtMOp`Dh)uM^K5qt z2Gg1)i+qp0(J5!$*C~uK>j{h!r;oo7n~Xc@_zFwqogam2|Dd1*_&URj6XR7wTcS#N z`!j~U<8#B=H-x|9$2na-uaOVnd1d(d%iu3(jHelp)+;Fpf$L0z`L3XmY_4d(-di+f zHexiHeP>M|#b$Z*{PQV~T-)>%#F05{)5q8SZk~S@Wi#vW$ZG|ym6pD;av`tDL7gp@ zNm~P+B)DilLy&-a?KNL2B@eY646~FfjN9pchF!87n=(5)cV&{BTZ4rz@}D}R#Eol8=n5y2ML67eE`1layWlrv@lP~BH7M8Jd@qQ?bKf7h6Zx%AxJDu<;O65(? zUC_6s{cjsnxmqFnS))pn^%2Tnezo130AQtpN7|FsD*4p#?e!n?TC5ueEcoEaG(>9E zqnuUtHv2Wzk$k!L)T;*PUndU-nt8rKl%2j9z9p|Y?2L7TrVrOS)*g15_t|-gIdMzE zGWuDzD`{nT1g>wl&{up;c=6-bhA{V-rHS++)Khzz&at5^wYhz8h3GL-T%CwzR8!z# zp*P9ol%oVfXK!RDKJ!>?v<5bTT7)`b-c4@{ZG09%lvV3G(mTln@s0BBiTCrTiV1!} zrsYGSttBQT`4TVcQzyn46@q#egN_?^y(Z?e;a?^GOq`PKcpLt+bQQf?vvs#Cj&ZN< z|KJvLshW*a^?&%y!#W}|r8IwtWj%@Cy~&8Y)5;n-TAhDoQGwTg(R|HT>RtVvuHF+| zw(=ijf`PSreov^ojyga0XqE)#4!9llB+fTLXyBS(t#XlB67wn_)_ZOHf+wq31sNi_ z*!XNDO_4Lj$6pUOn(5pHCvwZyYV`qN`zZ8US>m@1YHoRIUYm?!7+&hb0*F)D9&%g@ zjA-RMOF?p$IGrBvd-TQl{EHa?;mNdaNkAkMe>|uTR?l zN$Ud^#R)`X?w&O#`tKz(6mSrZ8%c24k~NpP?~gqLQ7AFHorOznHez;`V(zI_jeBFgraMYm_B+Ib`0{deRJ>pdRVIfPjH#bo0 z-Zc{@VjDH^2y!t0wD&MuE$*2}VD!L&-R(2u7l-FPEYxL)1dBsiYY0?#Xx zxCfVfTq>tYXwdY#^2G_C8p|iDVrO(B+4fEE{0~*Ux8j9zBlr7fJ$D716y80dd1V`W zgylCnu|>e#Qu~;v5!O(rWT%$a6wm2vPLI~9QGPi%@bs$gK}KVg_1nSk8&moA5Vr{f zu}(DMG^sYV2ZF~aD{UwNPhoUvgJiNasJ510ZJbgkTv2h^me`@~aFJCAXNY<2-9*#t zty$$UT0Nt#=d31)BTd)Sy|;Dh@!rNCR}l@l^@TOuLp<$jGIjJqpr3P(CE3-(B+;yu zxiWbhG3;_SlHOfm-3^p>j@?8l2f6_bc;3!$(7a8lZUpz`h;&A0eXYtNRGX z@|MH0NpKRe>dIjE-yw7fci^_XK1jVEt-V`<+pOoUP&*@J9#fKHsyjq4EG9L0V$S$u zrg=LIbaHj_)Rn`{`;}_a4-sKy2hSLY3=6co%pgc+$Gs!2)D zE=zI*5pQpnD7hV6euB7WT*+$+#%yY!X#3^k?A^U5EoACet(;9{Mw6%NDxW8C4!Bl# zf^TE=eI3|hiUBQD$Zd%z&n}78iMTzOqrseuNn4dRY`sLHC;I%JAm`+U^Cz#)6*UJ5 z(MaS{D$L(OYY6%1bjGdO%W{V{S%ez|;wT)Ra;N*qNY;96RqBLIt{!ANWfs14`|cMd zBTW)udTZxV&r^D(k}h2C5o=NmppNzXo@w;Magq+EQ$jj?pl}hKWCdPUQI3sXvH|=m zkbqHsRiOn=1pZTEt+f(PVt&2ZxfgA92eSzT1}2TrT@M(u^hpoyGOTtD9W>N7@vP!n zOnj}~!_?%_aew*AHLF{LU*JN$F5AN=tQ+2&b4C{G=YCH54)iw*`2XDTPqsac zjy4VRgD`NLwscHFyXRFW&9|*)JTatiG6INGY4ZBAqO!Ew&z57+)fu0-;$zIyN&Yw+ zf*fGhpihQc#;d9-MMd2B!Q$_e%u2SRQ+t(Uwxl@6iuY9$`D<1JJV|;kHmMuN5=wc4 z0~r5qreu=MO)JkEmvD4`BesE8fZZmsg5O7xWI2w9xpC}hSgp1x+zY=N-GV?upN zTe0}u6|${=#JFT*ZXK4f(88y|55oI;b4pr9xH1>d%^7GBN~wRJwu*fdy|<^NHq!05 z?|4l*M_(!N7*r^{^~K@wayYnqERcQW&&x|%00=hYk~}xgoeKI+T)Fe??gdAT-`YPO z_$_85b_-(82X~umvzPx~j{s0qBWL*=1h0uXpM}xk@Vu#^@*aYA9~3eR{KeEJlmjwc z24)@+;;@g|+I6p6?!%aMk`sm2mJrVx2!bL+$UHxcqec9f+O{}6z?fe`cOqh_TM=3-%9^R=YBzL?Ev(C zC9kmX!Jh&8Ycyk#R$@ zP*v^#K7a*JpWI9N)y9)RYkqR_w~GX9Qj-*bAD!vNa%YTmriRj;kFPEx?NW7;{^o^i z8O8-nPHtAofo%vNXO=TVSy4G^Z_GkLVbxz?K+C=v%9+B+Qyz8ew6LhkEPbI0S<{1! z0uZEKI?pEoC2KtgI#PxTKJde_3}z0-h=p90+~oAe;3xp!rCMiIlu}4~4UWFXnauMQ z$j}8^U*#GQEYlKc`Stw!I7GUfxlF9L)a&HSd_7bZ72U+XdI*-6POtT+;A0zxJ`HHn zrAGHcZ0u=R3io>XCjEg`N1%^Kaz;;)}1ncPFqM!i5 zjRV09JnXwY#)86H_L>yGI=(KeI^UBi55@*#8uIdsTy%c9fH3gK?9bwwCWRDq0ul`G z?FuI-@f3g`2bc!Xe<}auimihN z`quK(P_Cv%UUV)?Gi$#6%gVjkhe|P;2NjEsf3wg(7fBlE#4Gm<#VUO9uGNuOQjH$# z;G|55H))PwCEy1{2&O($zdP!He0Kv?RDQ>`??F?noY=O zMLoK?kkTL1Py+gND<9xes33&%DsYi8*exJ+?J(7TL1 zb$j@yN2D{Z1CK!cyzFK=jgGyjP57^_<(nH&gcChkU%H{ZxiS{R+0l0zce* zbn>}+`GAkduBrvt)5ak&!cUx<&!br|MzIu$+L-&9;udi&&V+~zOGy$+D` zd=B?_C9$27=DxZK8P!>nG=xK`k0Zx)=w6S!k|ky44ciE_l(-DuyGUg&Y~-|nqM)Q? z1VS3ltit1?skt%H#>L4#LBtT<|L)ziNL*r~QWEGvd_sbvre;hI6KnI*W@F-vxaEpw z7W6F}+Y#8V2;L151IUwj2?_CvjjN6lfDHTA2Mg2IxtGi$EhWl*&%_c7Kh`6Y5KTS#hi>S3YFb5t`1N%dDxPu~^0NfHQ8d zh99%EGK6*1!|Ltgm#qhlIDMPe(4AYeGg~?CxA)1PB&^v51_>HHfNX@d|~Hz zkfayK>zK)Yj+4oZsdx52f3|O6vSQtz!klR0UwjYpnW1VvO%&#r?f0Yh{3Q;YIMI|d zEbN*{T(LCB_gLm|IlO#jx4g|$YJMWw`F{63LB+Zmhv%MDL@gliT`}*q?4jl6bQXnl zkk~R7&dqjDA2dj%;_3ys!^?pBcN9rc25xtJFdnw?#Twa&-*_Fx8^Q}REf!^ob!hy0&YE6G=aJ0Ym zqt|Wh*;R!#)lA+gJPFhDhf)B>t8%z;oX$_L5{s;x(H<08@v1*(TuO^|-g9>qKkewV z1T+ETwIU^|z8$@WWNN~@?0JZ^O+M2)$<;9gNGcOHv^k%S?#Gx!PStsbCn!{2`2cmP zM)y713fT4WdWW5fEbjH>K5fVCZ9K}1H`V79%u5Fr#oIh)IDB0d7C+cif;HEF z$)j$}*ox(8iw9(#l|rslJ-ABO5P7nHobGZy$(mcyAU{awYYx5iP1K-r|1rpW3Ca7i zmw(D_32lk2y<&d}Q>_mwe|%_a09mJZ);qM{^6~zG_Oxg&t&1W%JlsjTQqN~Km|#uY zsMPl{SL|&rulKZbRbxW85};ZhVZ58(Y+3rrFb}}IP5sjuFcL?vIYzznQx|&oU^DnG z`^ZHpO$Jx~%qyxpf$yURzBO_03yLwK)eG^ni21k04c( zeK1Cp>O)iXRFYDyRMCXgrctu?ia*!22SzR-J#EUK&89y4Y*ho~$&Jo4Jdc)`DB=u; zlJOg1vo4X#tE*rAQ7uvcUJqzkDN_2LS?;XgURwDYL=xu*g_OGVVkGK717Y0i(7l$? zSp=Y-6}fPkDryc$e5vi8^mb}KxtJtR2+ z1*efSqC4H63+2BPZ0xn#bIVD;%u^K`Fl@)AdeTJl3>7pf#v&i@Cr(bD*jsWKZdrN; z{ZV=SrxDYL4r{@?8k_drY9cP76!wK1*of2&#ggMK{TnpA@|x(hJ_wz+^jV6S-W5C4 zERao|<2gk8-WS-S8kC4ZCX^l_Ve|G9u~+Pe@`!0pT~|$?1@*Fxp1n2awNGUkPf`Z{ z1eQUICX-DexT(A&Orjj4#QwF;tH6X#>W}O3?E7r&+IZRGsW2F^M0GW8Vssr~cFfy0 zmjWII^8&*%cl`5_kj8srAu+wss5Gy=Os7}WeT!>7S}Ue{^UFhuO>ToOVz1GH6DOKE zoz7eWEo;2__I3S64Fy)^!!k~=GPK{&gb&vgp6Fss{16r$UH)Dy{i(PRy++VmY8A8^(C7SGkoy?+BRZzSot@f~iZvGJ`oWG3lK9XFdg%S-6#5nV#E zYN7HSY^%a)l=>23vnXr6hH1`xaxd>5tH;pqS=Gw`3>J4tMBcmnqphdG8WaPZ*YM;_ z+{GE1$Tu5r%aK~M<}y2!Y}Vat`Kdx>`Zl+F@AXo)Mi)yz$MXDv&vvm}7M@$isHl@y z(iHvR>VefC;t3-)4vU&kRgxT}={RDAvN}17-L}qw)bggzlB*tR6NS>ScqP>v-ujfl zvbB~r^QT&)iQQd?P*LYjM-PW|T9aCgfHoaRs9r+I@eUx?_c<@1^qJ`M!TYDLN@sN1 zUnw2KfdhLIoJ^|sZj}=GV=AX=G)(OB{N8S?X1>5K_Fmv!*+VRC-8=yTYoA}$nM37{ z;dHD`3brSNz?tv)`_gCkO{$x}J{5s)EN1T~rg~0Jn=lQ)Xup(Ak78vhPxx(%xaTz( zW?fy;ta81IeU_`6!cGAEB7r)rsJ+s7X|I$-{F^Je(o2P~|)t#jzeu_2MwP;+pA9T`$kqZXehJnNc{6e%w_+?RBx7(@BAZUGpYsZ zkRdhs3W!spJtbm*Xz1*_3i6pLCP8cl<-69Oyi-aj&zc3~c>SEGCHVA*+)OJmQ3GmA zwC}l^I8WsIXJH}=o@h>!)umF5L^KeG<2_23gTZG9Uw(@h>J@KBF&!S_H+}B8Dw3q? zT$$MjaHDNNUR^yRjE*Wv9<$$w<9%0?4vo9m*F2 zCdvN+M#LM9n45sP0NE~lZn1N>#-+f@o!Ll2124eSznY^m`x~vV^ZckWaL6gsM#rOD{MbmH^e1H zGn_ZBYBmD8xGUL1tsZMtK9Qn3W(L-iQPVOduy1}2F{vdP%5YK9+Y)Ua>=_jrW zv=#LU3aq46Xg<>ymWpxc2~Zz?J1`Se@q&a_aVd|-c6UaSQB8Ad$unzjiH1DNjZ8d& zGo)ckN5S0B0o{t_TiPO2XHu5}4FmCL(9s2a+pJCA++fe4m+67EJiB;-f}~gka}z=D z9K;u82~cbS)`%}7OHc11nl(cnI7^tXZBkwY<8%ns`X>^=AqXlY8zAgL`o(RxE7P7} zIk%%ml~<-6Qf0?+`Ol$o#63#2m~U3zwPwR$;ZEWoRgm!2L8Ap+1$cR54_HELFRjZ- z#G$TGTV0zd-^*XYndeWWiJ6Fo{AxoW6}DRS%;m^JZJ=2#j(cFSR6v$U5UoRcZ$o*u|>4H@Q{hS}* z>t|t^*KNI0pfg4YY*5DpiSd6iECp~73|>Fb_3p?X1zvMFm-}fi&GS;iKT@CMM8GIC zucD_No+PlPzI(A}ApMC~61s5mjkRg6uS|sLH;gGs3ha`ChI>m(vQ3zPHMYEY6@Iik zj@8>atwN!t8eY#E*sa%hr3`<@zPF$CxC)7Zip5H1G0A@{BQwrKtb*BUBGfzkA zhYPA4|12V8vX^Y!&YWF|L?tN5de4Rq3=g<43B=wUYf<>MCjoXC`eYSbfn|lZF7j=e zyuLq1rtNYz#D0kGUsLJOZH@*uo7gBm!S!SW(WaNG^AF)_#a<}oWi)l^qRdgl)J+7c z$N9qG7yl}mhJ}S?xvA>Hl-1Joj5f#OEGWgj(6M>rwC%ByM8gAj)>rd){&PL>34nM3 zoNcZ9+rLXQfL;CN*%NKre}OMHz)so{aqa19si z&fgB7T_B^Mhdlw{xGAWrzMXctl4nLWpO}!Sq+lQmWrvvJj={fTS*}>vMIFE-g3UHB zc(A0PcHBD%;$2)aB2J>WO7@{fyqml&Mn+EP>5jogv3fZ`9yBevt|3v?~kuF6y%l(9|f~9F+#JTj?7Bi#9>`5^nDe+Ym4-`fBXHbmu$*+5i7k^$IW! zPeqN`H8Wk*I0!OKj$|J2#@@pWfK#p%Lkqb8yAC_y5?{WHsAQ^blkD`cIluMdLfJ9U z3yVu)$n*TLuM$T8O3d__tR zlwJ}L)cGGAk_)h*t;WuUTlfod;$kIuGrIDM{`VKaG98CfA*~?>- z+W#X3Tmy9a9N8X{e;I=Ss{|ZCm0a|1P$iliFlx<%!{2(5zi*BMFd?t2KiAUvW!>Me zO+NydGn$-P;@_qJml!#4`OhJbQBhH(D4m=?MkBonRR87h8|_bc zoKecd=X<8ypNU`Jk;C1xzja*o8sl-VmR;u;Qcv%P^#=J|mkn+M$Eg+ zRU`@NZn!N!#-qeLqB)z$I(IC-#jX(i$F6?__!?Nv#Nyr&?(uuQv&Mmx8{MyXx2But z^sCW7rvVMPSxd>R3-G?(?`Pw9tKmJN|JEv2nDnOiT!=JkLrdj%!@SW1dfWrYyKjG` zo&M=DpI-rY;HwZ+u>$-1j(8Q_M+v_f3YRb;V6$_By6crR~W2J^}iFx#lw7j{RPrj$C zV>^uCh{fyyVn-_gOX_QkW#30%5YZetH>he_a%^J+g!VSujCJY0{5)4XBAa;%USGtX z0KW{GwskPlfP&#m?zF7U@0-Pq1TTxI@X)<90 z@$<_(5qzF-hm6dAK|e7#{!5C`l$qF%>0G61Yf;}9n_5+{`N(leZ-v;v0{mj#^jqn& zvs18>DMh{XBmns}PVV6rb>QG>J*!hb_kB8s=aOr=QspMw8dqE$39ajY{5J-t3uGTO ziZFoW=-)}|=-AkjA@JX=5^XapCG>pJn_~h}VS}!3%&XlHvyqr`%SK!7&v@^Y7dyv< zY319hflN$FiYAOEwKo!y8KGb|*aCMI9UaPVC+XhH5rdu1*9wLq>PaQ{M*Wf*B-GAi zJ?6cy0<*hakqsKeQGOj?L1$bAmJbms7f0W4M)RP2_6qNLbR_XU`#xqk3h=tr0lhdo zv%~jILbMI_N6TDa&9--d!=!s$l7yWr{iHM}EH2Hxa+vz#@o|~jWA0;TII72iLi6YH zt2~BG$<9@oGajdwF|)#b_`nIJ=LPQ|`^?^}UtktN?l1reUcGAn9M#xp!XR<>omy!3 zXBUDb@$=`eSE_WQyHRbmvm3F1tTJQWl&1LD+ycOaFwoQ#@e@wl_?TG^oS4b`eCz&? zc|N%+5zF-v`sjKmAsf{{fpsL12R2nUlfr3;x9Qi>(Q#ivMJ2wfidX2hfPjFki2ZPU z5yg?3^2J%#7r!4j9;QUfGKo7jr%&gaz5I3|9D{^+g9`X47p8 z!wtRR(x5Mfm|F_N=e&HQdThnjFITu?36Z%xJq z8$Y4~+2cG9)5=qr7l+n3ij1cX4Vvm%KgBKgMFoOag0`60BY5vnlC z&*r$*C^TQ43mX($^ObNm+(NawjFIn>bJp-;oTAH{?%)*{=}{Y|Cyb*FC~LISb3t^( z460-KwJ_HDCh@s0s;=TM-rDK!k?`Oh=hmJ}kfY#4$Gp(fiQrTFF*bIsA}5{v9=$IU=}(>eYM+R;zhh&9T(g&@x`?rfzPJ4vo+$ ztK=I6n4ta7JzB_b`Dyi@V*R#rD+^NagQ(FU2O(6d=HzIeto4@f@=NON(+{NY2nh`* zfoxyvwRFCIFnZl-iZvD$&;P58A&~nGd+TEFPY=@>T>CI zTUcF$2MHV|KBk>1$1>aGQ3>^&pBkj~kiP!}Et~wlkYf!5Fv1_&`-DYD5DT?q6v5dNt7>Ivx))2FiImZqb(*0L-S~DTYZ}R?lZ0ke{TUCYj=CjZ-&Eg? zSSGaEp{rk5FvGv?X|UpHQDVFv@md6~uN(DveIg_ho^iG442fAjpTJKYEf2$lG!&#m@MZ22C% zgsis>O}7sS)iILH!8$iQJqA?HuS=nZPci$n!!yH5`LtC{ArW>?Ik+WYmF$eNw_+=S zE_^7J(R*Fatw4(Q!8OE8VRquuPtvzFA5@dBA`5);m6M+(8hbmgqi0>~Q>6=h(509T zbN>3XQ$oZ{rSJMD?YpN|%Qoqwjg7=R-l>GI6VH(>&8RwrPueq4#5ZX14}C&w20ZJv z*E{x>6QAIYjs{aY^Y2RLJ>k+yXm~;3m{|izyX%; zkTs`u6Y!ul)^vYI|9w}db<}8-S>roOp?~_l--QIKrfux1@SHlc7GwRsn(Poq z@I_}=qgpzdrCDyJ6s2oA`7ZUb>#3iu)+{4*43gTdmg?x+S58Jfbsr{B1_$gc_@~vuQQq{g`?8_=#brohk~GtUEKVvz@KIQI2yI6Y1`Z!QpIzC1gRwc? z&LZj{ou*4aVHEB3AG6QJw*{m<{Y6)6(!m8Z6d^?$lZ-8i>N4#9o}bi8fB*#p=MPO< z!dKw=&upWci{0tOQs`+3Q-@OD$(0lQ@RKTPiV&9~>)PSaQ9CU)OOrr)AQ%`>Fso}s zJTvCB`>tR{?+Zboih-K@C0e+^osaZ^oXl|b}- zQ%h#b)O*+D7`XzQygf(MQd`cFoZeQ2;hR1`f85Wr-4}gws@7JGyy{5yY7I&vwuRo_ z_g|9{?YP{cJE-IP9sn=PhtxVqL8a>=mec*iw+jP&hFc-QNB2ArJ}qJ%5bhHWZy2Nt zLsak5Ql|>()NdS=4@PGayxjs1R5)N7Z&u9?@Qi&1qtFQ zs1C<~_c!JS1ZOhTbRs{dKZ@&wsE^wpZLgU!gIB?B2)lHDvHSh#aB0iNp~VvWQBqwM z^O7 z6#jgT2Dxn=3QzIgEsY4>v=M!g&hSjNh}NF27K!KFJzh#!{H)DeT+TIm14vVvHuQR^ zC)`ym4vJLJ$_r(vK1PXsj?^Pl7O2scu%8}-7jX3tp`UkoYi$>;>U6baynLGD@N2`# ze;M%Gd^XE@CFali$Xh#XGP!I4x9N`V5U3fP^&K?hU*iEsl7Id7o%_7uG>tSWd##p0 z)t4x7U5xPE`F>h6sdVvt0lr%eeUu=YP#k^IH>V{yV>OUQ4Mx{gM38s=n9P(xi*gzt zJwI7yThyd7JtQ?5K#aW-q&VL(7X2z?+R&Qg$qL;Rb4K|bgwZ`)3H2lP9Pbb=O2i!k zVD*jbK!Q}_Yf__ya2OM-62M9JX<46+`iQ!#JE9O*wV|r7{uObCNk$QV5(PIpA|^l~ zDWqM%j_1x`?wVcbq|JGglK@65{EqF}Gycc!-Y;K12q70VG_WU<(u`E41tmTN2@ z++Fb|x=mXrG5(loK79K8WAc{%7lxCvgGzFM_75bQYBho+VAYX2`JS>M10?WBd7HHXo8-L8`eF*)RHg`=8NBK+2x1q$H#v zM)niz=H#50j;@iVE69cyXFIYhrFtzeQN|B8XJHaTbVo_dy=fHfL#8>;~o6% zp>hQ{RIpTR+3VCF@<~|m>)K>++5>+Tl>KbcFyxTX_rvPF<`q*+@M4|+0s8P619k9g zS3hrsh=5GtcQDWyBw5fkVIW1IyOnA?b#}M?xd+TQavIc(yr=6j-uQlhF{hixUH*Pe z0^|eGGEj&IN%v?i8+wj%jl z;pguWzTHl)x$OA|6bz)o zEmnO{w9QLGYU77%nDaF8Xc(8fDdj07-RJ{?uBr_!Yn83nN!T5PJaje&nSA)M;Hyu}~phZF?b8;4wLwf8E zNW5hQdc)FTDbsy=&wv(}!Yis! zWCCZdxR7>2^z8J7{@tfC+G`MbpRa3g>~K;}eJkl{SiMIrpRNw3)2))d$B=1tze~Tn zdd=>QlL?NMtEqvmSmE=>IUB}0pvL`yHyX6&WFM;>+OPP^c=@aasmYX=^xv_Q*wHb~ z2Fak;+4Tq0_=Z&UxM^#`NZ3-B!`IgDO&@`0$u>>>F+mT%NIYy|>$* ze0x>52pNOO2AMm4>?>-LLtj%nqBD%vlQQHu)m`gY&yAbYJ@3^|J9qL#j&bj)pGEOF zXc|(gUZCUvP^!WXXxzuTxK>RPXnT^5kE`V?YD15|=+Pi= zgLgqb=mAm@x56ll#384#H80`a>b1e@V&?|2*X5azO)BXzeUc9!H1bx>|j z`E23WZO6L;b)AAn!BGdR5W1s{Lh8v>p%Z3fLz!oLw|SbSHySBGc1BK>FF(vbng}xY zG^JlVsSaW0F1=Yh0Ap;cmpDatk>b@#7q9xKd7OM>cpwLOrnJrC(blv5tNZmvTZD-V z>+7(@G3KZI{aP~Gm>s2<>oirxVn@ra`{~vog1}n)wfBN20P z&-}UKvhiOHV&Y$rjR>&rkeT|rzb^mT6l?1DqgDR_b>ddKGlYLf%A!TVr?&F^Fm?o(z@0e7iZk&fJHYY8FtS_tLUvWLcrI+C82D>AdpBV;zApV1Q+kB85{E}!4_U`ns zEMH}>=nw^oAGS^DR^_bjh)y*c2p;r1O=P*x(hVl}D($vX9WVNuLA_ZCwOf+-Dl6d5W30E zROCH})1fJLILYRy;Kwr*al*TCOQ&~(pAi)5x}J7WjDA}YdHSA;np-$iDambD*3-?m zTa~u=j{Ke8*1e_mrf9&e^qHS*wD5J18jpM0o95PzMV9mWt#Nb@eh?Ei?%UC%(=8r% zsEq`Fbh}1^wo*+JpY4i(N%L_y44HUVr60ThQ~Sz}pGkM^;Cu4Ty7{!`>ANJAjIGqS zSFLCtxxGnsJ-Qb5tgY!r{`;4ki&uk>Y|uLBlR`PwKy8p=#Qw~v+I6wajrdWY;nFKk ztKoEHhs@efy(ZJlXne@V!u`F|OmF3GXmYsl>>tM5&Q}%)UVq_3CsN#g*n|-z_eQOj zwc12?EKK;7#EirYbCfKUfj&L=jn^?z;vJgLRuRk9I^B6_SgNz=wfQ>inXHkCtE+_P z`)T7vb@!P-P#pN06rlsSsH9DMII36Z%shJ;Ui2)zgG!bY6}Bv0`9gP+fJWId5WQ)amy z$HOXBTiR*xHb}o3HduI{Gv5rm{HO&;xvCsZS*+1CPc?G77Sz z_ohuH94mA0L+?xJLbV8=Al*y53poB!kUGD_gV8Z6CJzcb>MA04`BtGz{N-JT(g^&- zg@G)Ow#P%9PD9M5n23T(w{S5Y`S?X}up<`@KH?aGB$M z&Uw!{_c`~u&+B#Hx6^BWFAE^ikhi%&bM%HPvt@`g#{dM9ET>`=US}6*1)(+G3g;J2 zRNekL<28wh?0f2ML3u2(&15ttv2=V**QDSHU&!d#!VPMRiX4zr6<>PSsf+&s;`Noa zByI(Ps+oF{P+mvn21&S@x(+h7Mqqnapj6c(exU8O$h=w`uwhD$CAD_2 zLuT7`D5UxKTUj#;Ju5Oo$`wL>Q2FTlc#PLCh(5@?XG2GmZTszXhPxk4cRnVF%b_~1 zVdv;M&(qHPD*b}C&M}!`wQVOtwe9aq-rU(b!6QY>(|=4$cy%e3h(tpsa9Bv0c=Z%m6LWJ4aHoQ}cq0)c*B{8gPtW z2XLEPg2If$tL;4_Mb$QmFw~o5kJ%B+DMx*t8+B%pO0zYdepfjj@NW^!R5!e=JF)HZ z%f!O)cU(i(ah|RxUhn7FWBGO$u!iy`Qe{}a89gi-^8Wl)wWuVF>eZvzC08Y%ZGuYE z@G410d_BE$T)T$ZJkVNw9>~fh zVeq&Ky45uqHk-9rfc+5{m`_v~?BNX%8`H~ra~Q)ScNn<=WMOd2>rrqc{g!Ev&t3G| zB(#t6S-OPpASLRTj|v(nlpKN%kmlA)oO|r8LZDV3NvN}=cYPjD=Tx~Q%i@lj46OfA z1p;09Bi#>SO8!m`ul;!E>dR0ruG6VJLA_h?*rR*j^QTd;bLJ9E`R@KXVAr1cWFD;h ze&Isuf!&Y$xW+mww|FOpEc)*NBvEd_tTiVFGtwW6;La|eayUn9EZnbJv;McBL7{-r zYr+jiz^xc<#ry%4_&l-mlX2?DS|g~oDSOzAW9FA@S3r9<>_LX>!qqJHB2gRHOsV1b zT2zb+v0Zlv;OC6z+7B=wkb35Z6aE)6nh#+kA$xYg0pzk|jquGLj7$R*&d3_Qo(eHF zoWn@u3#tvfdDyJ{NlPTQEFZ!n6LnL?)k*h`B7F5oaZ4Q(!~(B`mhlPgf6%`!G4<^H zcOfF3chm)nTbhl0zL=+oqH8bkF-}Wyhcpl{(-zXrbng!Omwhj+p8X?##Yv&8Bg~1p zVQe6Kp<}Vb+WGI>Mo7{7xf>mu!1JbxJ824co<9dXpM-Wo%jZZKE10p1r?@gccy93h zBdr5g4~}KsM-@%!A=HyVXBraO-VT&AcjQf3nS|{laVjm0zF|))>_d7>d zm@b zx9%FvfoCSru#$q40^bs0y8*FwoeYr2SRQ5lN=iEN&%)R#7t}b&5_9rrlmXMf%5R4p zNR#CuCGCsX?u#~Z1I>rZo$vk!y5A|+6H?E+x+3J&wIEvfF_m4{-Z#knOJh@6!Li@_&Z(fBz^qwnq8s?#Ko5 z!VyuZrJ;-|$pDCx5ds9?# zapO_q?<~LU?iA`J+z+*FO6(qs(;1`r%E-41;K;Ik4;%b=ZqWk!-oEz;1uUL-W^on& zCYa2a1nZWkAeHt5fzjWRMKG!fkn#J@5Yn!n>fVOLl5fj!ecbQR#Gn1$cjq7K7udMP zFYh^W?Ns0SRSfud#mtxDq=?|`^g8 zVZVvzJ+*=Gh&SR(j(4jSnDH223s-4rdMu~~F;v+l8>ycL-pgt>!{)6MU!kAT#muEZ^z)enO?X4p(dwE~X{G&Iu8B-hR%a zYc~WI(g2Va{UOF(wqI(fdZ2~#7iXKLPsjg=NlHZWyX_uCfE?(+Nu)min&=M6B>4S= z$pv`J%W~{()Zx7zpT9ehS6!bYFABuA{A3U;6ze#_b*n<JOXIUQhQSt)mLjGf2 z6|Zjl-elHz$j8|GjCP*ufpcxAoA}N!o&Xe~b)V=lz^x=fTQL8!DXvdc;BD`0%1rq5 z(o8&jT*4uPXpvq7Y-_D4kUEqkvyy@gWAu z{H|O<>5XJ7mbFvGK6Ka3MqRohRJhoE{QwXF{v#JoNy#L(tgzmp2O*wvGqs<^ZpvMo zQ$Q?1>*wMq>O!BY8e{qWkaSOoz9S$=A zb07`ni%~1nJb;utlAWDh{Nh~}VS||s2BES@LePU3?k8AP6u=Xe;n(_#uvl!>(5cM? zQu=zqjGugkpw?1olYZ7f*YxEhwq_^~dl!g>d6G||kau&7L@f>QPcxv*-MrT`x4O(9 z&AYoivX2WIEacHQ#!oM5RJh)0Ci@j`&TKX0TYZ1&X-cB1ZT;X>TRTnrHHwFY9L9FT zFhoT48Lyuv3bu0_-DH#@9uF;Utm0R4h)DA);N&k+Y@(Kauy~|a{^zHzEc3L{u-`Bz zX#OH?A@NOwI60|&aaJa17{{enMWBMuY~$Lipa|NK19g;{F8T}ydklezLAzn;+(bJo zz+JHjYc;fTB=;0axC{LewN*?gw>~_O3KwW;Y2lz1<*5N_1R=`fBGsrj!;x*P#O8~d zGXs@b%ZnfE!Z&7`7CQ>%ozqvui=3-ZNnZdxw}5`OT85rDPi}+k_IFCS*jbH7j?}g5 z%^T&+IQaqeW2p|k!f0Y*;x$a}E!br65!qE%|6}O`rd0@+5@25!@|4*kFZK1 zknEFioR{bQ1WW7}TWxLhIL-H}mz}L78|#tE8NgrL;JrcBRDh%zS`P2w>AYYvHX-a> zXkmHAXgTVgLb6cBp-O%oF9{!e?OUW+GEg{8_$L(j9 zyD84v+S+7@?~WsOaE$}AVIaYTEQO_uv!EaYVs)!q*a%>duou7Q54g3et0ftYYLHUy zD;|wRZL5L?frPYdiPHje)IQ(C%4?dM1nmL%I~M4N!1=NvTH~mK^Y1b4=f}hk!!Z#M zm$~VlN=+)aEPs&K7mlE1Ek4wY_DVA!Wz|aRGA!=Q;eMVt^DoWCy394a7J)-_#)%h@ z3aAfAws`!yA-P9ec4V)wA+I2qd(|%J9Hz(1svwwWNsrSJBhg zo(Vw*XHc3rHC;y?8`Q8 z1q~u8#BHqGW?psZq|H@qKcM{>SedAXI76;_vN!l{jVn44UcDE(k68)M8cp(a=yqL7 zQG@#Hvkdh@!SY42xzL4z+G&`#+Cu@viVe#E>w8dzcR}t9gNEbk{bYr@t<_#Wr*GMp zV#!d++1cvLYE=GlRh%K`XDwCq+)VhJ-r>!53!iDv5BPP2=uA6sBQhGP@=ambW3)Sz zLTDJdw7a^0jVzO`DmjU5{!a;h#r}1nK!#ve7;BO; zC!tw&-ox&9cXZ4b!^lLh=Yit(?=pf%TK6s;8vR?AWvt+Ddn&H zhy|sYQTMrHqC769rHw`NLQqh$srjUI@9<+ul|QGk!xo;0?k1Zt%uq0c(_fv_&XiJ8 zdVnZw{y%11S|HSrl=kd^3WV2c9`R@*1qru{SM=Ss)*-Srcf~O*rGoOe|5DCme!D*_KpF^cKk7wg zitNV>N1)r1m5nJD;1RDyEkzU=ebV^cROnHo?av--vi_8Gyi;DQV%cRKC8>j{{Z+=T zJiS9!Y{$U`!MQh|Nv)4|uk`m06TZ^sY(xb7pB*l6Qrl)j5Be{V2whC;J%A19dp^EDyN%|Ci}nQi#Veu=4U)fK0^6y$Oi|xTvncm9wmP{$BBMlGSLUN zFj{`8nRuOKMhS8%!4YYk{jKZ14}S{CP4aI=oP;a;GVDDV!p4o+9&z zdV#X3&z0u4K^mHFrmwTDgvO7k)n2e@-5?27 zyhz?`bL78Xb@Ebk;MTiN@-fQ$*0wejkoLE!4cIAH07guyL|{-_YrMSjQlRtb$W$R; zAtx@7Euawy!4>du00xqIR=7ze)~T*9-BYe-ntV<4&r3`5gppzb{=A++*twcXNJ_A! zf$Lrh_-&j_{5^8J?itvbOIqlMgXmoGq7*7l#dzyC_VRUUpHiqt-f-Hs{~tBW6DuDA-LI{lY3Du6 zTJOEidjRe)quS-K(Z73~vwIF4)r9WO(v80Jf6Y#(<+3+=a1 z9n>Gu!RPVnYiKv|Av>NUc zm$q60veQGOQ-XSOGXH$8;70f1v(hR61X7qiq$@Ci>YYu!QAI)84Su_W{{EOxgfpmJ z)&D|h*vj&OjEbDzvQJ;+etf?_YmBg+U44-@3s|Qs>jM;#*6IAx4&rETN~H{Y7iG3& z(wRszlEju%qh#S5ghp&%gk2m*x_3H^w36HMQn5o;e=v}oUbVulILHVUO|${ z#Y-u(vm*5(*-Vf1rBrfqTKWJOwr6PbU3eK~qlLYd4@}7lTvCpImw5D*N2}hRGr=iw z;Ep2u7>&MayBSTf!V+St_HXzR#l4Io4<6djgty!AhOomXO`J zA!SxjV*oF|r13THgVSUKSm|zy;~Xze6Zh=uRvl44KH&Y|%tJi|;}6PKqgHyKDCXtq zdtl{8#AZ<2e$=0MRfU_=07HhKe0zs}dS2 z)KZ4mAH&7>4tZe^8*4^s9mlZgLQT0ErQ~YroY!J9kW-uASiWeXm8x3G6v}z$;8hN| z#qt$!oZ}r;Z4d0abAx|zR!Z~6pf?dzi-f{(KSXly4wc;=kE~9 zqVjIs2h*`zFEHXa3IiH8m`Ta{N7`6v`1gv#{`X5jkMhmQ9^=FZK24}$a~JJ+8t=F? zGj4@H-_yAuHV+nCLIeT%SX|jjZ@`@KEI6RhyUQxggXw?~w7g*b+ zBtO{Qw{aqs|yoQm> zv)N$)UXlUBea|G8^wozM9}gKR?l`;|nqsVB9l7$$9XP(xgvGA<8Y9}nOxN$GcO%cQ zT_J(G+wu5n{=X-d#N@<(RV~#I2(`ods=Xt0^DJ~ZLd=U@-b5_L+-O*r=_G>uFFdha z`0N=}5^?w$|J~Lw1D%BHxuLazbKwJaTOZI>s;9w=y2G@ocQVy_alhi_Y$|Z8q{I=u zp%s?8&$%H)vAykM0MOb@GXS-|;Fe zQzvr`HfdO%`}ECrfrOvnTbVg}e8uE)|C$?9`;?-$~i*6<~b#nr(_h(6Uf^b@hVjK$Cy}1?_}WQehwOxj3Oa zf=@A6jb(rK>X%pa0}_>SAwPr)dNoG|EE}k4LlUL)q#&TzBb1?$`TuFXX-HVu#IQx6hRU{0spNZJFWNvp zl`t|8DD<a+F65#fr#+oiDahK}~msVkEUT9Q|()-0_%V(Mxh#0w0yV?T-3gh`J`2eDLF+H!~VnXDTc#5uRep zYheJd=LM{?`?x}5(8tu}*2V`TdO~Uo_f&5zvUXc9jVqpmd2Y`dJyGqgQ=X0|5!p2VS2du7z%o%C$22!_Mdzy?GhX^o7cHe?`~kQkM<3HYE`I`v~*5a8E7m?njeB!|bz~bhEEJJ( z!j@Q5;AQ0Q|nZsfuZASr&?u@Q+W( zHbd2Lk- z6aFi6;oI}fa6f={Q7Ut z&Mi=S*x*^+BH(;$!Ef;jxZ8Yl5Hl?mMbdp=7-%{*`9>t=GmYP0{8?mgieD=6VM5{Z zr$I+)^=xy0W#S9<(?A7RyO1TxIzkXfVwGp+ZUoGTW9{5cfE&wYbEbvTqmgUZa6S<# z@|AlajQS4%_P7KWd`U+^zFkX&en|16l^H$bF`7ArJ{2abw-b~NFwSpB0GF!rb4hgn zw%Za6t@AS!wua(=u%j|&Lx^zN3ct#~?^U_gAIbwLKzGfbe*(Ae+z|!WBmn(7Dp=9u z)9ygLyT6d#0IXreRM)u&D79Zfc0)dtx@ua&=?@}301P10Ec}7Rzp4q|0{S?ylM4%( z`S)`_eeuKzk0fT~gisAMd!nPQiw-CM=QyQ4!P>#w6wHdYFQ9zjB^|_AMw9$p^IjXsY;t25R#TD zoEPNiyN0Z`3TZPe8=rV&rmZmi^cKHZb@wnYY|9(K0|)PJgzXUMQr7@@A`w2I?|v|$ zAUL!pbi_|W9AXPTnv zkPh+SF?^d5R%d+X9)W5`n8RyQhMX~f)I|BQ_T4jGE-L7`rrvTdYVHb*FVMJO&l z#Qk*xc4Vj!bJP_`!UasXG0=|nkjgP2dO%NDu<8L#4M;jIK-4+j!!vA592E0F$4cXL znS!3Z?|VscQ)ieN2K8hkVOvaZAUZm>TU7U2c))cVjyFCk*+axKfrj+xXhuL1)E^?) zx;CWO)>Zi$=#e(4Vwz3#}Euul?d6@db zaI#PIbG;oX^bnK!W}V{X zBVTshIy>w=9&op{d=?1kqXF$5l$+f}4Aq-~?LjPk@*5zV>Jx1Ff9^$Iq_&{#zT{2Z zarokBIF+1FB3zV)S^_j{YVTdx)^B0Mk>0FV3LzWX{Gw)^`X}G)Q-Ur6OZT(WaaKBu zDa;2V3@VyygIS#NS_np?C13--| zk*qOI7mre&#@5!d0BBj+k4b$)@B2L_yvuhV+u9^L%ZH)vHF)&^gukoQ@jH8)#q$q9 z-9Xs&7xcQXxb47Ea73jydfI)$%=ONDE+p97rh8pQ$Yy;rDapyvtna7kx^8c*T%Z3ieXY$xhe?>v@QVNI_MgVB;6W<_2gUz~&dsbkq1-5aV zT4thc`anQXds3_8~?m>A3Az;c>1UM6o^Bbtv&5tB6^6y51hzbR^ zH904_m-K7)Pl>@&Tpwf1{XNNck_(F}_fZFQD$0b$cVXFwo{a24kYslJ&H@I2IR(`q z)Xl&`D8>!RL-UkabX&!@U)7ul-rZN_J|EbYhg-R5)2Ber8@YkS%HZ8xJ7gWnLhtt3 zx|Ar|Dm`^jQ0{$N)z2ehW(9Zf`uZ#cGn86ZlpBiHi)3E3mxmo&np(-^R25 z4(%bRs}GO_9?80q>S$>K0WCNX8+)TSF`rPLtQI%EZT%1DK?E4&K$vy}z3;N) zjrb;%HQE7oE>kMk_0_daf=g@Dsk17(nj>|M?xmq)rms(5+Q}^J162hPQ^kGa5)yUu z9<5DCCV+NuFz)HjauNgv^+(SAx?AauyF;;CO2^>=?P>qlKlu9Ye?O%GBE!KKaduB# z0>eeG;0h3d>NA8z5AS~5Yw2I}wbw3C;oD7s78n0}2Ao*qUV z;IpueJ+ckM`>kU@YSM}u$^zSZ`n6wJ9!Z*`u(DDiX{YCpi%LphzTb-txlUrT2@Fi> zfS#l%q?ons%MBi`TbK?!nERIfPG(P zF?i~}-4lKHm+agCbyNME-X7awS5v7Af&sOu6{9lw?*LG;>VW2Bh`7zO_t>6oVgOJ_ z^o8;JQ5W_~|DP=bq|he!|I1JT;%CR41OgrHGRNp=QF<%4V*o7!UPz+nA^wjw)OY|; u1&8F$g8x%Q|4R=zf877y@yfrp8E{U*`P)miZU=y$J2$m&6kdP$ The observer pattern is a software design pattern in which an object, called the subject, maintains a list of its dependents, called observers, and notifies them automatically of any state changes, usually by calling one of their methods. +Sequence diagram + +![Observer sequence diagram](./etc/observer-sequence-diagram.png) + ## Programmatic Example of Observer Pattern in Java In a land far away live the races of hobbits and orcs. Both of them are mostly outdoors, so they closely follow the weather changes. One could say that they are constantly observing the weather. diff --git a/observer/etc/observer-sequence-diagram.png b/observer/etc/observer-sequence-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..94c7c3ee179ce91058a45bcb8ddda30b6f7fdf2e GIT binary patch literal 45973 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 literal 0 HcmV?d00001