Class ChainHandler

src/sunlabs/brazil/server/ChainHandler.java:193–410

Allows multiple handlers to be invoked sequentially for a single HTTP request. A list of handlers is supplied when this ChainHandler is initialized. When an HTTP request is received by this ChainHandler , each of the handlers from the list is called in turn until one of th

 * @version		2.5
 */
public class ChainHandler
    implements Handler
{
    private static final String HANDLERS = "handlers";
    private static final String EXIT_ON_ERROR = "exitOnError";

    /**
     * The array of handlers that will be invoked to handle
     * the request.
     */
    public Handler[] handlers;

    /**
     * The names of the above <code>handlers</code> as specified by the
     * configuration parameters.  Used for logging the names of each
     * <code>Handler</code> as it is invoked.
     */
    public String[] names;

    /**
     * The prefix used to initialize this <code>ChainHandler</code>, used
     * for logging.
     */
    public String prefix;

    /**
     * The URL that must match for this handler to run
     */
    public MatchString isMine;

    /**
     * The name (if any) of the property to receive the name of the handler
     * that handled the request.
     */
    public String report;

    /**
     * A flag to require the successfull initialization of all 
     * handlers.
     */
    public boolean exitOnError = false;

    /**
     * Initializes this <code>ChainHandler</code> by initializing all the
     * "wrapped" handlers in the list of handlers.  If a wrapped handler
     * cannot be initialized, this method logs a message and skips it.  If no
     * handlers were specified, or no handlers were successfully initialized,
     * then the initialization of this <code>ChainHandler</code> is
     * considered to have failed.
     * 
     * @param	server
     *		The HTTP server that created this <code>ChainHandler</code>.
     *
     * @param	prefix
     *		The prefix for this <code>ChainHandler</code>'s properties.
     *
     * @return	<code>true</code> if at least one of the wrapped handlers
     *		was successfully initialized.