1 /*
2 * jDTAUS Core API
3 * Copyright (C) 2005 Christian Schulte
4 * <cs@schulte.it>
5 *
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or any later version.
10 *
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
15 *
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 *
20 */
21 package org.jdtaus.core.lang;
22
23 /**
24 * {@code ExceptionEventSource} is implemented by classes firing
25 * {@code ExceptionEvent}s.
26 * <p>Example: Listening to all jDTAUS Core SPI compliant implementations in the
27 * system<blockquote><pre>
28 * ExceptionEventSource source =
29 * (ExceptionEventSource) ContainerFactory.getContainer().
30 * getObject( ExceptionEventSource.class );
31 *
32 * source.addExceptionListener(<i>your application's listener</i>);
33 * </pre></blockquote></p>
34 *
35 * @author <a href="mailto:cs@schulte.it">Christian Schulte</a>
36 * @version $JDTAUS: ExceptionEventSource.java 8641 2012-09-27 06:45:17Z schulte $
37 */
38 public interface ExceptionEventSource
39 {
40 //--ExceptionEventSource----------------------------------------------------
41
42 /**
43 * Adds an {@code ExceptionListener} to the listener list.
44 *
45 * @param listener The listener to be added to the listener list.
46 *
47 * @throws NullPointerException if {@code listener} is {@code null}.
48 */
49 void addExceptionListener( ExceptionListener listener );
50
51 /**
52 * Removes a {@code ExceptionListener} from the listener list.
53 *
54 * @param listener The listener to be removed from the listener list.
55 *
56 * @throws NullPointerException if {@code listener} is {@code null}.
57 */
58 void removeExceptionListener( ExceptionListener listener );
59
60 /**
61 * Gets all currently registered {@code ExceptionListener}s.
62 *
63 * @return all currently registered {@code ExceptionListener}s.
64 */
65 ExceptionListener[] getExceptionListeners();
66
67 //----------------------------------------------------ExceptionEventSource--
68 }