From 1cb62f543b7b8d8c9205fc2b88980dac4b3ff311 Mon Sep 17 00:00:00 2001 From: MSaifAsif Date: Sat, 6 Dec 2014 02:39:54 +0500 Subject: [PATCH 1/4] Implementatation of the Service locator pattern --- pom.xml | 1 + service-locator/etc/model.ucls | 74 ++++++++++++++++++ service-locator/etc/service-locator.png | Bin 0 -> 38210 bytes service-locator/pom.xml | 9 +++ .../src/main/java/com/iluwater/App.java | 20 +++++ .../main/java/com/iluwater/InitContext.java | 29 +++++++ .../src/main/java/com/iluwater/Service.java | 29 +++++++ .../main/java/com/iluwater/ServiceCache.java | 46 +++++++++++ .../main/java/com/iluwater/ServiceImpl.java | 37 +++++++++ .../java/com/iluwater/ServiceLocator.java | 37 +++++++++ 10 files changed, 282 insertions(+) create mode 100644 service-locator/etc/model.ucls create mode 100644 service-locator/etc/service-locator.png create mode 100644 service-locator/pom.xml create mode 100644 service-locator/src/main/java/com/iluwater/App.java create mode 100644 service-locator/src/main/java/com/iluwater/InitContext.java create mode 100644 service-locator/src/main/java/com/iluwater/Service.java create mode 100644 service-locator/src/main/java/com/iluwater/ServiceCache.java create mode 100644 service-locator/src/main/java/com/iluwater/ServiceImpl.java create mode 100644 service-locator/src/main/java/com/iluwater/ServiceLocator.java diff --git a/pom.xml b/pom.xml index 1e6b6e98c..1a0a0c9b7 100644 --- a/pom.xml +++ b/pom.xml @@ -37,6 +37,7 @@ visitor double-checked-locking servant + service-locator diff --git a/service-locator/etc/model.ucls b/service-locator/etc/model.ucls new file mode 100644 index 000000000..bf17e5eba --- /dev/null +++ b/service-locator/etc/model.ucls @@ -0,0 +1,74 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/service-locator/etc/service-locator.png b/service-locator/etc/service-locator.png new file mode 100644 index 0000000000000000000000000000000000000000..72016b972c12b3b0ba64bd363b6b258b003df94e GIT binary patch literal 38210 zcmb@uWmJ~owl$1&Nr<$hq?Ckohjf>KbeD8@2}nvvhje#$ONW3U-QC^17rM{hXYcdI z7~l99{7}c^{am@$TyxHK2g}KbK1akugn)o}E-ogl009BH4gvA30Ui?k3$aNl76e2r zg1E4Nl5_H23c|;*-;Y1gG4}IAUt-FO8^+O+6q5#!iOcuQ7zNW(iy&9fL`_fyNRgW= zMPY@K_?JHvtBw19nYj0IFiKryzT~|uP`cdkTr54@Z5clG7`7XB8E)Q89kCleP0qzc z5%FnN9)^RiP zkOg?8uugkVF!5m3%jT1Vc_KNbD~lp%bF&k74`Xu^``yVxn)sxo{ao42_Ouj&g3NKh z!_C>O|Muj?a|s8BgTq#<27Bt{+RCx>{=oz+3JSlFFA5|dwNg!Wb(ao!V<&N3*GKqJ z1(%m!wrsD(eb*8|^MS#q^nKeY+N_|SNcd`RtkPK3+`Kaob=8Gk?QxO@9lh|~JLRtK z*~{Ij5R=4uyJCHPD6v6*f9aAEmC&&*wUD4Hm(vZFb(dpO4s!B%=~C+)Ipx^>Jqv0& zx`pD|5dncyTpl?Ks-}hpret^n;V3=(4Dhx7&;Kll_8DRj6dT*DOp1Yk@mw?hkIue) zRUK^jAR1K^0UZ0_;69yce8QHWKW%Y>ISl*bJ#N1-zt5z7tzTPEK&tIoL0SE6on0pQBt5&t%kHg~r5uP*Zbtamfh{6_%HOqtDXMZ?Lsf zaQcfTl=>B4%QJr&y_M3~ST&tc!u}=UCHtkUl@&-AF8NYoc)_-(ojfwn6`+on}LVm94xiyMs&Fl7Ux~5o6S=mvz%Z!dr z8SPckjE1u7r3$&I&xi8rcNMj4!J%h{lMAjLIAPP9BfkkagNzIVI0c)G{vCBkXY`-IxdP(q%V ztgNmjyKY2L+ePGTRUE~ml8tYDA8d*o!(IIT}-|1ZsTbc zdY4<)YI^g8335C&-)t>vC8cD2H;RPu*S-I`qEaEFG$vu@|GMhwTIhmL4}(Pd6Fttq zpyBOcLZg2uvmu3N&QtXtl`AC=a*pO=%<_?}8`__03o*CV&qVRr!haNR= z@&EM%>0;HpXh(0UgxjP>r#o9cG{Pl5!n@F88k)+72d;0I%suDTBWacGEzDmlD$cl^ zR(L%)M=qn>TmKam#58LYH1n>Ly&v`ZFY_?_Ov)Z}|rderbK1kIaVA+@1>4#2x_OO~C{Jo%H@6){J z!Ki@!09GvsKKQJI=HodIw-9d> z^S^wlsVv8ZnSs|!OxQl{4SUC>L7Xg_L(ts}1Q}!9RcQy2W zylOF*@?~xbFHQEcmUpTyA1)}@LBm-x=4EfwGl-moXthytA0+~74tqSdqs{NjFPfU% z1k>^UJ(OB?>Gs#iEn)_S`*lf_F`BjnW-bs$v|FS;P00w0WHSplf*5+0&xk2eI@g3N zWB{EoR9?&WEdTh<9`Kp%@ty~@yH9OeRVwx?s)tC9}!m5bvDnSKO>J_oFu~L6cs@vp@nT>nwr||d;p;^ z1NK*mgAf0Qc+@1V;1DF}$F;u9-%RV@L}Z3};Z02QZMlB@{CSo~r7cJH<%=zvqPVz^ zD7`S1cOEH&oWG)pyS_( z4-R$NSsC{4r`?lyWRN1RzV>3%`_p}RYYKwz#PYy54*uWV+&Qo?LxKDwshR>^a*mG= zj2WuEk+9|94lb!xbZKd56br%0?*#P4Xo0MeO$Iq%XL!6bNqrO&9Q-Zz{&0RE{ma~Z zF0V@zgqz!$+zWJ5eKSsI7Ob_O;4Bl?mp!<(?jN>#(G`abK>ypI#nVs~v{`LWv^Fu1 zJ)N}q(rsyJJ?c3ub2amj_Oeq^Io%xDVuTeGkd@$%rIL)03BA0gB;z_rbj;0#??l6k zZcj)2CMWBKOV4&DWBZR!H!Wab5&+C-w=y=Cx~6Ux?2){=oFeudMHC9WsQ0{Q`=rJ{ zJz7Szr(V92W|JNhqcd$Wo^w8)8+>~~7x>l$`v@D;gARF&X3lo`yQ=d`2#{{zF{jzl z{SzoOy}B7}k`CTrL>DWjkZu%9Aj5Mv2+65(BbO3b9^iSP{hRA%i535 zTbO^BRPYb-$q_$C{7UOuC~a{uSTVn;hra`vh6anOS%l_xv{YArEk_E!R0$IEMCA}R z1EII{k)J&dvk^qSQ>=WccgwTfjEqrDFS{~zlxKDRO*ZK`zkA$KP^5`9tnAKBibJ>$P?CEkJB_Ec>_G`5BDbsEAC>d z?01c>MP6sJ&V*f067mvsI5+dszyH$dvPRN{$JmZt2;`Q#+$;xFmfl;Yzty521V%7Z9U7Ef92KJSFY;=amfHo zhlRrWeyp=ymoqf{l_8=?ON&e)OPG>S4@XKy@nB|U1?hHsw%y`%$Ta=Vy>8+9ltc+p zTs#R1(v!qBpy?<C0Ra|gDJj@i_XG=ba~99LBaoE^ z6PNs%sAyR0g9Y z=XPH&Qu~HhXGcj-*5!7(A%cV@5FLHtYz-z!!HOB`*FE;RV;cvi|Nl>-e}62S=D+ z+hpNa49f7eVpVWv$XwU^V}(#qj0WPk2)Sw&ChW!JMnUFa&?4jFOw>?EN#dPX($q{S zQ6aLW{(i3h*V5f?Dg2IRaJt+3@V(o0$?%pIR!~N8 z!l&=g@&qT!D=PZ)gZ=5nR@py`PD-LHboB38T&!;3#6CmpC1_E73G&MIvp?kne2dmI zk(C`YLw)9cFas?uoIHQEN?L*Nt?hh21>MPEIL4h=)l!-KJbR;Y8mq;eot*;N__rNn zW64sKMsilV&&%-`h6aRw=*!8^1mRz>Bm|t~sk-pt64f^uM?%TJ{f`W?c z5{{N1{~F14>NW8wTt!9H_I4xjN6nN*%cQ`>M7>T|IkAGWBZFp?1dj0zu>GLS^#|o0 z9W64**uUvb4O~7&1Lt+Z6Tbc*{nF_(u0)@3_4D z*;?LTHh~ykN;(j2q~6Z$IkNpr%=L|-N*`JrMH)J3Y;;qhjxMbxF&S|Lishi7NsuL1 zR`zetcVQa*8P$%Q4i^lUJNk(0!Mfeu9)5Tc#?0^*O-N}aJ*>h0t5vEv)f4IRw>EU% zianMOG47$`aJlCfJ79%xqu8(WS}D?C%eB-%$B1s9t##vdwfAM$Zk72O^D^Yi2^}r> z_8QCZfH@xf=}8B_?$yn(jKs{Vf3OnVe_08|QvqTwP}q=k%+}_kQL<0_F;<6$&KDF6 z>T@_9_V_5&+pdo`I(d1&@U38^KmzEUhjtkObCku0+Ck>6zm-OT20PvLqk{-LLleXesX}56$`3uX>l|) z<(zJI69t4#kk&I?0TgO_-q+;hDk|T!v{I>Gzm`{uk=Tx%p7!STXoxnEO{36i#_Nlp z0sM)*!z3;M&WMN^YSov^zVu^b+wJkRTbKyJC|yuHfqRC7yVs{=930fHSRk(6UY0I3 z?mYoaKEgkd@{_BGL2-gtgBSn%HanA`k1W{%U*7DVW|UTDmHrL9&yHRV*yS_V%SoUwdr3 z8cvmvcYfZEVwX)N>-qu5m~(M$=NO2RaVDPdPeSB1sR}51eA9I&7hVZ5txJ9LY^4M2 z!Kv#Fi@dsevS;FW4sPIQ`pw2YG}dMX1%-}7Qev^_aZ-?FS)k_5zDT;K>-G+&E48MN zd*aL93ba|5Vt_$PNc;qJ#NE9n$q^`Pf*`Kvq5rl!cUYI!!by2Y$i%K;7 zhML;DgNjBncQ-bPO`kt#t^pHjStKL}oK+*K=N*ks4D#~ZQmN^~L-VEi`GOlJpk7XU zs|#J|m<|$inX&AK0q!|sZIgi^IXL&<2P%-TJFe)t)HAf|-LGv+wVHRHB2ZXqY3b+B z?@QI^=H_@kZj>%N88jQ9fBdS9hwoqm@dlom`=It6qJ~NNqJx!dq*nz4v`#cLiv2zy zxh!YD1bwN2I_FQdG@1-I22dCdAtN_8HM%lF+3gWgv()?dZ`|4GP*UBS8=CfZLTg%h zcxGk~Ilj<*^wW#fvCP01RLEB!%R9cBgv2pK-(F6QPAX6RRCtb@jPzn>^@r5(-x&Zh z!qDh|WVxWg0v8uyRKq=vfDYi-2`XCJqA3z)<6#y?M(Q_je63wv>H`7-8XMi_QAL}5 zt7!j>zbVbwQFdB5)%Y_+gb4`SXQCm&KCZ-Ona^Moz4v`|3G=^_f0#xlRaM>eWLA5> zI=FkJ%LfO?{1hQ`JLo3xa#RZn3X)S&va_=r9d@x^z7$SQNJwaCXjrPMsqsABc+0$+1u{OF}{t930%!)1$PuIg&Ot z!CSx3=w#K8px6ED*RO>IUM8j}k#U+v$9+6j3!LE7wZ7=9E9agGUayC_??Qn^MYR1y z*w|CqlGs#I!ovRFzG1=Rsq7Cik|_=wY+ueQxCStmad>hDl=4;=@^3(DFdj(_?PJ=( z{NzFczbF7Q&EOMTYJPMokdDgF2`ZVSq$G^{a`P#A8ylNQVpmsJ4i1i@nOoH@SD3QO z%F6O`lD~1J{cjwpthHKX%6Wfuad9w~3HK+E=)sI(F=)5!Ew;9nl$3n?rlO;h?(g6A zBZ7z{+Hit~`$Q1!!55UOe>9v6p50O69&zgK&1Ojs}!$)1$=M7^PrEK zn)gEnxYwysuf;HYp8nHvoE9~;I1R&y#e+LwT*3X!%nxb*7UG@EWk_ew;|Yxp`-eUn z%2EAQlyJU1?gF2cy|1LIs-hGV9UYDLmOq*{ZxJGsAy~ud^d#|ON*kT~i$LtD8&g3Z zyRj)pQNf#}p^-(q+@b?l!~L1+Vt*+1aSBTlcm>fvTUMMXQtEyk1%)fXfTF;!q7p?r ztNkzJ_tQTM5lQyfZscElXG^Qkm}l#0{Jv<$(Av+BXZq*zYW;XIW}ueK*_OPNRA^Gt zY`TCSBqZe3iJ~x?e*lN>j-$je zk~%MB=&`N9-nVsgzW9n@XnxLu%Q42cvc-|^izskENPYla)RdLG54FjC;TisfPeNBi_lcDR8%Y^0KD4OD=a6N6 zSj!Lh`X?tp0o79bsT%-^{DK>Ys-^SYmq2~Wqgw3fh?bFA1z5zVvhE7m;A}<2R$6+Y z!NG2(29uEyx5=Y%GgFjOOd%B9>VV*&s^jyNl$a_GZuji$^|vov`ePUY<&?W2Osqx) zE9`vBin#&}=k_)S7FNb=&;Mzzc6OJFYKpi%)~0}=nyIFb+yk}eY7ee;A+%nm=p|eN zqz|3O95G(4RMO_$@3Sv?c_x7<1n_DwzWhIpAfI}%F({%VxZ295UDJ>v~tnDfTu14>z=68noskSP+yJr<8 z1SKRuY-w)dR($_HBabR}rxK`zH)q>289W||&gW)i`eq|(lzn~TV*?{<$OXw~Mcb}0 z6*)bTRn?Pq%8-n3aFzGBs%6Tw+QTV|rE{%b+V9^RwRt~Vqw@w))xZY>THp%lDL#Hq z(n41=-$*+kibOw(NO|rpZT%oR?mXk-HbT6-JLUCS^SnTLcy!G1VD4)L;9jW-Abc(l zne$%0!0^Jvv~=2(d9^A(`XsGpl4_`h1qC1TdAj=r1U%Dxe|6h9oMXxxhANj|4HRWulGAmaSQI#O83G zsyB$v7#JAL%*+*6fG}#mIo~}$KLRR7_0FAK?TbqAusC zeq4ciE@T9oeFKwnG3z{o3i;VBrA<6SQ7PsPIr+EL7No4UJo$TZRZXo_gkgZqzdmS) z=E4O*z=wRPal2-!&mwz%adX=!2yr*sDj{YM&UWlERSoYgVE6#A(QN3Ai_IRt-2)Jo z(;ltafd;lC1WOuRkD+2@P`;LG=a!kN^6S#VDi1g8f?1`n^#&m6qV@Jp--F8XA(bmr zOLwv)fz|2Y37&$>?Qh!x;OpbV{kL!5qN1Yoe}vBio@rs#mv{*3X>y46GP$y8sT_7d z1V- zTRAvxgT@D?S}ircf>638QC&SrjNA_qPCjzUMA-ey*zYf>)r&^gdBU_sKm=bCG=S5` z{Rd3d{nSmo&h0*38txjPL9V21IM6HRJ?vfP>x=9{9}M`bLp%j5cF-RP#AG)N94D|AO&J3DOJ4?qdwGw6-9oULhgKK8wG z;TzdYEeqxzL4G#ej7rp#o4rrA3_`3N)C7H94y6a>yx696Q4@Fcsk}x{=8j1^YHw#J zw*nOA%976e%ePp5TEkX&wGu($7sdl2t((IdrDbN?Hcd9G??1Js?daNb&TZ>BnLZ*R0mI=b@3LK6o8HuiK~Jxhj1uGV+w(~Y5aKe*!JVsdiw z=g*%5bnN>0;Bj(d04;zA3noS73>N-ke>M;qmz05_Rj1t-tU_WU-a;VDi0hpRq~ZBb z8h~O5SS{iU3U<1JG3vuI0fI>8cKO-eEuy4UrI;&2qf%67z1+d(XGW zhxJn1bh$pbj06M(AgE|wnty!axB%H?wa_H5q}1fNKLbD?4-ZdDN=kiqll%3_(Q+q% zz8gbHo2#pt#l_D%U|vcoD7?r^;4}&(2G@8E4!Xgou8zHKCpIRgs=S=T^~?l{6ZRjE z1z)P)6H2lih)U#3yn$smmLYOvp3LX<@cB7@-c@^hd*=Hv-$lwhiO$YW?N(3C#YIYA zc>FxoNTNUhMZr9V;u(d&rcX~_Ew%fBfj^gd{ujSWn3!yxZI6pz0UT?sV`xYoaRp-O z@xgp!US1xxVvhG5E~~|KPZ<8=!|fsLoeH`z4xkmPoB=2tPUGXVTHtnZxdwpsV7h#D zvQTv~jTSg)sv34<&v&Or5|{&TU^;x7h+y<4XkMlP`P$=#rAuBx0pN_OpMV;p)C515 zX*9lfN8nVbzrDV`9{5JL3(5@e;q=F=*2mk{_fj9x&LqUe)m>bSPB%5w63&79#+?>c z<5}X+PKhemU}Ixr(T=CkI9t0(kXEbp{d7v(t5~fv$7-=9y)`8{StgnN_;~dP=Ql(F zPaP2E=_24z39oK%%}q`7^YV&5l&^pZN`IA%-ia+LiuAm9J+{vIcc{nA$5)_>J2vH3 z-01R$%7f>{%FI|v&R#DA!go)9NO=cG@qz35M84w9%?+75zQcojJ={?um()_}|dUls`CEXa$0zm5WQ`q#0*y>;Xiruvpd1-B?gx$)s?Cbr5J9 z8?ymtzsu`l?>C#(!YGtK>=x!1P#u9#rND?0(9~c;z=aPs5>hzE1$)E%f zOnjNA%j-E#7q_yqat|~BTxQsZBCvoDSE~^lYEFfivdtANhWKg`M3ABAq<~W~D*!Y> z;HQ(H+14xEp6)_vyz|ORoNlf&^7E9rm0*GLOd3x&g~a^9Dpggb7?hDP+eMU=G*ng9 zRacX!HSqHBnQcfR0UHP&-n`KWArU@4f4GF$^xBRY%!;3@_{o2AjZl?kZ;21jmaQ23 z2bde}zfu-%3%R4cvfEUzB$o^i$mCa5QwwuGCQaC)d&AI!X!Wugva7pWTuh9LnmUY- z=LXEG>-uzrkCKvd9LoQ2jOHb%*wQ1xs)MWF;B{L}(M|u4b%YSGrr7W&54#lf9(mh%k`P;e+Q zv9S);))2=^Dk?p3QN&`W-mcl#$mbH8-Y83;NFC3Wjf;w6diRdUehaPjA)vk*{(pee z?Cfm=n4735maQlUdslvTpi2R2gA9`WY1U+p$1Bg+*fao!XSGxZ*i?pecNdt8bS@7F zCMT41ClO&r->*diEpgNfV2!vqQkJx8Gas*jq4(0#L-lr>p4aPf;L4)lvsz4*Xu4|)glL4I z{Rg1^x%$^ChU7XloWk{&_kcg^RJlx;jUSF?oZk{&Eg&{a92%4NxPz$@l z&<`*5OY!dzd_S1DP|u@4qBk7qbpDZ}qgFN@5p+FX?pZS&%$j1r*&rdAe>Re;_b7auhz859sc zZy~?)|D=SSuP-kC+T1K|ki`%}@zQZ$oyj7e9-|KLvdM>Un(vGtn9sry4=X)8MdM12Qw93*8^? z5*F8Qv^=k55W~h3f zQHvwoArv{_yR_P&^8Ou+{t*pCceP z18XUB4y>-4S|5lES6av_#oP_nB*>6Ql>7&shLRT`>e?J%z`%?FZpzcM#2_d5&q5V{ z6&#o;)Aegtc}GAVQO^9&#B+74gX1c-*b z{SPXcu45ps@BY?&Yo`G4?Xa-J0iPaLf0XVP@6XkLkdZ-jodb3+g?Y+Mj2kOU%jz0S z5n+*8Adpg^Vpf{{piB?^{P00mmWR@qsPLi(y+IBFI23BiaYZ`Ly2X6`c$PjmI2Z!X zIg%hW-v<}(VqkEt^HL9ha-m8XA4pvo7~GTI7aA2h_-yoO7#JW4V+6$lvuVY8_lMe! z-(uR$u9#R@te$ty2nYzTUuOcqz;Kb^8p*D-L)*BoA>g^lceT@{UXLEK1^1Is6=AYvYG5yI;4-al9%^^Yg=93_&N@ zA5lRj%s-|=sBJK0(KX2eRAlSp0~d=>ozdvzq-L}0d79UQnxbOop{+;Kw+vOh`-bKm zijgTN)-%J=MIQlGF$ydYX8M}%_{t`gOPid(BA@@vkEY!UZFE|7X6I<7?AhetAQCkQ zeb1Jm%KxFtbli1cJr1xak%x6Q+E&#x^t@0m0xnw3oZYwE5^^uBVH`JQ=7y3OlYdX{ zK9i(6`eXDBlpqe_v9>!YaUxj;aC2;I>~GOmQ&U4JlYDiyjnRsvtg7Chrk{y_#}WSO z_hnx+^aB8mM^w-&OorTc1r6vLvB8~KZTXHbeN zhS)`!IylI)W{PCSyOkuX>ML-yK48$Zw{z}I-iIwi^oE3>ReTwFCJrLIH4^3ER=eLq}adtqF$ZXhT>Vn%PvH)t(OeJ^-3`}?;7u;Mk0rKewq zrXHrTnG920hh3+ytX6EG7*=_1EJsTP7yWnBu9qC(fe)Uy@rJt%~(~+ zf@?Ottm+Hk1lF7+in8Eu^w%z+cX!@z)RG!_Poi{WzNM7!47kl4J zMHg1kjG9TSE;`wMTAcuB9TWs_Zf=f74}jwwSapzOt~K+#mL#LsZn>e(yn%Rn*q(ld zsE-KzT=twI(t0t^qHIlK(Y!0;00Pp?OqFq+BViIkKLuBFW}QosTW< zzXt{iCFAIUYik}HM*vH%H8b8rfTCswbxv$o5(q7}wkOFPcAS7}02dCpc{*F)cv;yk z{~db}vZkg(PX+ik#sEN#dXM@X6jd-Gg^mfS`E5Q=tQ7yX>atO&`dVCeWE&cj$xP`H zXn3Ckt|LX+aMLyoY`DXF>F^A>&k*DDOt|Do99$ZrwlKkIx$-7YrbwpMIK}~?^ODGq z%juv9R3f0x&&F5mobqcO!lxpEBb*2?5LoFLrKJl6o_}gk+?O(pKk5?VUfpbG+DaB z=9l)f0FzI=FI_$IV3$cf`vx`NG}r2N@nD81fRt?+G6m0 zBqLtt*LB({vbs9<+c(y?Z-HA=pBcHd=7qN;e9Iv7-a<1lmD+he zOa*ZBOPQDzL|&Tx*=j%&0XORR*HF3n+h}r>$$##ZnK^m#?(ylodbL#Z$=$Wxm3~E8 znK#WFF0Mv@e`o>E6?B2f4d{pG3W|!LsxK`nngb?0a>;K7hKBFPVne;16r|ZkAU5`S zGDT6zsi_(NXrOa!LV(tLxkUO(7#W_x&=7_S$KLN|C);+}z=EH;=vmL0>w3=Nf zcOyaRmamxW`yRM!s)4ALpT7-ezw_iCiDO}5*-?{%2F0;z$;adK^ZlvPwB+PDfMQlx zSNYtpMuWC%gJcTCH*tGk(4I?t&scdi%iNbtD8M>Fb60w41Y6<*O3d9C81$h($H&1r zydRh4>+A3T^t&P(l=w|ea~&NW^YhII98XOj-`D%1DS;@(#LD^^Db;4RC*bqvU&oJu zY}4Wh-@j`udo@p`6coGx6}PGB_NVy5d&RF@1QHpoF&;&<8mC&9jO3 z|8MOyHnFbG8NfMk@+Vro9=*N2SuJNqRb^fNO-U7WuZzt1RAVTKbvNJWq+MrC5|sK3 z3ij^)a&b-~oVYgv_1Go&HMb~)$0lZ zDih%Ok?2*PLh{YIIlQolNIQ855Om_=u!RQ(1~Aak!757wvJ(}xwyKIOP&R?daIwW> z!X2#_#l^)1i2Q=dOG``1$;oM+HwXq_5)%_sQwdF82Yvhc6}aI0Kcs@a^L=uY^n*X} zBP7Jfzx`t;!G1{9nF_^arjSX7AH$IZ!$w8@=#-tC+t}FHNrZGa>Fn&>mWIr}8w>vg z*@uc%={I?2@nd$^W0sb$8aD?QNstL!rXam`n-5;`dA?G221KwS-4ehuV^dQM#V~6j zz&co{QtBN_9QYC&TT)y+7W~A;4fOWD#Ke?$C1+)=0d!T-%(Gcc8WnF0y*F>(7#SJ; zRD}APRaiLifiOr#P7cBch=YH$*E0jPYFVx)%yjkz+=JsbB8=YyA8ero{J#MGxfE2d zqv-+_6%`=%26~}hRTd2RJjsxW%B8PnJa7&AcLH+#ri{@2-a5C9;Isl;)nTi?%c8Q9 z_U#=9zEt{73L8B={l1wGzk@?{L_~zIuP;EWfRN{}C{nLR%n~=o13?q2S+G^RtH1vZ z1qEzXct8M5h+}JUZSCbK;G9s27RvR1aM*2lOR3e{k{bg@${c`wnWcsZx+hJf(13e= zo-ZIJCaR%GdAX#|61$Sf_5B4E*X{M*E%K(&$O>sT% zL2KAAchF!Fyt_7CY(7GO(v0U-=Z)jv4&}+(2S{s1p-xYbzaj(BZZ7s+9^6-HRmK|} zXn+gHr@(1}+w<EK{fB@?g9Zoo24su4xHwq}i5u`yz&ot0uHq{CH4|{!duLL4ef;<_ zj$SkUEjl_naP1qs;3OgOF=znwjBe-WukmDRH}^F$TDpUU;SRpwj`V{CTUzNK8h3K(8rb|CPdoSy@~K!)zI2Z+S|bVIu4uk!@73_@H9u>(Y~(jBr)lnGV<35ynRTYO6=!F!fx zGW~p}aJ@10t@Um{7${+vL1#<*2+kuM;RE&ubBg8)HY%s{ju;2YpKTqrkK(p{;%>s+ zIuBa;y6xEFYe2kGul;mBE^EomD6*L&1v@)Vct9%@ zGxPshboWOh2GlGaU2$6*KLSE9=ti-n7|2s~UJC%-b8sbI;I@87A$UVa$K$Z0RCi`J zCxiI^=tBz8L3u39rv~+YtNZUN2HDSA)AJr?%9vil%FNrb-NOi{IRtiT=(3?}Q8%}m z74FiAla95Z#xRx@2;sG$F_NaMq z8LV3$>#W;{hKd1C4hXP0aD!{#q4GlkBHo?(ouIrtdM*a39lb8#mR>)34xn|Pm~LHN zUF+Y!f>I{B@0z~vQkDc=4%fMTrfaO?%BR6_hrNo(rT7f(c-5*eN}U&t&5)>4+P2QK z)=?^uZuFC;lA?z_UUaaGon?sSRp{D_$Juuk2%c`^e#0tb|7fB4y!h;#9yO9Uoh&N4 zmVX*3_JxkRyue@vAoSWgFWJoB4jKXd8gt5wjGwp}^DQ3GcN6i5*{YuwLP_*se)>qe zxnTeoIiO=~1~RsHnr-S`PIEw{1sUt}=g(dY~ai-t$xa z$Cg*R#>U9^`cow-OC71n1ZPnOO8K&B2l@H4E?I+){cC%8wTl)r$C#9bTezzzzmo`{ zU)OgLwV>!`sJ@~l-CCvTO68H9t2PfVKi0_*2`5^FP=@jW_U~pO)1w!|jRk4>yvYo& zu3?3i)zX>XYZ+*Xv|$EP0VeA1h3QB&qV3EUOAV;H-uv_LJj`kx4n z?eCg$auA{U?LIcV9DW@Kn(+V=CL%K1{*JpB+L+%m z9CVh(nU_h@d8!@03=J}zOy(=Pl!anH5CX;M5g1`WLq~jwwA5Ov7a=-iSdC75)_h}} zTwtdarK)Ou-m8VK3#}@?r_CXLk z5yg3P6()0trnJo`Kp+Mp10D`eZ(rX~3KttF>e4C%(AENT(Yf+LAiFJLL>Ru}Y_WZ4 z7nz^z;VkU&70~fcyIz6_`6{3Sb=M>RXW~g(E`T+?>h2OI;^BOj1VkLap|Q-{)86d5 zD=Cw$lh>lZd`>}Wd)88Iw;2vVQ3RNAeK`eHqB!tsd|)yh6ma@+bw2ROED#_4fX1CF zgHRUd%Dc7qdtMGgT%3{JcqM^#2#5ROp(K5t_)ja4+;^bamo;$4O~{mLJ-VHtyM7}ru*e^ptTg{VbrDFrSb*Sx9ZJ#!` z@u9z+z-zed%JMonI!VQF)be{LBX-j3vbZk@4r8@evQ&O`&bPrBqP~bEuVsLFCLMoC z10B<{7KE{%+2i>(Zxp!x*-51R0=Hi8R)Al@APdQ$A2>xKTWV_X*y{~Ju$MXB8p{MO zwGPT!3UxI#m%Zt7@n{Nh2?_9*?w+1+adB)LUJ$;-Vv^}#qd`aHYd;Fk&qEBwS2taT zGmC0SdhRtjUId@0^QltMSr?5W#yehnl2x>!Jlc)ZSob~m1m4IBHI;7*HO0NMeAV}$ z-&%vdR4Zj?Oh_EGgn}|@)IhGFM3bwW{R}Z8hC{Y~>~@Gkdl5@Gc(rcvTLT%rgZS0d zi*_Mwnl3_a_D`R9s~q;7@!dP7gy!e$0oOkb%{MU+&j^*uC#z>OMw4#UhHw(eizAXo z+~jfFyVTwsjN_XH*e4f*r`h%n4gz_%u(P3P5t*jYyaB8zXx5hMf5s z$YohArgGcJqNv(EavuWtuXSZgh3 zF95{IF}VhBB%llF+0VLrQM+Bj#Q2+Yl3H(}pv${$JZTxDLs3W*wzSf>SxL%=;DOQ= zrlbwn4l_f!ri7xk?~Z>sTJM0?66o@>x9KB$CMNcN(m_)6 zhxOTm&i!GtRx7s&Nh4e5!_+FD=IY9Us{-UWkiZ>wfAKgU@%2T3cO{iTU7@S zrK;83ezXwMT*ByB`W}L*=gV;?dxnT_po~*@l*;YG0#AFyU)AguC(psOp`aKI3ck6P zds#U`_(;*fgLy8*Mo7@%L>=v*SC<{?x*o_>u&}MSzT6oIM8%nz8O=t=^NS0L-Nn~n z{uV4Eln$VC*tYjh9)G{*&I~mTMYm~zXkz8_BfyVoJdy?a7D|ezw+XYHCVVP7XBgdOA9?@qn13Ofe}Ks7zbm>~ZV>QIt{w?G6~ zougy`k&CjvzMfdI#^U$N_BMyhiGhcQ2jG*uydGg$mVhA<==l}s4+tQkK;u7sfqLpw z6X?eVdsn5H!~R&A=Q3GYWR`$te3pM{WeYS|0LSwS3Z7JGP`!rQfZhQ44G>h_Z5&hz0k)b9#npm_rA2x*LFE%tfQjOYNc!U(iY zJ0F4W2!47X)PgRAc6~jjCxTQ%BlCDQ@N$1PnwuEK5CBqkdlTS1T>$Bsl{GU*h9D`r z64mkk;g*6*3be_LB>x`c2Gaq`6Qh1lo$}20$S5?J4zNV}8{$%0hWnOM8 zDnc8jiDX~Xv$S-+w(SBf;<|^Rfw8KpB}Y80lz-)PQ4 zvD@gqMnJ{OI=?zTOjiXi!*(Or8+yvz($b?A*LSunU0)|iz@-6>_zb}5aI7uq)VSBL zmh10IO9w*348h$4?xP|zvmTfWw#TJG%h9$r3E4Y?pqj8Ds<)%!>FUJ1>`9diE|tKv z1FGLhYia4{uX^{fu)y|{2!Mt#844ED*59vOfiWh&No0F06C(tB*0110&EPZE#nzF? z*w`ZQ)`Vt3Zm>ROh^WoBXIrjUOl{Y|!aDJ@^-pUY(qhJc?~GHcHv8Pf_@YHKl3@*d zb;C%~6B=Z2AUmb2@*l7mH=h~-ip0^;k?f!4>KyZM% zz|_9 zh_N}s_XyY`DO3=E;Sqcn#g`2Pqc4*3RId~d9ROp5XjLhK22D~GBZEi@&Ju`dtqbS? z!npeU7kR}6UX7x_P!|0{Q2!UrfB7^#t8BoBhZiBj z+?6_k6PBg5MCOg=dpY~W7ebrrK84O-h(A=Xv<|`di8Z&$NIW(FJ^r`RAjE0q7Y#nS zAx`?}WW>esX7S%8HT<2Ve45OcY^M&vA!D7(cYeb!*N>X<1vi`gb^X7p-BMt$qsPlXKP%*dl`Nr^}UV5NE*nu8QGX&5D- z1B6yX)BYMq&y9x06yi3V<*Vc8z>x^3MW9c(#SV}ANl6TK zJ>PM?y+DTt4R1d{^%^WS^>6R^*#)Za(Z|+@q|D6gCKpx$E{TLh6c^AR4%&=?ak^Mz zzJ49XNLM#9>V;It5&r&95kk)*G}gDHef@~fL`eV9{Raf5r|v&@g#d0h#}V)*qKyrq zcPtG8jKtanWS>6O$h}}+2fDWN1VpW?C^+dm-A=&kpSgWreG^{I=Xu8!^NQXNzZ`or z`Pq_g6D2P6+)lA-k0@O#ZtdFIITT6#EHOlq1v)UFP%tnM5E0q$stmUIBo-8Ci&AU- zd*2>P0dg{UM+>a9^7;%whB9Xua zfTVtE_yuj#Z>W0PA`W*Z#n7Hd!s~14EM=iahZ4>c86ZN}SlIY62|++B0*g&#H?Y`5 zG6lcKWMXq_{imNMe~~IC3(!@--N>&6EJP9b#%;y0&J%w(w8fY=Xx79Ps;EVOAC#0h z#t?P5hvKm9;9VpCcSCmbzZy@J{Mw?wmN$ZuiCCJd8S?o17qx0AC%Jk~PM#0d zZv>>IVhqZi%kQs_JH>HWp!f9tbn}glo!N4-$L}w;`tCzBXmKxX7$F(LVhX-D&lB8O z5Ad-i9ouphdH>#*otgR4#Jtd^@EPHGIEXS6AvaQxWs6n=mMkgVEUam1L?U5DfD7Yg zW%Yg)8(D_%zdCylaH{|Jf1FCPQz2Uj5lUue$<7|fC@L%2WMnI&5<DQ~EF;Lh5qqy8Bc>kc!Mu#(pnBp{1zgO zmvkOWG9dD<_AN(aHX|T;e3AK}=^r}5WZr~pAm&zzdiAQJifFebhQCDD6B%8TfJpyR zDS9L%O@FN$BkIuXe=K4e^dcSV15K}TT&E1u|2 z0VsA(4!Np+CmWD$|K<6gn3Uk%$9y; z-np#Q?x~8rHi@No>E%5qfi(FWsiHwo_qTmKPx8zVKR6$pI7bpJI9K81&58pOMN>B(Q+A&NU3l61A}nLcPE_kNW9_ z7kN@h*f}@r6mad?Ip5xTOB{+<7X%tb&Cel9pcnJe!=Rd2TEfMANlQ!1cRuZ^9h0rNu9fh$Q0K)p2;%lk3=?G9ht88gK z_sqnwt2&-37^L$FWQS29_|GjjP($4;W(hTJJ>@gE4(m~8J>*;XM@HCyl*q=$R#c*` z+;O?op52p^h<9VX)7EB_I4vT=4J-sSL0G5C%Chyv|IXxu<#ihx5|xz9YHMeDdfMI+ zcY(xD2Wi#V*!EG+Xp-h!4uns3`y*eq&ako6y}cs*mVX(~W3|$ftU+5edO)#l+zb~`{3tj%H}UDk_FPHs!_bAhG^eyM0Iai;CoIy4VD!>P?( z1C$Z{CwGu#ZZRq#RmSIt9VsE>_=ty_m=LwLW_!6q?0B7hJdDA7aM$a@@*oqr_G_L) zCu>?!BcK^%-=E919y`IqBViL2NO#fY8-vs)Rs!w_SOYOLUS&zU47AelIUT{IATwr> zf2wUjbDrJK1AF^g$R(uTqYh=QK4Md4<>Z(dr7Grx38*qSdA9&V^b1jp_xtyc0eKWN zhGPG_>$htAPIp(_z=&7lKmU+Ts8Gfy?2&vfYQc}J9%u)B#kSXr1*ENhlgs%m6++Z? zBU?~fCqYjHHINx%4_kcruC7J@Ht0Fj;EAF)v8!{g5${{6Fmi;s>AtA9pX`J_n*$kjlQ z_QGYg{F=YcuWO|%GS}>uSZPyIUpv!D(|p8%@d2~exIEXWIa@KVMLb@oFb)b29S#r! ztV1Wj{`Fs)GypEHvik;+nW#v*pNMtfc&`8JCGVE6(P*VpjpuF-P&40CazpQzq94I@pfdmn#;bC&=n*(7}_jCK{u00K87ON;yL=UK3@ia$DQ~m3m;umVBn@>APpzS7l{=tbXyy6 zs#)tK9k>{ngb+Xad=~AITUuiLGQw48_&)|uhXMh^)peo0{pm-b!vz;=+qPie$`4}L z3)W9)c&YpBPzdJ^zA)Y|ahFom({g$ShFj?9v{$$A$MDT3xagh|XWAdkf}yZFl67Uq z1V+{cP-z{yoOz|C9vTx?5b{RciY7FUmd7^L8#)z18;m^Tz(9WjI;qQyW;S-86PZp` zw!{pWK8R0BXW_GqC74O(SJnS+bdin_Ep3byF7<7oxOs=>2GJm^r|sz%I;qXJiv&Gv z^rp@G9S0}5PC!+UMbO%1z6ORV>d#SkxKgV05qSS#Y6AcxQcY7E6Eqa_q|IAh(BOogXqs-{r>}lDH$k`# zY`fm)!->Y%e~H5+%Wrezf-DO1zW0-Hr!Yz#S3ICeO||c$`<#Y@h19J$f}W{&!4Ueh z{XI6gnf*sgiMHnZ=#CN;Q}`#1Vbt66CWY53HF2tYjjnAwE(+~7Th5XE7vif}MEpx= zPZEDNNpgevGe!;86ktl4pXnt*Ki0|V1yzx9mx!ia1oB=fDOUS9#A@jd;Ke%+*g(cW zhf2RHhOb+6_B1B{IFt{{HgJW>zFhyk>LXw#meCyP6ZbsD3s2l9L96Lh%ZV<_}Kvwc5_<8~B5-Z}qULb(a~_Tx9dSIDmhewlzkoLMv_0+`o!cd*0zk z6wP?tJRWB6_?z=IC>4p6yxiR9Sy?3N@@W6xUYQyj>jd4}M!9cvSPp0;gWkwV3FEeEIE(_NGKH-`}>dSqKM1nByLE$9YeA zeyXVL0NDyH z!V~r-+7sY^A7llH6-iF1^<|Ff6==eMq-=JlDluoooCzimTuA8dGxvm-A zg*F)=kQH-;W~C@p-cd!lt>@g#;Ze~X@=A%cj&i%#)zASVywHTp-=8oVy*ANzn;zvY zDw-QwsJGIIJ`kk|>!3WseGzR^)@kTff;uIDxOS>{28Ky@5SyIi7TOGsH$tCqE5T(qC@g$sj1JN8{NT8dP_t?O7k2Ee}Ew? z0r2?42FXnp8rC{9x*)Ube0<$)O13t+MuFitM0#9q`&OGbJ!C>8LG5_Q=*H{w%mv!o zkux(Ut+5MtC2b~~Ec)MmxasQDgH5Zc{16(>a(|5#CV0#i5z{-Mlbg1xt}Z&7YCEMc zpTOOD1Ls?|mcrg9R_5sZ1xX?0RdlO$|BaSkcgLlIvr`P13o?_y1F^& zLB|jio1I`AOLQ50L`KyxKps{egqyFK^kre-3iZu&Nr@d&QW_fv+PMYc2-bQbr}b+u z-`p!U?Xgi+O@dM5iV9+RI-5*P{AqsihZ>CArAx695hF%MKZjh_KhKPkT7A0l1ez?fHiIqs-es5nVS(22 z{%8*N{o-@bFvo5AftBvh!g0ypkE}b-rt8~NTJ5+fN_L3w`cALDI^gBaPQz8bKJxYH zYq{`ETh1yGdoz$U$NY3ro$JhaSrWN0K-LTIo-Lg572;xpU0erYX(MJn3&tSb|3%uSyRzck9ChqeNXq=6*28(S+}T(#&ASLe^V)uq$xT)9zw+=BrFDB?%>x;_-x*v&-C?e z->c7dqOT0_*g&fF+6e;j*g62k5<2GXpkK_+=c6V@Skm78`ZrS8Y-Zn;flO37r*-PAt@HttLKUt z1xRQd(^Or}C?awQe-A7%9zH%OKa$o8*UUEeGwA0%cT$hI60tZ~3}PN=OsKQB zq^zM~zdU>ka1AK9VI7=DU-cc$_G=8(ZL@)bg&z(>q0jObfHVledpVd-iTwlg$X>_L zBd$f%snsFsw4WTwfSe~yJ}UL4s0e&Vckb}$On^mjm3&nhV3bzNlxWfPQG#l1n&dxo16z8BN-K(cVo z&s;s&-6#ddQ=2XNfxJ$k66fzoNkOetX<7??o!ck$h%v)C^->k>pP`5Nu}>x9&WjHp z%%R^-TORrsr!Y|T6z~$=*;?Y>&~^q-82#vC36+TIQ>7<+`ucWYdE9PA8%ZUqWs((Z zfDA$Wk1LFa{+TsgPR7E5!;=kuZf`!rT zwSD{7kP@6gwO3zZXQvi%K?}-(PVF6w9*gDIm54|YK%k-j%&WjaP8OE4$9JmCf;(|Q z1FM;t8DVHwHvI~IjKN9Zl0t4h-Ij24u;k9)2u~{Z6#kwJtOE$)L6U#gi5`AdDF=US z|29`sTU!_95>Y-t4j(GH4YM^9tAs)Ke%L&_pzHoMKaSUzLnj-TDvo{v8w|?szlLfU z3$DvE=*J8(mL0ao;!9bb?zmy4yuI~|zlAu5c4 zaqX>jWfnuIZ1`2J+vtr|(d{`st*O4ja62P$HxMQq_XIgM_e-$WyCC72w5&MT+?Di1 zvOw62f${nje0Kuo@bjln&s-0_BHlr4jDaEX{LM)UUnump8$%6xZn|t{N7mXpa@h9q zgFpX@36G59-ls>kVIg#AP)XWunCU2eyqb^4ne7Evsy@R-_}Cy;)LkJC6B83!pP6TiP<}_y zh}Ae6_&aBGo-iOJ{56H5T}LIj$B2fksy0$)SkF(Qy`XF+EH zD;^1n`YTs1@wlYe6G2bBjx@o?kJIfIb~TjRrnpQW_j5mk#HXK_;-%f?ymOFJoMouv zAN~wH0O(24saekR8u^y0DQaqUGD>@#yyB38EiJbI*~WVAWu7rZ#$DY25McD`V~YQCur>j=!0wdb3Yx@4f~S${U!6yf90#e&LpKbnODTU^)t9V8^e_8a<9 ztIH3a+}xh3Z@A_{z}>_S+_KD^oZV^V5;fNEoo4P!x|vNz_ud-3kD_ecB8d>LuK953 zyUg8vDC6McM)2Hg3us$xQ>dxU3D(1beC_2K1FB`Go!vQPd081nuZ;eEB3bAcW%k}X zC`k8ldTR*tIrNZ2_gCYZ*W|*^6w|Zz$+fAelG&a~W6ST~W8`8xJ2z&|4wxA7>aVP| zIz!ulbOMC<#L@ngAPQMGKeDqnpCb3;=~HeV?#{`U80qIKr9P40$4$r{OFb6vzryR) zB)g3ZmW*!9qel+pD(T8eU`>Ebu-Op9y?9W-tmxxUzGji8K%u2IV4&gS%lYcfJ(W~{GtKgugC;l`9`t97({3UiBcz8PZN|^+m1?6MyJ%=iOJ=h!cgAvxtLK8a!gYl!o ztqR24h~0kd&S0_dUA!lVVDH}Ebp>`_@~F_dC1PXV&~UQ$Ot)@#_Wki9dVBB!mA7 zT0RrXzZp!o_ouI*MNi2J-55sA%2y)ML13;x7aY#g1iDr~Xu1B_pE-Q6JW4yxIHEI+ z-1$_a+=i02Q(~=UuxSt4rpS{RP{k{OiUy(}GIs5C6&;@PsTDp?57_4yaJUGSxWQ%d z^74YaXLiV#Vp=A-jE}xy5Zn;cadTcvSvlwq{SK&@<~nFliC$=6f#sY572QSP1%2=6 zaNgfu!PBYwn}PEh2Vn$=uuEL`3igfuemzg{4bam^x42#uG-OTV@DSbi5CPDIH&50M9`gt#cVUn5U3x{60~%?<4MjfH=V zU-j^?R^!Y&=tv_6M=Y`uUh2SUGwUSVtsMU_0Xa|J*vc&$Veg(~k z@3#FlorXAa*r(o%ao~qSA33mmrS`0lf6Ga0mKrtBYkbf~t<;Lbn%?&DtMVaOD>TzO zgGO<}vBXp5CXxf?>C&@ZFsj3+u`6|z-CN2w=nIliV`W{xU%HTdUQBk$Rnlk zy~=Ouwq7b~HTiGu zo3&0|2>F_(N||#|Wc{@_l#YR+9NN=PPPjJC%1}d`E3X4i4KC$FizF#CHatB2)sv|VF3MItI;Jq{`6b)Q6AkkMtUAv>?X8#PKPD?Ri$dVkAvQ{z^^$^CCO3-zKR`&Osw zrTi-Bur7s2E9fdt1TkQ1s8^Jxx$fD=+%!RFlzNu}XbvX7C#^^Eg~(h5bCuEOez->6 zWjm$Due?1Gevyf-vz6A^BenOY;J{!}kXp}KF4u|f4`1_pOC9*M@0D)qsX<)XE z!;kC48xfmBZv?K(@g*Nwm!uS}k9-pparilUh+Nv&8l!a|yl&j$8^y;t%$xRARKBvq zRt18NyBDM%7123AKs_=@{$?Kh_G8!+fOZ}|dD58^gS$m)sBi%~i>I8Xp$Xtg)$Td_ z+0{GR$NZ6gM;s}XXgEU|=)<~}Nj6IjGt}BsK_ToX*ohK+-cU!X=;GPU7y2>$#(pZa%-WY5Q zxo%BBOcpEJYJ_UfOT*-&*Ln_{GRpFaa(UL=*}lGk3|;!Z+o0Vo8QlkSo($%kxNUg~xy@|Bt!H6c`Y?EJv9Iy`Nd&c) zRGeDu1rgh}@PPa>GB_CvY@MMIS`ONBkzA%>=Qk{$Jh>BUN3ha>TJ6@M&Y-owZ?ZAl z2QZI^^sQP<`uGu4)w`NU-XGS&$TjY`Vzn! z(yAf{>nADRjV1;D441w9*L{^;QZjd|+Pprtnm@lkwD$zpRpG~_rGr~3Da^h844)A} zaAXUW<-04wj#lqVOH+t_AE2r%G7>Jm_UoW9EI?mJ>3ASDQSC0zm)MY3{%|pOFkB`K z#aTn~X)V6|DBQb=2E~;aVa1-R{F`fpUrFGg9mfCq)ywY)0BhLqZ3FRXDc5ijIVfXo z-Oo4Vh=<}tKgKZnG3X@quCNJS36-UoW`hL)O^)v^yP{KpQ`qFtFR^A10wur&6d0rk z8SnEu^RCWxyeYP2?jO)mcz^9SEDwTn=PM$)YQnlVXVx~mKlnZF0)PpEJZoXb%OCLY z_uuT`f=g51xG@dBQ2F8d^sTL>Be5j(VK~B(-QD(W%~ACn91P$5DZ2|TiDpAsO$c{) zZw3Vc-ebGJZv++z&@)yxQ_2s!hkKv7BLFf7Yjzq2;PEQ@1>zm`UO}v-?{kubL-!2< zo=%y?k3j)jk>r|zLe*Y5+={(LxmgrQvYYK&#vt*YQ;ub46Dl2HJV+=3pJq%pX zE9vy-ZK^xNpqJ2Ma)Ft7&i%-F>+m2eD>JTWsC0|g)n*Ej4!yLF^iR~(m?TLagx~@U zmrbYkN4|v~riSNOs<785NR3;l+?O9*V>?=lD~E*Jd6mR+sXqUGEUNy8>s1mc4X=H{ z)>w6&0PnvR3VBDG!e^aagMQDGSwrsbR$x=cX(7w$NcFe2y14sYYKf9^Zq3!ZghHsd z6JW;YLa(yD`&BPPbklZM47P#T3JQeGT%fRI-QOIzMH_d;fCO4qe#mrdDF@#SM`o;& zXo#b#6te18Lcw>pMo!!bHEx-o)b*48sc+a-m`HD0cUJYaRA9S|2kNljuMgk(otv8* z_l%tS#zfk)wR@SFt!<}HISRSQ%A;P#Quq)YSEef@jzYEvR|9J3oxDIV`0{Mp1$i!KFX{`n-*b`o@)LB2lVaSnY&T z-$WG>4Gg@rv?Gg40}sYStjF054Vh_0?xx*-Fbq9n8M)K+&DK7*cq zk>mB-x%47gMaI9Tq2cDx)P7ZZt6XrLXsg>gOSvRLJuX`a@ApKH07&{V&R}s7p2d8$ zFKin^^hb0`jG?Do^+yugippjramOS3UC#DeZIJJk-w$T&) z!T!X9p3}5A-x0rwv^t5QSs@ zlrp$$B$3ImGS=7S)w?WZ28+IT)JX?6kdSC`N3^$}|N9?5eu;!`#jsuC6B4>V&q06I zxIEcc27blG*VTi?2a9dJpgCfojcp$7jmaP2CEQl)Apts})#&B*8C>4Z&iADX(f3`^ z{GYno+wUqWI&Yd8Ghu#q)<>;QgvZ^yNr+rvD|J9#yMA3w)j3J8A~sDyLP;KqL$LZ2 z2nFrc(mZqSy~-{`#Om}Z})YY9C+kD5Al-RyGUVqKvTSxot8C!HQ?btHV z4pl8M_&098BoMZY#Un6(_%J$ZZ|Vx1kie7Qo8qTnwHyuc5jtk90vzRzhl}3Ml5@a* z`lrp(B@~s&;OOFyPCT+lH=in%KQ$4pKSgrfrH%;J<;G_0-DVpb`+SQZ4N%cYPPQW^ zZlt2}$!%s}mIZu_(9!NU1web1YQ3x^0Hw-c9=3Q-$_G<5uI=c}emEZxXBhn-c-!rYEzlePWA;OXglU=auPf8 z>0Bx{dhO$(*FNWZ=<^!4&Nm{ad$RWiDQ*s;LsD!v+)Nxi9U+64GhcmYE+lg%UuZ%| zGZdYK65ec*)Qn2T9o4*pa_5Y}@2*3rN)gweM$Ndm=VY!J!0UPAehV<~?plz3QniE2 z)7ToAlZj#rd-|;@TQKA_R71Ky1h&4j9`pIcMIf7HK&Xt^U+-uEoANlk{&w#S`J&TV zciJ7)?Y+8~n(I6~iEw^S>-6^*niDNCjcBj<1-%o7y-`)4vlrM}CCWS zT+|oP1CqYhr$?tZB-wol@*cQ}wLdV+Ztd^r_r?=_WN5<>`M&AW6L+HV%Yn4CW27?Q z)ztcR%Ps=?Vgb)u^~2G5cb%iVva!)_Wi(LB5SHto&Qz&&jZNYfrRm;lHP&JW&d+5+ zHw2yuQ#*XEBJJ>u7JMcKjcU&coT6?VdX`3skjWh#<+5qGFd*#gvLm%6A4Q5!{iLP; zUTN4_;Ev|;p^%`_)|AWo>Ps8&0F~>!_4;Rd>B0Wm&&=5<{oZ&+f@qn}O_B)l&O@5I zoYREdBRy^O=6^gULGupof`~(fg4#Pya29m@=s1FV{4n(8OGEJG$@;w1V>1`;qHdo~ z`c=;pyciW>m-ZR3q2zH#KsX=+b6RJKaesO=5&qtOL5<_y%Y;?v{^sf`8q^0hPl%ax z6C@_t-~ddtc3trMZ60B#&UZfjD0LKt zPg8$nzxpOGw*cyO6;)d#xQHI;@W{&(uy_HGv-}UAKA~cMoHaW6**R+jy;z87%o<$0 z%M#p=bRq8qNJ;1O6VfYC9XPiGk9Y=`n!5SjyR(PU^(J@a{h`T~{PWwTO>P5sZ>gp< zlsg~H&9F7C^@dN5jIgZ9u>Wb7<40QcuCNQQEI+(ik(x;F*H@b*pk!^WE$)<5%XpoW z=kbB>TiMI|YaCZ)WdnNLv$GImV4<|04WYzL=iJbj`FQNMw%0}@b%dVLLrasDwJ35b zp>K84oL5Y!(Q|e6SIl<-9SA@mBrfjSi$t1Y|AA!K=hH3FhM7_#6po~e zuU`izx97Rl%>HL2EGGW5wdwv4bURVd(K#6Y^57h?t*w3w;+IME>|aofdHuL6GbL`Q z3F_E?7(OBzs+9T*B$p8ylV>dO;km`uFd>NbAlsGw@<{ZFWSou5<*R0&Le=#&$bsEa zwTGxfaPtft`?QPxa!w8ju?-*|3?MoFYFzK09YCy0Y<(0FcWQ6gI*y14gyAsoOjF z;LwP*d4Eb_|2ON9IHqU8l6<`d$BInPbWo4a%SlL(x=I*O5=660JbfxA{gN5IkvH$%y!C5A!G z_R!^BRMY`L#hbHT8zG9dz=o+Skd@Y)8yS)QxqP_yLaX`Jc^!84=JoY_<5qj4M5R)` z7R2f*Du&k_|MPsWa*R`v&E=N$ED`yPp-?C z@3f%qzQ6Vym59!|Ahv2g0(5~_hj+K^83%WXx3{&$VqBWR=xBG_BXAjj-$({f)v>0i zz~Ndkknf^5Knj$&USbHKxHuZVvD<%1D2sX6N0}k!SGI6ywgzD!p#J@k1@`DUA3*-1 z@odjt)|W6-SsCT+?K}A6o0GF*Y6IjJpoUuAIAFYDa{o>>7qFAESE^qvK~dJLvy#;)_0v~3!&2s+M7t^5uaL^#!e@#crwTYXQ=fGPph z>9Lcq^0;_AK^>!RFdUmGK!u1qYkq!VaKE@u<>-U<=k>KH8QUnHMiT(@GC>cGu>cKS z+r06vABR?(M^n*~Z>Hmdh)=^VWFa}W1{42EXX>`t=};7$YPL;C;-W6@)AIlLu}0kI zy@<@&` z$kIjcI&ZfzJ0ko2C%{d!@3xCGv}*%+nv(?(sEJcFQpqzfu4L1DiEVKIKgU%rdMlf; zWlu9G(Hlk$y;OcuAVXiad|2}5-Q{zm$xbwIO_o4HS%oM0)77^3Q3%F^16cEyhaO z#im{%5*by*n)|Q_!>D>MT9Wtd+2LDQH*-RC@-2rJfnH~GB2(0vH<5XNp@y#qa znME~E_!Y&UQ%iTW)wFiLJ9p@Y>MeyE8ERDrP4E4nd}c(6Jp1%9a;0<#G3USb%6ZGc zQjU}hD1LZbDI&pNYPzykz)WVBS?bYUA!d`3!tT6?hepRvAN$1qCF9AsqqpS0_)mS$ z!fRhMD>4GWyiWWNUqxmj zgmIMZ<#H@jpTL0vpDK>buj%fV?AfVtxg{AMvTXkQ>lq&yp3^ zR#g?rk;M!T3qYP>5PGhj6hb%HO6Q0-&GrDYZxe&E^Zu0Rkn%_)r>NaiD%}Bu{gN(J zPt#L3B_aNV*e*V@tjsb^p7Mrsf$g_|S%49?8$$UZfQFfagac`M6&K3X5WZ`K$zFy` z<&ol6VLo>wV0aA5$|laM1{Y10bYmmJNM+*&83SpDMkkF#A(a5?LyF1AaQ3_iU;*5| zk#N7I**|!V0FC3({}(sKLjhv=cvWV9;90_kgf#0RCq2qlFhv}@>-dBvaY!l4%b8Ut zUSLa^#KRiVDI`=KL8txaHp?LTbvxh*yE`%8R|nC_^0HO_XKFR|1F-|Ncftk4?hB}U zr>7qW>qH9{`X+nc3=$y4QeRaJd2{i59Je=`Tbm@H>gkmM@?Gv~aFWWc+2nln;G_O@ zh}1`2KEGX+eskmmw|%zZ{UHo=c*=pE{~^e>|B-^q#rY;&%9fec*?gTbT7I zH8{!BoSr_6oMLu%ZVnJ)n{c_`DLlKj=0#&ebNx`D+Cs`51B`sy6$qZcypWGTzGYco z8fqLIEP_$X(rBjlbzHpz(=toZcVKh9nW03}4T?aYg*xemDPwwED_ANzZC^;|u%~xohD9nWPJ?7IecF5_STRK72Wu4#4 zH#HflRMYxD**txUfyg0-f!xDcmy^#G`L&@)k9|tre^hNK2XqqzHZ)K{5fTn+ReIKY z&F}g1>K^Vk)7|6cgywAlwh?EkqxO!9yqJr-)A!(l)-!rOKGqvI_93pHzru;+)cwYX z&ghQW5ho&N_Xs7Z|Npy@e|Q)%99IA#(YeusxaW$JZ~sEOao0kBWjM*VdvYwP1q&i7 zSQ!|y0f+q~2MQ01wX(Vh{ru}K>xIoXy^~(vMDL8_SMhk{;_Vzdd|WPc+I@BfpDwZ~n&3l{zcBmj@TkIgMJGcJ6n*ftFoC##NjWKj3p=8s#K zz(@$1_rC{h@h0HLIOCI&T^A*+rqFL&eFE*JY+MZQy$jTte=hz^@M|ugiYKWlcah5u zwECxji88yex4p$?1pYSAFY z%G*n+M6{`@_e%1Is;fWBc5l!W%|TJJJZ>(3Z`@$f7xRr8@ktirluvwA#` zPoAiG&)otls_g&CuDTdPP!HJ$(7?t=cQ>m0QMnJkT3NROkqt{UQfU;oGCGg`rE8nQq;^iUE10%EjkEQ*;TQsuA|HY!k z(Ka85uyA)mGv0EDfU&22cS7Ke5VUWz7Zn^uzbq2yD?<;YJq#XZ7+N zkdTqvXH!vASBB2fewHG>|7TIs!$*j7vHm>pYyto#gK$hz(n&^Uj>0WHC%frW?yU2I z_K8pcz*$(NFAUP4!?{!f^hP0YL76Kn+Zc>Dv?;|&mYoWTq7027cLR6uOBYu3S6!NA zWRLK#lGXn?%>9RbipSY*fV3Qn!j&Read(qWp)&$BaqEndn;!H#melH#5g>pi7$=Zd zn!oP#;%ghIu@M)aJDYKca&c7^r7fZZWciC|ROa0vLU$YY>o4dzcX63I)n ztXG9jp~GIqW2dmhhNsG#JGG*E%jo2BJ?oQ?Ph?2Q2FM%InS@;Gp+5;!pVNg*+SAPk z!s^THz+xT5>5vezjEXy9>{pD z78F?0gWWd`!Hngzll(3`&Bom{&SFw<2^^mRrmmfxdL&c;6M;FRGjL12Z0;5!r`p6c zi&p4jbodr~G4Y>I9nYb+a4TCLrni_(%yE_3Kjq*T)`5R0j+iK z+;84oz?%nS-yPdI0yQu$SMO39#=HjQm1?x- zyrsft_TJLOq_$f{v{NAB>=YaKYk+qP!Y<&VE5wBV#RiTSYN1?8BKs*zN~nvA+zwiM z&J$jI!1Xk}INAsklLo5T%g$qa4FIBu<$Q0 zzswGY!@UyZ6Tej=o>{$v<^YtH-RsMQ@Enak+hY7OV>J(A8sBItBE2NKKD`w&2?7fS zqzMYZV+tLiAXIAZJqs<=fkGtZT@nduBaicurak9I$6i3W(Mq&k!0Le=0q{CyVDx=_ zDBNX#fe%&4OIp^}+d6Yn1zc+^x3R0v54P)Ez}aVGHGGZSK34S z_u*)Iqi0AxN&0S<_Gz`~_DfNc?7|Y&%N71=tbl_E11`}3@EZvKWH^DY4T2yUpyA1C zOJQlh>zfbPd({6~wb<&C4=cbG({p?Ep={P_wg*o1uj&Ai)6%?{2PXp_Vzg`O+9Ar5c??jaLMNv-`2{OkT5nWGxO1dWv2QD$dj@T5BEdclxWS(?Np+{ z%%e*Ozn}3a_L*Ci_NKEDYiHMSjmT&JZQmRG7YFtjDe94L`96e_FZ!{a@YU*Iuax; u<$ncz|L^ENXe=<^QA5i1_y1##PTn?}c=z-B<{tWU83~0uIkz7?|Nj6t()xY? literal 0 HcmV?d00001 diff --git a/service-locator/pom.xml b/service-locator/pom.xml new file mode 100644 index 000000000..a7cb56f8e --- /dev/null +++ b/service-locator/pom.xml @@ -0,0 +1,9 @@ + + 4.0.0 + + com.iluwatar + java-design-patterns + 1.0-SNAPSHOT + + service-locator + \ No newline at end of file diff --git a/service-locator/src/main/java/com/iluwater/App.java b/service-locator/src/main/java/com/iluwater/App.java new file mode 100644 index 000000000..9905b68df --- /dev/null +++ b/service-locator/src/main/java/com/iluwater/App.java @@ -0,0 +1,20 @@ +package com.iluwater; +/** + * Service locator pattern, used to lookup jndi services + * and cache them for subsequent requests. + * @author saifasif + * + */ +public class App { + public static void main(String[] args) { + Service service = ServiceLocator.getService("jndi/serviceA"); + service.execute(); + service = ServiceLocator.getService("jndi/serviceB"); + service.execute(); + service = ServiceLocator.getService("jndi/serviceA"); + service.execute(); + service = ServiceLocator.getService("jndi/serviceA"); + service.execute(); + } + +} diff --git a/service-locator/src/main/java/com/iluwater/InitContext.java b/service-locator/src/main/java/com/iluwater/InitContext.java new file mode 100644 index 000000000..8c6e0f8d1 --- /dev/null +++ b/service-locator/src/main/java/com/iluwater/InitContext.java @@ -0,0 +1,29 @@ +package com.iluwater; + +/** + * For JNDI lookup of services from the web.xml. Will match name of the service name that + * is being requested and return a newly created service object with the name + * @author saifasif + * + */ +public class InitContext { + + /** + * Perform the lookup based on the service name. The returned object will need to be + * casted into a {@link Service} + * @param serviceName + * @return + */ + public Object lookup(String serviceName){ + if( serviceName.equals("jndi/serviceA") ){ + System.out.println("Looking up service A and creating new serivce for A"); + return new ServiceImpl("jndi/serviceA"); + } else if( serviceName.equals("jndi/serviceB") ){ + System.out.println("Looking up service B and creating new serivce for B"); + return new ServiceImpl("jndi/serviceB"); + } else { + return null; + } + } + +} diff --git a/service-locator/src/main/java/com/iluwater/Service.java b/service-locator/src/main/java/com/iluwater/Service.java new file mode 100644 index 000000000..cda1a9d7e --- /dev/null +++ b/service-locator/src/main/java/com/iluwater/Service.java @@ -0,0 +1,29 @@ +package com.iluwater; + +/** + * This is going to be the parent service interface which we will + * use to create our services. All services will have a + *
  • service name
    • + *
  • unique id
    • + *
  • execution work flow
    • + * @author saifasif + * + */ +public interface Service { + + /* + * The human readable name of the service + */ + public String getName(); + + /* + * Unique ID of the particular service + */ + public int getId(); + + /* + * The workflow method that defines what this service does + */ + public void execute(); + +} diff --git a/service-locator/src/main/java/com/iluwater/ServiceCache.java b/service-locator/src/main/java/com/iluwater/ServiceCache.java new file mode 100644 index 000000000..ec727126b --- /dev/null +++ b/service-locator/src/main/java/com/iluwater/ServiceCache.java @@ -0,0 +1,46 @@ +package com.iluwater; + +import java.util.HashMap; +import java.util.Map; + +/** + * The service cache implementation which will cache services that are being created. + * On first hit, the cache will be empty and thus any service that is being requested, will be + * created fresh and then placed into the cache map. On next hit, if same service name will + * be requested, it will be returned from the cache + * @author saifasif + * + */ +public class ServiceCache { + + private Map serviceCache; + + public ServiceCache() { + serviceCache = new HashMap(); + } + + /** + * Get the service from the cache. null if no service is found matching the + * name + * @param serviceName + * @return {@link Service} + */ + public Service getService(String serviceName){ + Service cachedService = null; + for (String serviceJndiName : serviceCache.keySet()){ + if( serviceJndiName.equals( serviceName ) ){ + cachedService = serviceCache.get(serviceJndiName); + System.out.println("(cache call) Fetched service " + cachedService.getName() + "("+cachedService.getId()+") from cache... !"); + } + } + return cachedService; + } + + /** + * Adds the service into the cache map + * @param newService + */ + public void addService(Service newService){ + serviceCache.put(newService.getName(), newService); + } +} diff --git a/service-locator/src/main/java/com/iluwater/ServiceImpl.java b/service-locator/src/main/java/com/iluwater/ServiceImpl.java new file mode 100644 index 000000000..335ebef78 --- /dev/null +++ b/service-locator/src/main/java/com/iluwater/ServiceImpl.java @@ -0,0 +1,37 @@ +package com.iluwater; + +/** + * This is a single service implementation of a sample service. This is the actual + * service that will process the request. The reference for this service is to + * be looked upon in the JNDI server that can be set in the web.xml deployment descriptor + * @author saifasif + * + */ +public class ServiceImpl implements Service { + + private String serviceName; + private int id; + + public ServiceImpl(String serviceName) { + // set the service name + this.serviceName = serviceName; + + // Generate a random id to this service object + this.id = (int)Math.floor(Math.random()*1000)+1; + } + + @Override + public String getName() { + return serviceName; + } + + @Override + public int getId() { + return id; + } + + @Override + public void execute() { + System.out.println("Service " + getName() + " is now executing with id " + getId()); + } +} diff --git a/service-locator/src/main/java/com/iluwater/ServiceLocator.java b/service-locator/src/main/java/com/iluwater/ServiceLocator.java new file mode 100644 index 000000000..e2fbae2b8 --- /dev/null +++ b/service-locator/src/main/java/com/iluwater/ServiceLocator.java @@ -0,0 +1,37 @@ +package com.iluwater; + +/** + * The service locator module. + * Will fetch service from cache, otherwise creats a fresh service and update cache + * + * @author saifasif + * + */ +public class ServiceLocator { + + private static ServiceCache serviceCache = new ServiceCache(); + + /** + * Fetch the service with the name param from the cache first, + * if no service is found, lookup the service from the {@link InitContext} and + * then add the newly created service into the cache map for future requests. + * @param serviceJndiName + * @return {@link Service} + */ + public static Service getService(String serviceJndiName){ + Service serviceObj = serviceCache.getService(serviceJndiName); + if ( serviceObj != null ){ + return serviceObj; + } else { + /* + * If we are unable to retrive anything from cache, then + * lookup the service and add it in the cache map + */ + InitContext ctx = new InitContext(); + serviceObj = (Service) ctx.lookup(serviceJndiName); + serviceCache.addService(serviceObj); + return serviceObj; + } + } + +} From 112c719ee748144ac0c68f4d236d1d4f1b869172 Mon Sep 17 00:00:00 2001 From: M Saif Asif Date: Sat, 6 Dec 2014 02:53:19 +0500 Subject: [PATCH 2/4] Update README.md Added service locator information --- README.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/README.md b/README.md index 46d487bb9..d0442e420 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,7 @@ * [Facade](#facade) * [Flyweight](#flyweight) * [Proxy](#proxy) + * [Service Locator](#service-locator) * Behavioral Patterns * [Chain of responsibility](#chain-of-responsibility) * [Command](#command) @@ -174,6 +175,19 @@ * facilitate network connection * to count references to an object +## Service Locator [↑](#list-of-design-patterns) +**Intent:** Encapsulate the processes involved in obtaining a service with a strong abstraction layer. + +![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy") + +**Applicability:** The service locator pattern is applicable whenever we want to locate/fetch various services using JNDI which, typically, is a redundant and expensive lookup. The service Locator pattern addresses this expensicve lookup by making use of caching techniques ie. for the very first time a particular service is requested, the service Locator looks up in JNDI, fetched the relavant service and then finally caches this service object. Now, further lookups of the same service via Service Locator is done in its cache which improves the performance of application to great extent. + + +**Typical Use Case:** + +* When network hits are expesive and time consuming +* lookups of services are done quite frequently +* large number of services are being used ## Chain of responsibility [↑](#list-of-design-patterns) **Intent:** Avoid coupling the sender of a request to its receiver by giving more than one object a chance to handle the request. Chain the receiving objects and pass the request along the chain until an object handles it. From 85ba6e3dfedbd594055a24a9701edbd61b839b48 Mon Sep 17 00:00:00 2001 From: M Saif Asif Date: Sat, 6 Dec 2014 02:55:26 +0500 Subject: [PATCH 3/4] Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index d0442e420..cc28dfc04 100644 --- a/README.md +++ b/README.md @@ -178,11 +178,10 @@ ## Service Locator [↑](#list-of-design-patterns) **Intent:** Encapsulate the processes involved in obtaining a service with a strong abstraction layer. -![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy") +![alt text](https://github.com/MSaifAsif/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy") **Applicability:** The service locator pattern is applicable whenever we want to locate/fetch various services using JNDI which, typically, is a redundant and expensive lookup. The service Locator pattern addresses this expensicve lookup by making use of caching techniques ie. for the very first time a particular service is requested, the service Locator looks up in JNDI, fetched the relavant service and then finally caches this service object. Now, further lookups of the same service via Service Locator is done in its cache which improves the performance of application to great extent. - **Typical Use Case:** * When network hits are expesive and time consuming From 6318d76d9fa7c5f8891f90b31cfaade7eff1803d Mon Sep 17 00:00:00 2001 From: M Saif Asif Date: Sat, 6 Dec 2014 16:19:17 +0500 Subject: [PATCH 4/4] Update README.md Code review compliance --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cc28dfc04..6c82be44e 100644 --- a/README.md +++ b/README.md @@ -178,13 +178,13 @@ ## Service Locator [↑](#list-of-design-patterns) **Intent:** Encapsulate the processes involved in obtaining a service with a strong abstraction layer. -![alt text](https://github.com/MSaifAsif/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy") +![alt text](https://github.com/iluwatar/java-design-patterns/blob/master/service-locator/etc/service-locator.png "Proxy") -**Applicability:** The service locator pattern is applicable whenever we want to locate/fetch various services using JNDI which, typically, is a redundant and expensive lookup. The service Locator pattern addresses this expensicve lookup by making use of caching techniques ie. for the very first time a particular service is requested, the service Locator looks up in JNDI, fetched the relavant service and then finally caches this service object. Now, further lookups of the same service via Service Locator is done in its cache which improves the performance of application to great extent. +**Applicability:** The service locator pattern is applicable whenever we want to locate/fetch various services using JNDI which, typically, is a redundant and expensive lookup. The service Locator pattern addresses this expensive lookup by making use of caching techniques ie. for the very first time a particular service is requested, the service Locator looks up in JNDI, fetched the relavant service and then finally caches this service object. Now, further lookups of the same service via Service Locator is done in its cache which improves the performance of application to great extent. **Typical Use Case:** -* When network hits are expesive and time consuming +* When network hits are expensive and time consuming * lookups of services are done quite frequently * large number of services are being used