illegaleventexception.java

sea是一个基于seda模式的实现。这个设计模式将系统分为很多stage。每个stage分布不同的任务（基于线程池）。通过任务流的方式提高系统的效率。

/*
 * Copyright (c) 2003, The Regents of the University of California, through
 * Lawrence Berkeley National Laboratory (subject to receipt of any required
 * approvals from the U.S. Dept. of Energy). All rights reserved.
 */
package gov.lbl.dsd.sea.event;

import gov.lbl.dsd.sea.Stage;

/**
 * A runtime exception similar in spirit to the classic
 * {@link java.lang.IllegalArgumentException}, to be thrown when
 * {@link gov.lbl.dsd.sea.EventHandler#handle(java.lang.Object)} cannot handle an event of a certain kind.
 * Useful, since most EventHandlers cannot handle arbitrary objects but can only
 * handle events of certain classes with certain parameter constraints.
 * <p>
 * If appropriate, you can enqueue an instance of this class onto a stage.
 *
 * @author [e-mail]
 * @author $Author: hoschek3 $
 * @version $Revision: 1.2 $, $Date: 2004/05/21 20:34:11 $
 */
public class IllegalEventException extends ExceptionEvent {

    /**
     * Constructs a new exception with the specified detail message and causing
     * event.
     *
     * @param causingEvent
     *            the event that caused the exception.
     * @param source
     *            the stage that could not properly handle the causing event.
     */
    public IllegalEventException(Object causingEvent, Stage source) {
        super(causingEvent, source);
    }

    /**
     * Constructs a new exception with the specified detail message and causing
     * event.
     *
     * @param message
     *            the detail message. The detail message is saved for later
     *            retrieval by the {@link #getMessage()}method.
     * @param causingEvent
     *            the event that caused the exception.
     * @param source
     *            the stage that could not properly handle the causing event.
     */
    public IllegalEventException(String message, Object causingEvent, Stage source) {
        super(message, null, causingEvent, source);
    }

}