feature/Introduce-route-specific-error-responses-and-loggers

[akohan91]

Description

This PR enhances the REST framework by adding support for route-specific error response factories and loggers. This allows developers to define custom error handling and logging behavior for specific routes in their REST APIs.

Changes

• Added route-specific error response factory and logger support to libak_RestRouter
• Added virtual methods to configure route-specific factories and loggers:
  • setRouteToErrorResponseFactoryType()
  • setRouteToLoggerType()
• Updated libak_RestFramework.handleRequest() to call these new methods
• Updated newRestProcessor() to use route-specific factories and loggers when available
• Added unit tests to verify the new functionality
• Updated API documentation to reflect the new capabilities

Why is this change needed?

Previously, the framework used a single error response factory and logger for all routes. This change enables more granular control over error handling and logging on a per-route basis, allowing developers to create specialized behavior for different REST endpoints.

How to test

Run the updated test classes:

• libak_TestRestRouter

Example Usage

public class CustomerRestRouter extends libak_RestRouter {
    override public libak_RestRouter setRoutes() {
        this.routeToRestProcessorType = new Map<String, Type>{
            '/v1/customers' => CustomersProcessorV1.class,
            '/v1/customers/:customer_sf_id' => CustomerProcessorV1.class
        };
        return this;
    }
    
    override public libak_RestRouter setRouteToErrorResponseFactoryType() {
        this.routeToErrorResponseFactoryType = new Map<String, Type>{
            '/v1/customers' => CustomErrorFactory.class
        };
        return this;
    }
    
    override public libak_RestRouter setRouteToLoggerType() {
        this.routeToLoggerType = new Map<String, Type>{
            '/v1/customers/:customer_sf_id' => DetailedCustomerLogger.class
        };
        return this;
    }
}

[github-actions]

💚 PMD Analysis: No issues found

[github-actions]

💚 Deployment Validation Results:

• Status: Success