From 9cbc509c3ad3a75f0935e01b2d3b636968cf5832 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ilkka=20Sepp=C3=A4l=C3=A4?= Date: Sun, 13 Sep 2020 18:09:18 +0300 Subject: [PATCH] Update README.md --- state/README.md | 33 ++++++++++++----- state/etc/state.png | Bin 17753 -> 0 bytes state/etc/state.ucls | 80 ------------------------------------------ state/etc/state_1.png | Bin 33886 -> 0 bytes 4 files changed, 24 insertions(+), 89 deletions(-) delete mode 100644 state/etc/state.png delete mode 100644 state/etc/state.ucls delete mode 100644 state/etc/state_1.png diff --git a/state/README.md b/state/README.md index a8dd2b5fc..7ee201be2 100644 --- a/state/README.md +++ b/state/README.md @@ -9,15 +9,21 @@ tags: --- ## Also known as + Objects for States ## Intent -Allow an object to alter its behavior when its internal state changes. The object will appear to change its class. + +Allow an object to alter its behavior when its internal state changes. The object will appear to +change its class. ## Explanation + Real world example -> When observing a mammoth in its natural habitat it seems to change its behavior based on the situation. It may first appear calm but over time when it detects a threat it gets angry and dangerous to its surroundings. +> When observing a mammoth in its natural habitat it seems to change its behavior based on the +> situation. It may first appear calm but over time when it detects a threat it gets angry and +> dangerous to its surroundings. In plain words @@ -25,7 +31,10 @@ In plain words Wikipedia says -> The state pattern is a behavioral software design pattern that allows an object to alter its behavior when its internal state changes. This pattern is close to the concept of finite-state machines. The state pattern can be interpreted as a strategy pattern, which is able to switch a strategy through invocations of methods defined in the pattern's interface. +> The state pattern is a behavioral software design pattern that allows an object to alter its +> behavior when its internal state changes. This pattern is close to the concept of finite-state +> machines. The state pattern can be interpreted as a strategy pattern, which is able to switch a +> strategy through invocations of methods defined in the pattern's interface. **Programmatic Example** @@ -126,17 +135,23 @@ And here is the full example how the mammoth behaves over time. mammoth.observe(); mammoth.timePasses(); mammoth.observe(); - - // The mammoth gets angry! - // The mammoth is furious! - // The mammoth calms down. - // The mammoth is calm and peaceful. +``` + +Program output: + +```java + The mammoth gets angry! + The mammoth is furious! + The mammoth calms down. + The mammoth is calm and peaceful. ``` ## Class diagram -![alt text](./etc/state_1.png "State") + +![alt text](./etc/state_urm.png "State") ## Applicability + Use the State pattern in either of the following cases * An object's behavior depends on its state, and it must change its behavior at run-time depending on that state diff --git a/state/etc/state.png b/state/etc/state.png deleted file mode 100644 index fb1648238e78e123a3e2f60540ae7701dd45ee8c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 17753 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 diff --git a/state/etc/state.ucls b/state/etc/state.ucls deleted file mode 100644 index e0be8d712..000000000 --- a/state/etc/state.ucls +++ /dev/null @@ -1,80 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \ No newline at end of file diff --git a/state/etc/state_1.png b/state/etc/state_1.png deleted file mode 100644 index 112bb9aff904f93f769583ab2a33d3f7b2181a9f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 33886 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
iUE7!eElOdtCT0kf!Fdl4hr*FaKHszv z_E7y^bDF@q{QY1e$3$R;kVg{O-YW_K9~njI!6 zyTjyeea6ZbUD&iZDs+;rfAqyh#7mDauU>uJ-SP`1nkz8Epf=#hhfxQ4g4gooTH)-(?f2d8iS>|4iORpRjlB#BvE0%3kZCm{j}W*&%v$F2*_}gL zQ+{Y~(l7j#c`a`{vvSyF$(^*Oj14ju>&pC@nVUXPdPY&bpQDv}Hjt9{?boEGOP6fK zC8|rye|m3`MB`A7GRgRU@|gIkpvTSG;(=06N$?Ii2A> zC`lS=Zz4OuCS+1jF=fwNUl$i9Dt>LJ)gfo^>}&#M$+XYpIl)h##^V!n_Hxcv@bh;m zzt$SvpLUFka{s7VU& z%>k>C=2do`d9$=47BlVd8Fp17vYj@(&x$V#`nnG-o_&c9k^Py6x~+lSx#!_c(61k z4sl59xi|N3jXrbEG$)+1>`e9@AOBh7K+O03fEj^ZW0L{x_ZcJ1{+Zo4ivXi$&L9S3 zhSe{hsbu)`Bj;=CvOfCwX zDC`-!vjrY2=0_7QqmD^PRCCZGAwmDB&4PUUK)8~Jle49NePdyvS&kT%4JqSD9JLY^ zRHCb^b*ZW~JYCmz!&li<0F`gu&LFvY@}<|o*S3|!GilYfz3ehFPY%bkzh6;{(#OLE zfiEUVlyzt{o(WGltvw2?TiZJ)#Ez7X7OpI~X44w30hMVBs}GSR7%|6%-W!x0*d3LL zp5^i@y(T(`sP+AMLqhL;&M=sf^PX|4zKrsq9I+}JO5#u;tdy%$JiVZ9o)esx=kz<9 zROAr9O|+Ar&8!6b$k0fVi^IWm2hyaI^r^9ONH|OR(&TBuUwNkewhU7G!Rp3f1)Z4V zMRKo$pIg88P|uyMa=!&-_boxI_To!#45_JY#hwH{Q}vB4YTD!;Ikogt$KkHDdheyF z(TOJ(E88na^nGW#m|4osU*DIZq{*_zjT-rrFJ6BYEdR2wgzq67O$b@KiYE=t4A>U8 zTKRvXHM=Wzc3)wIaxaD5CmGnNHl;j`^@acM1oSWe^w-4~=}^6E@ezVV1w2?gcTKE) zxMD(5ymG)Xjf(Sv#`EJC|Dpi!H_W)0S-*C91im&EHW)4KhEvO~k5)e{D^mdT@V$1+ z-D@|3po`lvJFqS#C9GpIO~I;%ohTt6KF}DTo%=TZkD}q9+)fr(#eZu*t*E&QB z)7@D;Fv%h!ao69Y;DAzhrE^P8a9_I>bsDY#Oeyf31(5C4Z>Mat>U zj#OPrJ4X#0$n8^N+xHDRiAoy~B|LK`?FH!8C~OizfK#ZNV9R`k9}b`_I*eT%NfcV2 z-R0Q*Z~(`WrM)Q^UK8QrxRmTdhQigs$HruMPG-Fa|Gpr(V7Th{e}AvojC`H>|D6NC zxqm0`kwgUyN#gaKL73v;;Edp+aB*<58KGtk|Csc{)g67jO({gV2>--Ul2^a{Sk5%y Fe*vgP8^izr