116e6bf01ce32f098544253aef917e6ec6ecc3ab
[idea/community.git] / platform / xdebugger-api / src / com / intellij / xdebugger / breakpoints / XBreakpointManager.java
1 /*
2  * Copyright 2000-2009 JetBrains s.r.o.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 package com.intellij.xdebugger.breakpoints;
18
19 import com.intellij.openapi.Disposable;
20 import com.intellij.openapi.vfs.VirtualFile;
21 import org.jetbrains.annotations.NotNull;
22 import org.jetbrains.annotations.Nullable;
23
24 import java.util.Collection;
25
26 /**
27  * Use {@link com.intellij.xdebugger.XDebuggerManager#getBreakpointManager()} to obtain instance of this service
28  *
29  * @author nik
30  */
31 public interface XBreakpointManager {
32
33   @NotNull <T extends XBreakpointProperties>
34   XBreakpoint<T> addBreakpoint(XBreakpointType<XBreakpoint<T>, T> type, @Nullable T properties);
35
36   @NotNull <T extends XBreakpointProperties>
37   XLineBreakpoint<T> addLineBreakpoint(XLineBreakpointType<T> type, @NotNull String fileUrl, int line, @Nullable T properties);
38   
39   void removeBreakpoint(@NotNull XBreakpoint<?> breakpoint);
40
41
42   @NotNull
43   XBreakpoint<?>[] getAllBreakpoints();
44
45   @NotNull <B extends XBreakpoint<?>>
46   Collection<? extends B> getBreakpoints(@NotNull XBreakpointType<B, ?> type);
47
48   @Nullable <P extends XBreakpointProperties>
49   XLineBreakpoint<P> findBreakpointAtLine(@NotNull XLineBreakpointType<P> type, @NotNull VirtualFile file, int line);
50
51
52   <B extends XBreakpoint<P>, P extends XBreakpointProperties>
53   void addBreakpointListener(@NotNull XBreakpointType<B,P> type, @NotNull XBreakpointListener<B> listener);
54
55   <B extends XBreakpoint<P>, P extends XBreakpointProperties>
56   void removeBreakpointListener(@NotNull XBreakpointType<B,P> type, @NotNull XBreakpointListener<B> listener);
57
58   <B extends XBreakpoint<P>, P extends XBreakpointProperties>
59   void addBreakpointListener(@NotNull XBreakpointType<B,P> type, @NotNull XBreakpointListener<B> listener, Disposable parentDisposable);
60
61
62   void addBreakpointListener(@NotNull XBreakpointListener<XBreakpoint<?>> listener);
63   void removeBreakpointListener(@NotNull XBreakpointListener<XBreakpoint<?>> listener);
64   void addBreakpointListener(@NotNull XBreakpointListener<XBreakpoint<?>> listener, @NotNull Disposable parentDisposable);
65 }