/*
    Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved.

    Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file
    except in compliance with the License. A copy of the License is located at

        http://aws.amazon.com/apache2.0/

    or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for
    the specific language governing permissions and limitations under the License.
 */

package com.amazon.ask.request.interceptor;

/**
 * Response interceptors are invoked immediately after execution of the request handler. Because response interceptors
 * have access to the output generated from execution of the request handler, they are ideal for tasks such as response
 * sanitation and validation.
 *
 * @param <Input> handler input type
 * @param <Output> handler output type
 */
public interface GenericResponseInterceptor<Input, Output> {

    /**
     * Intercept the output from the request handler after it is executed.
     *
     * @param input handler input
     * @param response handler output
     */
    default void process(Input input, Output response) { }

    /**
     * Intercept the output from the request handler after it is executed and return an updated response.
     *
     * @param input handler input
     * @param response handler output
     * @return updated response
     */
    default Output processResponse(Input input, Output response) {
        process(input, response);
        return response;
    }

}
