Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Is there a standard java exception class that means "The object was not found"?

Consider a function of the following general form:

Foo findFoo(Collection<Foo> foos, otherarguments) throws ObjectNotFoundException {     for(Foo foo : foos){         if(/* foo meets some condition*/){             return foo;         }     }     throw new ObjectNotFoundException(); } 

A concrete case, for example, would be:

User findUserByName(Collection<User> users, String name) throws ObjectNotFoundException {     for(User user : users){         if(user.getName().equals(name)){             return user;         }     }     throw new ObjectNotFoundException(); } 

These functions throw an exception if the object is not found. I can create a custom exception class for this purpose (in the examples, ObjectNotFoundException) but I would prefer to use an existing class. However, I could not find any exception class with this meaning in the standard java library. Do you know if there is a standard exception that can be used here?

like image 215
abl Avatar asked Jul 15 '14 14:07

abl


People also ask

What is object not found exception?

The ObjectNotFoundException exception is thrown by a finder or select method to indicate that the specified EJB object or local object does not exist. Only the finder and select methods that are declared to return a single object use this exception.

What are the 3 types of exceptions?

There are three types of exception—the checked exception, the error and the runtime exception.

Which exception is thrown when a requested method does not exist?

The NotImplementedException exception indicates that the method or property that you are attempting to invoke has no implementation and therefore provides no functionality. As a result, you should not handle this error in a try/catch block.


1 Answers

Do you know if there is a standard exception that can be used here?

There are a couple of exceptions that could be used (e.g. NoSuchElementException or IllegalArgumentException) but the answer really depends on the semantics that you intend to convey:

  • NoSuchElementException tends to be used when you are stepping through an sequence or enumeration, where what you have here is a lookup.

  • IllegalArgumentException tends to imply that the argument is in error, but in this case, it could be that the assumptions of the caller are incorrect, or something that is specific to the application logic.

  • A custom exception allows you to say (in the javadocs) exactly what the exception means. You can also declare it to be checked ... if that it appropriate.

(But don't be tempted to use UnknownUserException. That would be horribly wrong; read the javadoc!)


It is also worth considering returning null, especially if lookup failure is likely to be a fairly common (non-exceptional) event in your application. However, the downside of returning null is that the caller needs to check for null or risk unexpected NullPointerExceptions. Indeed, I would argue that over-use of null is worse than over-use of exceptions. The former can result in unreliable applications, whereas the latter is "only" bad for performance.

For Java 8 and onwards, returning an Optional would be a cleaner choice than returning a null.


In these things, it is important to look beyond the dogmas, and make up your mind based on what the actual context requires.

like image 147
Stephen C Avatar answered Oct 04 '22 17:10

Stephen C