Naming conventions for Java methods that return boolean

by

The convention is to ask a question in the name.

Here are a few examples that can be found in the JDK:

isEmpty()

hasChildren()

That way, the names are read like they would have a question mark on the end.

Is the Collection empty?
Does this Node have children?

And, then, true means yes, and false means no.

Or, you could read it like an assertion:

The Collection is empty.
The node has children

Note:
Sometimes you may want to name a method something like createFreshSnapshot?. Without the question mark, the name implies that the method should be creating a snapshot, instead of checking to see if one is required.

In this case you should rethink what you are actually asking. Something like isSnapshotExpired is a much better name, and conveys what the method will tell you when it is called. Following a pattern like this can also help keep more of your functions pure and without side effects.

If you do a Google Search for isEmpty() in the Java API, you get lots of results.

More Related Contents:

  1. Can't call method from class 1 in class 2 [closed]
  2. How to create a loop thats includes a if statement
  3. Java Questions! About List and Objects
  4. The syntax of the method [closed]
  5. Is it possible to change the return value of a method in this case? [closed]
  6. Java Array Parameter and Array Type Metot [closed]
  7. Variable may not of been initialized even though it has been in the method
  8. Which overload will get selected for null in Java?
  9. Java synchronized static methods: lock on object or class
  10. Why does this Java method appear to have two return types?
  11. Why doesn’t Mockito mock static methods?
  12. Coding Conventions – Naming Enums
  13. Converting Integers to Roman Numerals – Java
  14. Should private helper methods be static if they can be static
  15. Set and Get Methods in java?
  16. Variable naming conventions in Java
  17. Are there best practices for (Java) package organization? [closed]
  18. Count words in a string method?
  19. How do I intercept a method invocation with standard java features (no AspectJ etc)?
  20. Are there any Java method ordering conventions? [closed]
  21. Compiler error : reference to call ambiguous
  22. Can non-static methods modify static variables
  23. What does ‘public static void’ mean in Java?
  24. Varargs Java Ambiguous Call
  25. Java: Sending Multiple Parameters to Method [closed]
  26. Naming convention for getters/setters in Java
  27. Final arguments in interface methods – what’s the point?
  28. How can I create a Java method that accepts a variable number of arguments?
  29. How to automatically log the entry/exit of methods in Java?
  30. Java – Creating an array of methods

Leave a Comment