BricketEventListener.java

/**
 * Copyright 2011 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License 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 org.bricket.web.event;

/**
 * To use event notification you must:
 * 
 * 1.) Implement an Event: class SomethingChangedEvent extends
 * BricketAbstractEvent .... this way the event is identified by: event
 * instanceof myInterestingEvent
 * 
 * 2.) Target class must implement BricketEventListener, there you check if
 * you're interested in this event
 * 
 * 3.) Fire the Event where it happens: new SomethingChangedEvent(MyPanel.this,
 * target, someInfo).fire();
 * 
 * fire() checks in this order: Application, Session, Page, Component tree of
 * page, each object implementing BricketEventListener get's notified
 * 
 * 
 * @author Ingo Renner
 * @author Henning Teek
 * 
 */
public interface BricketEventListener {
    void notifyEvent(BricketAbstractEvent event);
}