gauntlet : Java Glossary

by Roedy Green ©1996-2009 Canadian Mind Products
index page for letter ⇒ punctuation 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z (all)

gauntlet

A gauntlet is a series of conditions guarding an action. There is usually only one fail action (possibly empty) and one success action (possibly empty) for the series of tests as a whole.

Early Return Style Gauntlet

Writing gauntlets the obvious way in Java soon wraps you N layers deep in nested ifs. One of the easiet ways to write gauntlets is to make them a separate procedure that returns either success or fail. You use the early return feature to avoid the deep nesting.

The above code is an artificial example since File.delete is defined to return true if and only if the file denoted by this abstract pathname exists and is a directory; false otherwise. In other words, it does most of the checks itself, and so they are not necessary.

Java purists dislike using the early return, even in a small method like the one above. I like this style because the conditions are independent and uniform. You can shuffle the order easily and add new conditions without having the adjust the existing code.

Another common type of early return gauntlet has a void return. If any test fails it quietly returns without doing anything. Another type just returns a boolean without executing the goal action, leaving that up to caller.

McCarthy Style Gauntlet

If your gauntlet is composed purely of conditions, you can use && or || to join them in a single if.

One problem with the technique above is things can get a little complicated with precedence and all the possible combinations of !, || and &&. The other problem is you have to break the pattern any time a condition needs a little precalculation.

Nested If Inline Style Gauntlet

Java has no nested methods. Therefore all the information your gauntlet method needs must either be passed as parameters or available via instance and static variables and methods. Sometimes the volume of information you need to pass via parameters is so high, it makes writing a separate gauntlet method not worth the effort, and it is cleaner to make do with an inline gauntlet implemented as a deeply nested if like this:

If find the nested if style above the hardest to maintain. When it comes time to add another condition or reorder the conditions it turns in to confusing sea of { and }. The other problem is the gauntlet in not clearly delimited as a logical unit. It flows seamlessly into the logic before and after.

	Please email your feedback for publication, errors, omissions, broken/redirected link reports and suggestions to improve this page to Roedy Green :
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
	Your face IP:[38.103.63.62]
	You are visitor number 9,950.
	You can get a fresh copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/gauntlet.html	J:\mindprod\jgloss\gauntlet.html