Exception handling in endpoints

[kubazuch]

I know this task was supposed to be finished in Sprint 2 💀 but it will have to be finished in Sprint 4 as I want to do this correctly and scalably. Because of this, I have to do #71 before that.

Here are my core goals for this task:

1. Consistency: Standardize error responses across the API. Ensure they are compliant with RFC 7807.
2. Clarity: Provide clear, informative error messages suitable for both users and developers.
3. Maintenance: Simplify debugging and maintenance through detailed error logs.

Here is my plan:

• Zalando's Problem: Use Problem / Problem Spring Web libraries for ease of work.
• Global Exception Handling: Use @RestControllerAdvice to create a global exception handler that catches and handles exceptions across all controllers.
• Semantic Exceptions: Implement many semantic exceptions like ProductNotFoundException, etc., to customizeresponse body easily.
• Validation Error Handling: Explicitly state which part of the request is bad.
• Logging: Ensure that all exceptions are logged with sufficient detail to aid in debugging and monitoring the API's health.

Discussion Points:

• Approach: Does anyone have suggestions or concerns about the proposed methods and classes?
• Improvements: Are there areas in the current exception handling that you think could be improved or handled differently?

Knowledge base:

• A Guide to the Problem Spring Web Library
• RFC 7807
• Spring Web MVC Error Responses
• Error Handling for REST with Spring
• Exception Handling in Spring MVC

[mslup]

I think you research is very thorough and your approach makes sense to me -- you have the green light to implement exception handling as you see it.

[kubazuch]

Thanks, I was very self conscious about these matters.

[migoox]

You've done a solid work with the research, I have nothing to add!

I have only one question -- are you considering adding throws in services as a part of the task or is this task focusing only on preparing the mechanisms that we are going to use in the future?

[kubazuch]

Yes, I want to implement proper exception throwing too!

[kubazuch]

Done!