/** Ċ Ġ* Ġ< s late _ header > Ċ Ġ* Ġurl : Ġwww . s late kit . com Ċ Ġ* Ġgit : Ġwww . github . com / code - helix / s late kit Ċ Ġ* Ġorg : Ġwww . code helix . co Ċ Ġ* Ġauthor : ĠK ish ore ĠRed dy Ċ Ġ* Ġcopyright : Ġ 2 0 1 6 ĠCode Hel ix ĠSolutions ĠInc . Ċ Ġ* Ġlicense : Ġrefer Ġto Ġwebsite Ġand / or Ġgithub Ċ Ġ* Ġabout : ĠA Ġtool - kit , Ġutility Ġlibrary Ġand Ġserver - backend Ċ Ġ* Ġman tra : ĠSimp licity Ġabove Ġall Ġelse Ċ Ġ* Ġ</ s late _ header > Ċ Ġ*/ Ċ Ċ package Ġs late kit . common . types Ċ Ċ import Ġs late kit . common . Smart String Ċ Ċ /** Ċ Ġ* ĠSmart ĠString Ġfor ĠSocial Ġsecurity Ġnumber Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠNOTE : ĠThis Ġshould Ġbe Ġused Ġs paring ly Ġat Ġthe Ġ" boundary " Ġor Ġ" entry - point " Ċ Ġ* Ġof Ġan Ġapplication Ġand / or Ġfunction . ĠSuch Ġas Ġ: Ċ Ġ* Ċ Ġ* Ġ 1 . ĠAPI Ġendpoints Ġ( Ġto Ġvalidate Ġsimple Ġparameters Ġcoming Ġin Ġ) Ċ Ġ* Ġ 2 . ĠDeserial ization Ġof Ġa Ġsingle Ġvalue Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠUSE S : Ċ Ġ* ĠThis Ġis Ġused Ġin ĠS late ĠKit Ġto Ġ: Ċ Ġ* Ġ 1 . ĠAuto - validate Ġparameters Ġfor ĠAPIs Ġon Ġthe ĠCLI Ġ( command - line ) Ċ Ġ* Ġ 2 . ĠAuto - validate Ġparameters Ġfor ĠAPIs Ġon Ġthe ĠWeb Ġ( HTTP ĠEnd points ) Ċ Ġ* Ġ 3 . ĠReplace Ġstrings Ġparameters Ġfor Ġfunctions Ġat Ġthe Ġboundary / entry - points Ġfor Ġan Ġapp / feature . Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠWARNING : Ċ Ġ* ĠWhile Ġconvenient , Ġthis Ġis Ġa Ġ" heavy " ĠString Ġreplacement . Ċ Ġ* ĠDo Ġnot Ġuse Ġas Ġa Ġreplacement Ġfor Ġstrings Ġin Ġgeneral Ġand Ċ Ġ* Ġespecially Ġas Ġa Ġproperty Ġfor Ġsmall Ġobjects Ċ Ġ*/ Ċ class ĠS SN ( text : ĠString , Ġrequired : ĠBoolean Ġ= Ġtrue ) Ġ: ĠSmart String ( text , Ġrequired , Ġ 9 , Ġ 1 1 , ĊĠĠĠĠĠĠĠ ĠlistOf (""" \ d { 9 } """, ĊĠĠĠĠĠĠĠĠĠĠĠĠĠĠĠ Ġ""" \ d { 3 } [- ] ?\ d { 2 } [- ] ?\ d { 4 } """ ĊĠĠĠĠĠĠĠ Ġ)) Ġ{ ĊĠĠĠ Ġoverride Ġval Ġname Ġ= Ġ" SS N " ĊĠĠĠ Ġoverride Ġval Ġdesc Ġ= Ġ" Social ĠSecurity ĠNumber " ĊĠĠĠ Ġoverride Ġval Ġexamples Ġ= ĠlistOf (" 1 2 3 4 5 6 7 8 9 ", Ġ" 1 2 3 - 4 5 - 6 7 8 9 ") ĊĠĠĠ Ġoverride Ġval Ġformats Ġ= ĠlistOf (" xxxxxxxx x ", Ġ" xxx - xx - xxxx ") ĊĊĠĠĠ Ġfun Ġis D ashed (): ĠBoolean Ġ= Ġ! text . isNull OrEmpty () Ġ&& Ġtext . contains ("- ") Ċ }