Skip to main content

RA.Utilities.Core.Exceptions

· 4 min read
Redon Alla
Redon Alla
.NET, React, Angular Developer

Version 10.0.3​

Date Badge NuGet version

This release enhances the ConflictException by adding a more flexible constructor.

✨ Improvements​

  • ConflictException: Added a new constructor that allows throwing the exception with default conflict messages and codes, without requiring specific entity names or values. This is useful for general conflict scenarios where detailed entity information is not necessary or available.

Version 10.0.2​

Date Badge NuGet version

This release introduces new semantic exceptions to handle authorization and state-based conflicts more effectively, increasing the granularity of error reporting within the RA.Utilities ecosystem.

✨ New Features​

  • ForbiddenException: Introduced to represent scenarios where an authenticated user lacks sufficient permissions (maps to HTTP 403 Forbidden).
  • UnprocessableException: Added to represent operations that are invalid due to the current state of a resource (maps to HTTP 422 Unprocessable Entity).
  • Documentation: Updated the package README and added comprehensive documentation files with usage examples for the new exceptions.

Version 10.0.0​

Date Badge NuGet version

Updated the project version from 10.0.100-rc.2 to the stable release version 10.0.0 in preparation for a production release.

Expanded documentation in the README with sections on best practices, how it works, and additional examples to improve user guidance and clarity on package usage. These enhancements aim to improve readability and usability of the documentation for users and developers.

✨ Key Documentation Improvements​

  • Added Table of Contents: For easier navigation within the README.md file.
  • New "How It Works" Section: A new section was added to explain how the exceptions integrate with API middleware to standardize error handling.
  • New "Best Practices" Section: This new section provides clear guidelines on how to use the semantic exceptions correctly within a Clean Architecture, covering topics like where to throw exceptions and how to combine them with the Result<T> pattern.
  • Improved Usage Examples: The code examples for NotFoundException, ConflictException, and BadRequestException have been refined for better clarity.

📝 Notes​

The goal of this update is to make the RA.Utilities.Core.Exceptions package more approachable and easier to adopt by providing comprehensive, easy-to-navigate documentation directly in the README.

Version 10.0.100-rc.2​

Date Badge NuGet version

This release focuses on clarifying the central role of semantic exceptions within the RA.Utilities ecosystem through greatly improved documentation and usage examples in related packages. While the exception classes themselves have not changed, their purpose and integration are now much clearer.

✨ Key Improvements​

  • Enhanced Documentation:
    • The README.md file has been updated to clearly articulate the purpose of using semantic exceptions like NotFoundException and ConflictException.
    • New Docusaurus documentation provides a dedicated section for this package, making it easier for developers to find information.
  • Clarified Integration with Result<T>:
    • Documentation for the RA.Utilities.Core package now explicitly demonstrates how these exceptions are used to represent the Failure state in the Result pattern. This highlights the primary mechanism for predictable error handling.
  • Clarified Integration with the API Layer:
    • Documentation for RA.Utilities.Api (specifically ErrorResultResponse and ErrorResultMapper) now shows how these exceptions are automatically caught and translated into standardized HTTP error responses (e.g., 404, 409).

📝 Notes​

The goal of this update is to improve the developer experience by making the error handling strategy of the RA.Utilities ecosystem transparent and easy to follow. By documenting how RA.Utilities.Core.Exceptions connects the business logic layer to the API layer, developers can more effectively build robust and predictable applications.