js debugger: show error message if breakpoint is set inside html event handler
[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 javax.swing.*;
25 import java.util.Collection;
26
27 /**
28  * Use {@link com.intellij.xdebugger.XDebuggerManager#getBreakpointManager()} to obtain instance of this service
29  *
30  * @author nik
31  */
32 public interface XBreakpointManager {
33
34   @NotNull <T extends XBreakpointProperties>
35   XBreakpoint<T> addBreakpoint(XBreakpointType<XBreakpoint<T>, T> type, @Nullable T properties);
36
37   @NotNull <T extends XBreakpointProperties>
38   XLineBreakpoint<T> addLineBreakpoint(XLineBreakpointType<T> type, @NotNull String fileUrl, int line, @Nullable T properties);
39   
40   void removeBreakpoint(@NotNull XBreakpoint<?> breakpoint);
41
42
43   @NotNull
44   XBreakpoint<?>[] getAllBreakpoints();
45
46   @NotNull <B extends XBreakpoint<?>>
47   Collection<? extends B> getBreakpoints(@NotNull XBreakpointType<B, ?> type);
48
49   @Nullable <P extends XBreakpointProperties>
50   XLineBreakpoint<P> findBreakpointAtLine(@NotNull XLineBreakpointType<P> type, @NotNull VirtualFile file, int line);
51
52
53   <B extends XBreakpoint<P>, P extends XBreakpointProperties>
54   void addBreakpointListener(@NotNull XBreakpointType<B,P> type, @NotNull XBreakpointListener<B> listener);
55
56   <B extends XBreakpoint<P>, P extends XBreakpointProperties>
57   void removeBreakpointListener(@NotNull XBreakpointType<B,P> type, @NotNull XBreakpointListener<B> listener);
58
59   <B extends XBreakpoint<P>, P extends XBreakpointProperties>
60   void addBreakpointListener(@NotNull XBreakpointType<B,P> type, @NotNull XBreakpointListener<B> listener, Disposable parentDisposable);
61
62
63   void addBreakpointListener(@NotNull XBreakpointListener<XBreakpoint<?>> listener);
64   void removeBreakpointListener(@NotNull XBreakpointListener<XBreakpoint<?>> listener);
65   void addBreakpointListener(@NotNull XBreakpointListener<XBreakpoint<?>> listener, @NotNull Disposable parentDisposable);
66
67   void updateBreakpointPresentation(@NotNull XLineBreakpoint<?> breakpoint, @Nullable Icon icon, @Nullable String errorMessage);
68 }