package net.borgac.clusterrpc.client;

/**
 * OutgoingFilters are used to influence the behavior of outgoing RPCs.
 *
 * An outgoing RPC is given to the first filter, which can modify the request;
 * after doing its work, it gives the request to the next filter down the stack
 * until the final SendFilter is encountered, which sends the request.
 *
 * After a response has been received, it goes up through the stack of filters,
 * which then can modify or act on the response (for example, retry a failed
 * request or log something).
 *
 * @author lbo
 */
public interface OutgoingFilter {

    /**
     * Set the filter that this filter will call.
     *
     * @param inner
     */
    void setInner(OutgoingFilter inner);

    Response go(Request request) throws RpcException;
}