/* Copyright (c) 2001 - 2011 TOPP - www.openplans.org. All rights reserved.
 * This code is licensed under the GPL 2.0 license, available at the root
 * application directory.
 */
package org.geoserver.web;

import org.apache.wicket.IRequestTarget;
import org.apache.wicket.Page;
import org.apache.wicket.RequestCycle;

/**
 * Pluggable callback exposing the Wicket {@link RequestCycle} stages
 * 
 * @author Andrea Aime - GeoSolutions
 * 
 */
public interface WicketCallback {

    /**
     * Called when the request cycle object is beginning its response
     */
    void onBeginRequest();

    /**
     * Called when the request cycle object has detached all request targets.
     */
    void onAfterTargetsDetached();

    /**
     * Called when the request cycle object has finished its response
     */
    void onEndRequest();

    /**
     * Called when a request target is set on the request cycle
     * 
     * @param requestTarget
     */
    void onRequestTargetSet(IRequestTarget requestTarget);

    /**
     * Called when a runtime exception is thrown, just before the actual handling of the runtime
     * exception.
     * 
     * @param page Any page context where the exception was thrown
     * @param e The exception
     */
    void onRuntimeException(Page page, RuntimeException e);

}