KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > eclipse > debug > core > IDebugEventFilter


1 /*******************************************************************************
2  * Copyright (c) 2000, 2007 IBM Corporation and others.
3  * All rights reserved. This program and the accompanying materials
4  * are made available under the terms of the Eclipse Public License v1.0
5  * which accompanies this distribution, and is available at
6  * http://www.eclipse.org/legal/epl-v10.html
7  *
8  * Contributors:
9  * IBM Corporation - initial API and implementation
10  *******************************************************************************/
11 package org.eclipse.debug.core;
12
13
14 /**
15  * An event filter allows clients to intercept debug events.
16  * Event filters are registered with the debug plug-in.
17  * <p>
18  * Clients may implement this interface.
19  * </p>
20  * @see DebugPlugin
21  * @since 2.0
22  */
23 public interface IDebugEventFilter {
24
25     /**
26      * Filters the given set of debug events, and returns the set of debug
27      * events that should be fired to registered listeners - <code>null</code>
28      * or an empty collection if no debug events should be fired.
29      * <p>
30      * When multiple event filters are registered, events are passed through
31      * all filters. That is, the events returned from the first filter are
32      * passed through the second filter, and so on.
33      * </p>
34      * @param events set of debug events to filter
35      * @return the set of debug events to fire
36      */
37     public DebugEvent[] filterDebugEvents(DebugEvent[] events);
38 }
39
Popular Tags