1 /* 2 * Copyright 1999-2004 The Apache Software Foundation 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 12 * implied. 13 * 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 package org.apache.excalibur.event; 18 19 /** 20 * An <code>EventHandler</code> takes care of processing specific events in 21 * an event-based architecture. 22 * 23 * <p> 24 * The interface design is heavily influenced by 25 * <a HREF="mailto:mdw@cs.berkeley.edu">Matt Welsh</a>'s SandStorm server, 26 * his demonstration of the SEDA architecture. We have deviated where we 27 * felt the design differences where better. 28 * </p> 29 * 30 * @author <a HREF="mailto:dev@avalon.apache.org">Avalon Development Team</a> 31 */ 32 public interface EventHandler 33 { 34 /** 35 * Handle one event at a time. 36 * 37 * @param element The element that the EventHandler must process 38 */ 39 void handleEvent( Object element ); 40 41 /** 42 * Handle a whole array of events at a time. 43 * 44 * @param elements The array of elements that the EventHandler must process 45 */ 46 void handleEvents( Object[] elements ); 47 } 48