Home/ Questions/Q 743065
In Process

The Archive Base Latest Questions

Editorial Team
  • 0
Asked: 2026-05-14T08:49:12+00:00

We have a REST API that works great. We’re refactoring and deciding how to

  • 0

We have a REST API that works great. We’re refactoring and deciding how to internally handle errors by the users of our API.

For example the user needs to specify the “movie” url parameter which should take the value of “1984”, “Crash”, or “Avatar”. First we check to see if it has a valid value.

What would be the best approach if the movie parameter is invalid?

  • return null from one of the internal methods and check for the null in the main API call method
  • throw an exception from the internal method and catch exceptions in the main API method

I think it would make our code more readable and elegant to use exceptions. However, we’re reluctant because we’d be potentially throwing many exceptions because of user API input errors, our code could be perfect. This doesn’t seem to be the proper use of exceptions. If there are heavy performance penalties with exceptions, which would make sense with stack traces needing to be collected, etc., then we’re unnecessarily spending resources when all we need to do is tell the user the parameter is wrong.

These are REST API methods, so we’re not propogating the exceptions to the users of the API, nor would we want to even if possible.

So what’s the best practice here? Use ugly nulls or use java’s exception mechanism?

Share

Leave an answer

You must login to add an answer.

Need An Account,

1 Answer

  1. Editorial Team

    Neither.

    The key is that passing a bad parameter isn’t that exceptional a condition. Exceptions are thrown for exceptional circumstances. (That’s the reason to not use them here, not the performance.)

    You should be using something like Spring’s DataValidation API for binding parameters that are passed in.

    A client of a REST API should not be receiving null or exceptions. They should get an error message that gives them an idea of what’s going on without exposing those details. “Sorry, we couldn’t find that movie” or null? Go with the first, hands down.

    • 0