/* Ċ Ġ* ĠCopyright Ġ( C ) Ġ 2 0 0 7 ĠThe ĠGu ava ĠAuthors Ċ Ġ* Ċ Ġ* ĠLicensed Ġunder Ġthe ĠApache ĠLicense , ĠVersion Ġ 2 . 0 Ġ( the Ġ" License "); Ġyou Ġmay Ġnot Ġuse Ġthis Ġfile Ġexcept Ċ Ġ* Ġin Ġcompliance Ġwith Ġthe ĠLicense . ĠYou Ġmay Ġobtain Ġa Ġcopy Ġof Ġthe ĠLicense Ġat Ċ Ġ* Ċ Ġ* Ġhttp :// www . apache . org / licenses / LICENSE - 2 . 0 Ċ Ġ* Ċ Ġ* ĠUnless Ġrequired Ġby Ġapplicable Ġlaw Ġor Ġagreed Ġto Ġin Ġwriting , Ġsoftware Ġdistributed Ġunder Ġthe ĠLicense Ċ Ġ* Ġis Ġdistributed Ġon Ġan Ġ" AS ĠIS " ĠBASIS , ĠWITHOUT ĠWARRANTIES ĠOR ĠCONDITIONS ĠOF ĠANY ĠKIND , Ġeither Ġexpress Ċ Ġ* Ġor Ġimplied . ĠSee Ġthe ĠLicense Ġfor Ġthe Ġspecific Ġlanguage Ġgoverning Ġpermissions Ġand Ġlimitations Ġunder Ċ Ġ* Ġthe ĠLicense . Ċ Ġ*/ Ċ Ċ package Ġcom . google . common . base Ċ Ċ import Ġcom . google . common . annotations . G wt Compatible ĊĊ Ċ /** Ċ Ġ* ĠStatic Ġconvenience Ġmethods Ġthat Ġhelp Ġa Ġmethod Ġor Ġconstructor Ġcheck Ġwhether Ġit Ġwas Ġinvoked Ċ Ġ* Ġcorrectly Ġ( that Ġis , Ġwhether Ġits Ġ* pre conditions * Ġwere Ġmet ). Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠIf Ġthe Ġpre condition Ġis Ġnot Ġmet , Ġthe Ġ` Preconditions ` Ġmethod Ġthrows Ġan Ġunchecked Ġexception Ċ Ġ* Ġof Ġa Ġspecified Ġtype , Ġwhich Ġhelps Ġthe Ġmethod Ġin Ġwhich Ġthe Ġexception Ġwas Ġthrown Ġcommunicate Ġthat Ċ Ġ* Ġits Ġcaller Ġhas Ġmade Ġa Ġmistake . ĠThis Ġallows Ġconstructs Ġsuch Ġas Ċ Ġ* Ċ Ġ* Ġ< pre >` public Ġstatic Ġdouble Ġsqrt ( double Ġvalue ) Ġ{ Ċ Ġ* Ġif Ġ( value Ġ< Ġ 0 ) Ġ{ Ċ Ġ* Ġthrow Ġnew ĠIllegalArgumentException (" input Ġis Ġnegative : Ġ" Ġ+ Ġvalue ); Ċ Ġ* Ġ} Ċ Ġ* Ġ// Ġcalculate Ġsquare Ġroot Ċ Ġ* Ġ} Ċ ` </ pre > Ġ* Ċ Ġ* Ċ Ġ* Ċ Ġ* Ġto Ġbe Ġreplaced Ġwith Ġthe Ġmore Ġcompact Ċ Ġ* Ċ Ġ* Ġ< pre >` public Ġstatic Ġdouble Ġsqrt ( double Ġvalue ) Ġ{ Ċ Ġ* Ġcheck Argument ( value Ġ>= Ġ 0 , Ġ" input Ġis Ġnegative : Ġ% s ", Ġvalue ); Ċ Ġ* Ġ// Ġcalculate Ġsquare Ġroot Ċ Ġ* Ġ} Ċ ` </ pre > Ġ* Ċ Ġ* Ċ Ġ* Ċ Ġ* Ġso Ġthat Ġa Ġh ypot het ical Ġbad Ġcaller Ġof Ġthis Ġmethod , Ġsuch Ġas : Ċ Ġ* Ċ Ġ* Ġ< pre >` void Ġexample Bad Caller () Ġ{ Ċ Ġ* Ġdouble Ġd Ġ= Ġsqrt (- 1 . 0 ); Ċ Ġ* Ġ} Ċ ` </ pre > Ġ* Ċ Ġ* Ċ Ġ* Ċ Ġ* Ġwould Ġbe Ġflag ged Ġas Ġhaving Ġcalled Ġ` sqrt ()` Ġwith Ġan Ġillegal Ġargument . Ċ Ġ* Ċ Ġ* Ġ< h 3 > Performance </ h 3 > Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠAvoid Ġpassing Ġmessage Ġarguments Ġthat Ġare Ġexpensive Ġto Ġcompute ; Ġyour Ġcode Ġwill Ġalways Ġcompute Ċ Ġ* Ġthem , Ġeven Ġthough Ġthey Ġusually Ġwon 't Ġbe Ġneeded . ĠIf Ġyou Ġhave Ġsuch Ġarguments , Ġuse Ġthe Ġconvention al Ċ Ġ* Ġif / throw Ġid iom Ġinstead . Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠDep ending Ġon Ġyour Ġmessage Ġarguments , Ġmemory Ġmay Ġbe Ġallocated Ġfor Ġbox ing Ġand Ġvar args Ġarray Ċ Ġ* Ġcreation . ĠHowever , Ġthe Ġmethods Ġof Ġthis Ġclass Ġhave Ġa Ġlarge Ġnumber Ġof Ġover loads Ġthat Ġprevent Ġsuch Ċ Ġ* Ġallocations Ġin Ġmany Ġcommon Ġcases . Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠThe Ġmessage Ġstring Ġis Ġnot Ġformatted Ġunless Ġthe Ġexception Ġwill Ġbe Ġthrown , Ġso Ġthe Ġcost Ġof Ġthe Ċ Ġ* Ġstring Ġformatting Ġitself Ġshould Ġnot Ġbe Ġa Ġconcern . Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠAs Ġwith Ġany Ġperformance Ġconcerns , Ġyou Ġshould Ġconsider Ġprofiling Ġyour Ġcode Ġ( in Ġa Ġproduction Ċ Ġ* Ġenvironment Ġif Ġpossible ) Ġbefore Ġs pending Ġa Ġlot Ġof Ġeffort Ġon Ġt we aking Ġa Ġparticular Ġelement . Ċ Ġ* Ċ Ġ* Ġ< h 3 > Other Ġtypes Ġof Ġpre conditions </ h 3 > Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠNot Ġevery Ġtype Ġof Ġpre condition Ġfailure Ġis Ġsupported Ġby Ġthese Ġmethods . ĠContinue Ġto Ġthrow Ċ Ġ* Ġstandard ĠJDK Ġexceptions Ġsuch Ġas Ġ[ java . util . NoSuch ElementException ] Ġor Ġ[ Ġ] Ġin Ġthe Ġsituations Ġthey Ġare Ġintended Ġfor . Ċ Ġ* Ċ Ġ* Ġ< h 3 > Non - pre conditions </ h 3 > Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠIt Ġis Ġof Ġcourse Ġpossible Ġto Ġuse Ġthe Ġmethods Ġof Ġthis Ġclass Ġto Ġcheck Ġfor Ġinvalid Ġconditions Ċ Ġ* Ġwhich Ġare Ġ* not Ġthe Ġcaller 's Ġfault *. ĠDo ing Ġso Ġis Ġ** not Ġrecommended ** Ġbecause Ġit Ġis Ċ Ġ* Ġmis leading Ġto Ġfuture Ġreaders Ġof Ġthe Ġcode Ġand Ġof Ġstack Ġtraces . ĠSee Ġ[ Conditional Ġfailures Ċ Ġ* Ġexplained ]( https :// github . com / google / gu ava / wiki / Conditional Failures Explain ed ) Ġin Ġthe ĠGu ava ĠUser ĠGuide Ġfor Ġmore Ġadvice . ĠNot ably , Ġ[ Verify ] Ġoffers Ġassertions Ċ Ġ* Ġsimilar Ġto Ġthose Ġin Ġthis Ġclass Ġfor Ġnon - pre condition Ġchecks . Ċ Ġ* Ċ Ġ* Ġ< h 3 >` java . util . Objects . requireNonNull ()` </ h 3 > Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠProjects Ġwhich Ġuse Ġ` com . google . common ` Ġshould Ġgenerally Ġavoid Ġthe Ġuse Ġof Ġ[ Ġ][ java . util . Objects . requireNonNull ]. ĠInstead , Ġuse Ġwh iche ver Ġof Ġ[ Ġ][ . checkNotNull ] Ġor Ġ[ Verify . verify NotNull ] Ġis Ġappropriate Ġto Ġthe Ġsituation . Ċ Ġ* Ġ( The Ġsame Ġgoes Ġfor Ġthe Ġmessage - accept ing Ġover loads .) Ċ Ġ* Ċ Ġ* Ġ< h 3 > Only Ġ`% s ` Ġis Ġsupported </ h 3 > Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠIn Ġ` Preconditions ` Ġerror Ġmessage Ġtemplate Ġstrings , Ġonly Ġthe Ġ`" % s "` Ġspec ifier Ġis Ċ Ġ* Ġsupported , Ġnot Ġthe Ġfull Ġrange Ġof Ġ[ java . util . Formatter ] Ġspec ifiers . Ċ Ġ* Ċ Ġ* Ġ< h 3 > More Ġinformation </ h 3 > Ċ Ġ* Ċ Ġ* Ċ Ġ* ĠSee Ġthe ĠGu ava ĠUser ĠGuide Ġon Ġ[ using Ġ` Preconditions `]( https :// github . com / google / gu ava / wiki / Preconditions Explain ed ). Ċ Ġ* Ċ Ġ* Ġ@ author ĠKevin ĠB our r illion Ċ Ġ* Ġ@ since Ġ 2 . 0 Ċ Ġ*/ Ċ @ G wt Compatible Ċ object ĠPreconditions Ġ{ ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġexpression Ġa Ġboolean Ġexpression ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalArgumentException Ġif Ġ` expression ` Ġis Ġfalse ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( expression : ĠBoolean ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! expression ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException () ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġexpression Ġa Ġboolean Ġexpression ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Ġthe Ġexception Ġmessage Ġto Ġuse Ġif Ġthe Ġcheck Ġfails ; Ġwill Ġbe Ġconverted Ġto Ġa ĊĠĠĠĠ Ġ* Ġstring Ġusing Ġ[ String . valueOf ] ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalArgumentException Ġif Ġ` expression ` Ġis Ġfalse ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( expression : ĠBoolean , ĠerrorMessage : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! expression ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( errorMessage . toString ()) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġexpression Ġa Ġboolean Ġexpression ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Template Ġa Ġtemplate Ġfor Ġthe Ġexception Ġmessage Ġshould Ġthe Ġcheck Ġfail . ĠThe ĊĠĠĠĠ Ġ* Ġmessage Ġis Ġformed Ġby Ġreplacing Ġeach Ġ`% s ` Ġplaceholder Ġin Ġthe Ġtemplate Ġwith Ġan ĊĠĠĠĠ Ġ* Ġargument . ĠThese Ġare Ġmatched Ġby Ġposition Ġ- Ġthe Ġfirst Ġ`% s ` Ġgets Ġ` errorMessage Args [ 0 ] `, Ġetc . ĠUn matched Ġarguments Ġwill Ġbe Ġappended Ġto Ġthe Ġformatted Ġmessage Ġin ĊĠĠĠĠ Ġ* Ġsquare Ġbr aces . ĠUn matched Ġplaceholders Ġwill Ġbe Ġleft Ġas - is . ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Args Ġthe Ġarguments Ġto Ġbe Ġsubstit uted Ġinto Ġthe Ġmessage Ġtemplate . ĠArguments ĊĠĠĠĠ Ġ* Ġare Ġconverted Ġto Ġstrings Ġusing Ġ[ String . valueOf ]. ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalArgumentException Ġif Ġ` expression ` Ġis Ġfalse ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġexpression : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġvar arg ĠerrorMessage Args : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! expression ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġ* errorMessage Args )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( b : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( b : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( b : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 3 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 , Ġp 3 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġone Ġor Ġmore Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[ check Argument ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Argument ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 3 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 4 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException ( format ( errorMessage Template , Ġp 1 , Ġp 2 , Ġp 3 , Ġp 4 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġexpression Ġa Ġboolean Ġexpression ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalStateException Ġif Ġ` expression ` Ġis Ġfalse ĊĠĠĠĠ Ġ* Ġ@ see ĠVerify . verify ĠVerify . verify ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( expression : ĠBoolean ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! expression ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException () ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġexpression Ġa Ġboolean Ġexpression ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Ġthe Ġexception Ġmessage Ġto Ġuse Ġif Ġthe Ġcheck Ġfails ; Ġwill Ġbe Ġconverted Ġto Ġa ĊĠĠĠĠ Ġ* Ġstring Ġusing Ġ[ String . valueOf ] ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalStateException Ġif Ġ` expression ` Ġis Ġfalse ĊĠĠĠĠ Ġ* Ġ@ see ĠVerify . verify ĠVerify . verify ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( expression : ĠBoolean , ĠerrorMessage : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! expression ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( errorMessage . toString ()) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġexpression Ġa Ġboolean Ġexpression ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Template Ġa Ġtemplate Ġfor Ġthe Ġexception Ġmessage Ġshould Ġthe Ġcheck Ġfail . ĠThe ĊĠĠĠĠ Ġ* Ġmessage Ġis Ġformed Ġby Ġreplacing Ġeach Ġ`% s ` Ġplaceholder Ġin Ġthe Ġtemplate Ġwith Ġan ĊĠĠĠĠ Ġ* Ġargument . ĠThese Ġare Ġmatched Ġby Ġposition Ġ- Ġthe Ġfirst Ġ`% s ` Ġgets Ġ` errorMessage Args [ 0 ] `, Ġetc . ĠUn matched Ġarguments Ġwill Ġbe Ġappended Ġto Ġthe Ġformatted Ġmessage Ġin ĊĠĠĠĠ Ġ* Ġsquare Ġbr aces . ĠUn matched Ġplaceholders Ġwill Ġbe Ġleft Ġas - is . ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Args Ġthe Ġarguments Ġto Ġbe Ġsubstit uted Ġinto Ġthe Ġmessage Ġtemplate . ĠArguments ĊĠĠĠĠ Ġ* Ġare Ġconverted Ġto Ġstrings Ġusing Ġ[ String . valueOf ]. ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalStateException Ġif Ġ` expression ` Ġis Ġfalse ĊĠĠĠĠ Ġ* Ġ@ see ĠVerify . verify ĠVerify . verify ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġexpression : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġvar arg ĠerrorMessage Args : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! expression ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġ* errorMessage Args )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( b : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( b : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( b : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠChar ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠLong ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 3 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 , Ġp 3 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthe Ġtruth Ġof Ġan Ġexpression Ġinvol ving Ġthe Ġstate Ġof Ġthe Ġcalling Ġinstance , Ġbut Ġnot ĊĠĠĠĠ Ġ* Ġinvol ving Ġany Ġparameters Ġto Ġthe Ġcalling Ġmethod . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. check State ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck State ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġb : ĠBoolean , ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 3 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 4 : ĠAny ) Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ(! b ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalStateException ( format ( errorMessage Template , Ġp 1 , Ġp 2 , Ġp 3 , Ġp 4 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġreference Ġan Ġobject Ġreference ĊĠĠĠĠ Ġ* Ġ@ return Ġthe Ġnon - null Ġreference Ġthat Ġwas Ġvalidated ĊĠĠĠĠ Ġ* Ġ@ throws ĠNullPointerException Ġif Ġ` reference ` Ġis Ġnull ĊĠĠĠĠ Ġ* Ġ@ see ĠVerify . verify NotNull ĠVerify . verify NotNull ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġinline Ġfun Ġ< T > ĠcheckNotNull ( reference : ĠT ?): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( reference Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException () ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġreference ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġreference Ġan Ġobject Ġreference ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Ġthe Ġexception Ġmessage Ġto Ġuse Ġif Ġthe Ġcheck Ġfails ; Ġwill Ġbe Ġconverted Ġto Ġa ĊĠĠĠĠ Ġ* Ġstring Ġusing Ġ[ String . valueOf ] ĊĠĠĠĠ Ġ* Ġ@ return Ġthe Ġnon - null Ġreference Ġthat Ġwas Ġvalidated ĊĠĠĠĠ Ġ* Ġ@ throws ĠNullPointerException Ġif Ġ` reference ` Ġis Ġnull ĊĠĠĠĠ Ġ* Ġ@ see ĠVerify . verify NotNull ĠVerify . verify NotNull ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( reference : ĠT ?, ĠerrorMessage : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( reference Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( errorMessage . toString ()) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġreference ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġreference Ġan Ġobject Ġreference ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Template Ġa Ġtemplate Ġfor Ġthe Ġexception Ġmessage Ġshould Ġthe Ġcheck Ġfail . ĠThe ĊĠĠĠĠ Ġ* Ġmessage Ġis Ġformed Ġby Ġreplacing Ġeach Ġ`% s ` Ġplaceholder Ġin Ġthe Ġtemplate Ġwith Ġan ĊĠĠĠĠ Ġ* Ġargument . ĠThese Ġare Ġmatched Ġby Ġposition Ġ- Ġthe Ġfirst Ġ`% s ` Ġgets Ġ` errorMessage Args [ 0 ] `, Ġetc . ĠUn matched Ġarguments Ġwill Ġbe Ġappended Ġto Ġthe Ġformatted Ġmessage Ġin ĊĠĠĠĠ Ġ* Ġsquare Ġbr aces . ĠUn matched Ġplaceholders Ġwill Ġbe Ġleft Ġas - is . ĊĠĠĠĠ Ġ* Ġ@ param ĠerrorMessage Args Ġthe Ġarguments Ġto Ġbe Ġsubstit uted Ġinto Ġthe Ġmessage Ġtemplate . ĠArguments ĊĠĠĠĠ Ġ* Ġare Ġconverted Ġto Ġstrings Ġusing Ġ[ String . valueOf ]. ĊĠĠĠĠ Ġ* Ġ@ return Ġthe Ġnon - null Ġreference Ġthat Ġwas Ġvalidated ĊĠĠĠĠ Ġ* Ġ@ throws ĠNullPointerException Ġif Ġ` reference ` Ġis Ġnull ĊĠĠĠĠ Ġ* Ġ@ see ĠVerify . verify NotNull ĠVerify . verify NotNull ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġreference : ĠT ?, ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġvar arg ĠerrorMessage Args : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( reference Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġ* errorMessage Args )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġreference ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( obj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( obj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( obj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠChar ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠInt ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠLong ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠChar , Ġp 2 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠChar ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠInt ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠLong ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠInt , Ġp 2 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠChar ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠInt ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠLong ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠLong , Ġp 2 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠChar ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠInt ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĠerrorMessage Template : ĠString , Ġp 1 : ĠAny , Ġp 2 : ĠLong ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 3 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 , Ġp 3 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġan Ġobject Ġreference Ġpassed Ġas Ġa Ġparameter Ġto Ġthe Ġcalling Ġmethod Ġis Ġnot Ġnull . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠSee Ġ[. checkNotNull ] Ġfor Ġdetails . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ since Ġ 2 0 . 0 Ġ( var args Ġoverload Ġsince Ġ 2 . 0 ) ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġfun Ġ< T > ĠcheckNotNull ( ĊĠĠĠĠĠĠĠĠĠĠĠ Ġobj : ĠT ?, ĊĠĠĠĠĠĠĠĠĠĠĠ ĠerrorMessage Template : ĠString , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 1 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 2 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 3 : ĠAny , ĊĠĠĠĠĠĠĠĠĠĠĠ Ġp 4 : ĠAny ): ĠT Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( obj Ġ== Ġnull ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠNullPointerException ( format ( errorMessage Template , Ġp 1 , Ġp 2 , Ġp 3 , Ġp 4 )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġobj ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/* ĊĠĠ Ġ* ĠAll Ġrecent Ġhot spot s Ġ( as Ġof Ġ 2 0 0 9 ) Ġ* really * Ġlike Ġto Ġhave Ġthe Ġnatural Ġcode ĊĠĠ Ġ* ĊĠĠ Ġ* Ġif Ġ( guard Expression ) Ġ{ ĊĠĠ Ġ* ĠĠĠ Ġthrow Ġnew ĠBad Exception ( message Expression ); ĊĠĠ Ġ* Ġ} ĊĠĠ Ġ* ĊĠĠ Ġ* Ġref actored Ġso Ġthat Ġmessage Expression Ġis Ġmoved Ġto Ġa Ġseparate ĠString - return ing Ġmethod . ĊĠĠ Ġ* ĊĠĠ Ġ* Ġif Ġ( guard Expression ) Ġ{ ĊĠĠ Ġ* ĠĠĠ Ġthrow Ġnew ĠBad Exception ( bad Msg (... )); ĊĠĠ Ġ* Ġ} ĊĠĠ Ġ* ĊĠĠ Ġ* ĠThe Ġalternative Ġnatural Ġrefactor ings Ġinto Ġvoid Ġor ĠException - return ing Ġmethods Ġare Ġmuch Ġslower . ĊĠĠ Ġ* ĠThis Ġis Ġa Ġbig Ġdeal Ġ- Ġwe 're Ġtalking Ġfactors Ġof Ġ 2 - 8 Ġin Ġmicro benchmarks , Ġnot Ġjust Ġ 1 0 - 2 0 %. Ġ( This Ġis ĊĠĠ Ġ* Ġa Ġhot spot Ġoptimizer Ġbug , Ġwhich Ġshould Ġbe Ġfixed , Ġbut Ġthat 's Ġa Ġseparate , Ġbig Ġproject ). ĊĠĠ Ġ* ĊĠĠ Ġ* ĠThe Ġcoding Ġpattern Ġabove Ġis Ġheav ily Ġused Ġin Ġjava . util , Ġe . g . Ġin ĠArrayList . ĠThere Ġis Ġa ĊĠĠ Ġ* ĠRange Check Micro Benchmark Ġin Ġthe ĠJDK Ġthat Ġwas Ġused Ġto Ġtest Ġthis . ĊĠĠ Ġ* ĊĠĠ Ġ* ĠBut Ġthe Ġmethods Ġin Ġthis Ġclass Ġwant Ġto Ġthrow Ġdifferent Ġexceptions , Ġdepending Ġon Ġthe Ġargs , Ġso Ġit ĊĠĠ Ġ* Ġappears Ġthat Ġthis Ġpattern Ġis Ġnot Ġdirectly Ġapplicable . ĠBut Ġwe Ġcan Ġuse Ġthe Ġrid iculo us , Ġde vious ĊĠĠ Ġ* Ġtrick Ġof Ġthrowing Ġan Ġexception Ġin Ġthe Ġmiddle Ġof Ġthe Ġconstruction Ġof Ġanother Ġexception . ĠHot spot ĊĠĠ Ġ* Ġis Ġfine Ġwith Ġthat . ĊĠĠ Ġ*/ ĊĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġ` index ` Ġspecifies Ġa Ġvalid Ġ* element * Ġin Ġan Ġarray , Ġlist Ġor Ġstring Ġof Ġsize ĊĠĠĠĠ Ġ* Ġ` size `. ĠAn Ġelement Ġindex Ġmay Ġrange Ġfrom Ġzero , Ġinclusive , Ġto Ġ` size `, Ġexclusive . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġindex Ġa Ġuser - supp lied Ġindex Ġidentifying Ġan Ġelement Ġof Ġan Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ param Ġsize Ġthe Ġsize Ġof Ġthat Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ param Ġdesc Ġthe Ġtext Ġto Ġuse Ġto Ġdescribe Ġthis Ġindex Ġin Ġan Ġerror Ġmessage ĊĠĠĠĠ Ġ* Ġ@ return Ġthe Ġvalue Ġof Ġ` index ` ĊĠĠĠĠ Ġ* Ġ@ throws ĠIndex OutOfBoundsException Ġif Ġ` index ` Ġis Ġnegative Ġor Ġis Ġnot Ġless Ġthan Ġ` size ` ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalArgumentException Ġif Ġ` size ` Ġis Ġnegative ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġ@ Jvm Over loads ĊĠĠĠ Ġfun Ġcheck Element Index ( index : ĠInt , Ġsize : ĠInt , Ġdesc : ĠString Ġ= Ġ" index "): ĠInt Ġ{ ĊĠĠĠĠĠĠĠ Ġ// ĠCare fully Ġoptimized Ġfor Ġexecution Ġby Ġhot spot Ġ( ex plan atory Ġcomment Ġabove ) ĊĠĠĠĠĠĠĠ Ġif Ġ( index Ġ< Ġ 0 Ġ|| Ġindex Ġ>= Ġsize ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIndex OutOfBoundsException ( bad Element Index ( index , Ġsize , Ġdesc )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġindex ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġprivate Ġfun Ġbad Element Index ( index : ĠInt , Ġsize : ĠInt , Ġdesc : ĠString ): ĠString Ġ{ ĊĠĠĠĠĠĠĠ Ġreturn Ġif Ġ( index Ġ< Ġ 0 ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġformat ("% s Ġ(% s ) Ġmust Ġnot Ġbe Ġnegative ", Ġdesc , Ġindex ) ĊĠĠĠĠĠĠĠ Ġ} Ġelse Ġif Ġ( size Ġ< Ġ 0 ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException (" negative Ġsize : Ġ$ size ") ĊĠĠĠĠĠĠĠ Ġ} Ġelse Ġ{ Ġ// Ġindex Ġ>= Ġsize ĊĠĠĠĠĠĠĠĠĠĠĠ Ġformat ("% s Ġ(% s ) Ġmust Ġbe Ġless Ġthan Ġsize Ġ(% s )", Ġdesc , Ġindex , Ġsize ) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġ` index ` Ġspecifies Ġa Ġvalid Ġ* position * Ġin Ġan Ġarray , Ġlist Ġor Ġstring Ġof ĊĠĠĠĠ Ġ* Ġsize Ġ` size `. ĠA Ġposition Ġindex Ġmay Ġrange Ġfrom Ġzero Ġto Ġ` size `, Ġinclusive . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġindex Ġa Ġuser - supp lied Ġindex Ġidentifying Ġa Ġposition Ġin Ġan Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ param Ġsize Ġthe Ġsize Ġof Ġthat Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ param Ġdesc Ġthe Ġtext Ġto Ġuse Ġto Ġdescribe Ġthis Ġindex Ġin Ġan Ġerror Ġmessage ĊĠĠĠĠ Ġ* Ġ@ return Ġthe Ġvalue Ġof Ġ` index ` ĊĠĠĠĠ Ġ* Ġ@ throws ĠIndex OutOfBoundsException Ġif Ġ` index ` Ġis Ġnegative Ġor Ġis Ġgreater Ġthan Ġ` size ` ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalArgumentException Ġif Ġ` size ` Ġis Ġnegative ĊĠĠĠĠ Ġ*/ ĊĊĠĠĠ Ġ@ Jvm Over loads ĊĠĠĠ Ġfun Ġcheck Position Index ( index : ĠInt , Ġsize : ĠInt , Ġdesc : ĠString Ġ= Ġ" index "): ĠInt Ġ{ ĊĠĠĠĠĠĠĠ Ġ// ĠCare fully Ġoptimized Ġfor Ġexecution Ġby Ġhot spot Ġ( ex plan atory Ġcomment Ġabove ) ĊĠĠĠĠĠĠĠ Ġif Ġ( index Ġ< Ġ 0 Ġ|| Ġindex Ġ> Ġsize ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIndex OutOfBoundsException ( bad Position Index ( index , Ġsize , Ġdesc )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġindex ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġprivate Ġfun Ġbad Position Index ( index : ĠInt , Ġsize : ĠInt , Ġdesc : ĠString ): ĠString Ġ{ ĊĠĠĠĠĠĠĠ Ġreturn Ġif Ġ( index Ġ< Ġ 0 ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġformat ("% s Ġ(% s ) Ġmust Ġnot Ġbe Ġnegative ", Ġdesc , Ġindex ) ĊĠĠĠĠĠĠĠ Ġ} Ġelse Ġif Ġ( size Ġ< Ġ 0 ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIllegalArgumentException (" negative Ġsize : Ġ$ size ") ĊĠĠĠĠĠĠĠ Ġ} Ġelse Ġ{ Ġ// Ġindex Ġ> Ġsize ĊĠĠĠĠĠĠĠĠĠĠĠ Ġformat ("% s Ġ(% s ) Ġmust Ġnot Ġbe Ġgreater Ġthan Ġsize Ġ(% s )", Ġdesc , Ġindex , Ġsize ) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠEns ures Ġthat Ġ` start ` Ġand Ġ` end ` Ġspecify Ġa Ġvalid Ġ* positions * Ġin Ġan Ġarray , Ġlist ĊĠĠĠĠ Ġ* Ġor Ġstring Ġof Ġsize Ġ` size `, Ġand Ġare Ġin Ġorder . ĠA Ġposition Ġindex Ġmay Ġrange Ġfrom Ġzero Ġto ĊĠĠĠĠ Ġ* Ġ` size `, Ġinclusive . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġstart Ġa Ġuser - supp lied Ġindex Ġidentifying Ġa Ġstarting Ġposition Ġin Ġan Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ param Ġend Ġa Ġuser - supp lied Ġindex Ġidentifying Ġa Ġending Ġposition Ġin Ġan Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ param Ġsize Ġthe Ġsize Ġof Ġthat Ġarray , Ġlist Ġor Ġstring ĊĠĠĠĠ Ġ* Ġ@ throws ĠIndex OutOfBoundsException Ġif Ġeither Ġindex Ġis Ġnegative Ġor Ġis Ġgreater Ġthan Ġ` size `, ĊĠĠĠĠ Ġ* Ġor Ġif Ġ` end ` Ġis Ġless Ġthan Ġ` start ` ĊĠĠĠĠ Ġ* Ġ@ throws ĠIllegalArgumentException Ġif Ġ` size ` Ġis Ġnegative ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġcheck Position Indexes ( start : ĠInt , Ġend : ĠInt , Ġsize : ĠInt ) Ġ{ ĊĠĠĠĠĠĠĠ Ġ// ĠCare fully Ġoptimized Ġfor Ġexecution Ġby Ġhot spot Ġ( ex plan atory Ġcomment Ġabove ) ĊĠĠĠĠĠĠĠ Ġif Ġ( start Ġ< Ġ 0 Ġ|| Ġend Ġ< Ġstart Ġ|| Ġend Ġ> Ġsize ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġthrow ĠIndex OutOfBoundsException ( bad Position Indexes ( start , Ġend , Ġsize )) ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġprivate Ġfun Ġbad Position Indexes ( start : ĠInt , Ġend : ĠInt , Ġsize : ĠInt ): ĠString Ġ{ ĊĠĠĠĠĠĠĠ Ġif Ġ( start Ġ< Ġ 0 Ġ|| Ġstart Ġ> Ġsize ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġreturn Ġbad Position Index ( start , Ġsize , Ġ" start Ġindex ") ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġreturn Ġif Ġ( end Ġ< Ġ 0 Ġ|| Ġend Ġ> Ġsize ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġbad Position Index ( end , Ġsize , Ġ" end Ġindex ") ĊĠĠĠĠĠĠĠ Ġ} Ġelse Ġformat (" end Ġindex Ġ(% s ) Ġmust Ġnot Ġbe Ġless Ġthan Ġstart Ġindex Ġ(% s )", Ġend , Ġstart ) ĊĠĠĠĠĠĠĠ Ġ// Ġend Ġ< Ġstart ĊĠĠĠ Ġ} ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠSubst it utes Ġeach Ġ`% s ` Ġin Ġ` template ` Ġwith Ġan Ġargument . ĠThese Ġare Ġmatched Ġby ĊĠĠĠĠ Ġ* Ġposition : Ġthe Ġfirst Ġ`% s ` Ġgets Ġ` args [ 0 ] `, Ġetc . ĠIf Ġthere Ġare Ġmore Ġarguments Ġthan ĊĠĠĠĠ Ġ* Ġplaceholders , Ġthe Ġun matched Ġarguments Ġwill Ġbe Ġappended Ġto Ġthe Ġend Ġof Ġthe Ġformatted Ġmessage Ġin ĊĠĠĠĠ Ġ* Ġsquare Ġbr aces . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġtemplate Ġa Ġstring Ġcontaining Ġ 0 Ġor Ġmore Ġ`% s ` Ġplaceholders . Ġnull Ġis Ġtreated Ġas ĊĠĠĠĠ Ġ* Ġ" null ". ĊĠĠĠĠ Ġ* Ġ@ param Ġargs Ġthe Ġarguments Ġto Ġbe Ġsubstit uted Ġinto Ġthe Ġmessage Ġtemplate . ĠArguments Ġare Ġconverted ĊĠĠĠĠ Ġ* Ġto Ġstrings Ġusing Ġ[ String . valueOf ]. ĠArguments Ġcan Ġbe Ġnull . ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġ// ĠNote Ġthat Ġthis Ġis Ġsomewhat - impro per ly Ġused Ġfrom ĠVerify . java Ġas Ġwell . ĊĠĠĠ Ġinternal Ġfun Ġformat ( template : ĠString , Ġvar arg Ġargs : ĠAny ): ĠString Ġ{ ĊĠĠĠĠĠĠĠ Ġvar Ġtemplate Ġ= Ġtemplate ĊĠĠĠĠĠĠĠ Ġvar Ġargs Ġ= Ġargs ĊĠĠĠĠĠĠĠ Ġtemplate Ġ= Ġtemplate Ġ// Ġnull Ġ-> Ġ" null " ĊĊĠĠĠĠĠĠĠ Ġargs Ġ= Ġif Ġ( args Ġ== Ġnull ) ĠarrayOf < Any >(" ( Object []) null ") Ġelse Ġargs ĊĊĠĠĠĠĠĠĠ Ġ// Ġstart Ġsubstit uting Ġthe Ġarguments Ġinto Ġthe Ġ'% s ' Ġplaceholders ĊĠĠĠĠĠĠĠ Ġval Ġbuilder Ġ= ĠStringBuilder ( template . length Ġ+ Ġ 1 6 Ġ* Ġargs . size ) ĊĠĠĠĠĠĠĠ Ġvar Ġtemplate Start Ġ= Ġ 0 ĊĠĠĠĠĠĠĠ Ġvar Ġi Ġ= Ġ 0 ĊĠĠĠĠĠĠĠ Ġwhile Ġ( i Ġ< Ġargs . size ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġval Ġplaceholder Start Ġ= Ġtemplate . indexOf ("% s ", Ġtemplate Start ) ĊĠĠĠĠĠĠĠĠĠĠĠ Ġif Ġ( placeholder Start Ġ== Ġ- 1 ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠĠĠĠĠ Ġbreak ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append ( template , Ġtemplate Start , Ġplaceholder Start ) ĊĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append ( args [ i ++ ]) ĊĠĠĠĠĠĠĠĠĠĠĠ Ġtemplate Start Ġ= Ġplaceholder Start Ġ+ Ġ 2 ĊĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠ Ġbuilder . append ( template , Ġtemplate Start , Ġtemplate . length ) ĊĊĠĠĠĠĠĠĠ Ġ// Ġif Ġwe Ġrun Ġout Ġof Ġplaceholders , Ġappend Ġthe Ġextra Ġargs Ġin Ġsquare Ġbr aces ĊĠĠĠĠĠĠĠ Ġif Ġ( i Ġ< Ġargs . size ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append (" Ġ[ ") ĊĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append ( args [ i ++ ]) ĊĠĠĠĠĠĠĠĠĠĠĠ Ġwhile Ġ( i Ġ< Ġargs . size ) Ġ{ ĊĠĠĠĠĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append (", Ġ") ĊĠĠĠĠĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append ( args [ i ++ ]) ĊĠĠĠĠĠĠĠĠĠĠĠ Ġ} ĊĠĠĠĠĠĠĠĠĠĠĠ Ġbuilder . append (' ]') ĊĠĠĠĠĠĠĠ Ġ} ĊĊĠĠĠĠĠĠĠ Ġreturn Ġbuilder . toString () ĊĠĠĠ Ġ} Ċ } Ċ