MDS/openide
1
0
Fork 0
mirror of https://gitflic.ru/project/openide/openide.git synced 2026-09-27 10:03:11 +07:00
Code Issues Packages Projects Releases Wiki Activity

javadoc

Browse Source
This commit is contained in:
Dmitry Jemerov
2011-07-16 11:51:54 +02:00
parent bf2364f860
commit 9cc9284363
1 changed files with 38 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
java/debugger/openapi/src/com/intellij/debugger/PositionManager.java
+38
View File
@@ -24,16 +24,54 @@ import org.jetbrains.annotations.Nullable;
import java.util.List;
/**
* Manages the correspondence between source positions and bytecode locations during JVM debugging.
* Instances of this class are created by the factory registered via the {@link PositionManagerFactory} extension point.
*
* @see com.intellij.debugger.engine.JSR45PositionManager
*/
public interface PositionManager {
/**
* Returns the source position corresponding to the specified bytecode location.
*
* @param location the bytecode location.
* @return the corresponding source position.
* @throws NoDataException if the location is not in the code managed by this {@code PositionManager}
*/
@Nullable
SourcePosition getSourcePosition(@Nullable Location location) throws NoDataException;
/**
* Returns the list of all Java classes corresponding to the specified position in the source code.
*
* @param classPosition the source position.
* @return the list of corresponding Java classes.
* @throws NoDataException if the location is not in the code managed by this {@code PositionManager}
*/
@NotNull
List<ReferenceType> getAllClasses(SourcePosition classPosition) throws NoDataException;
/**
* Returns the list of bytecode locations in a specific class corresponding to the specified position in the source code.
*
* @param type a Java class (one of the list returned by {@link #getAllClasses}).
* @param position the position in the source code.
* @return the list of corresponding bytecode locations.
* @throws NoDataException if the location is not in the code managed by this {@code PositionManager}
*/
@NotNull
List<Location> locationsOfLine(ReferenceType type, SourcePosition position) throws NoDataException;
/**
* Called to request the JVM to notify the debugger engine when a class corresponding to a breakpoint location is loaded.
* The implementation should calculate the pattern of the class files corresponding to the breakpoint location and call
* {@link com.intellij.debugger.requests.RequestManager#createClassPrepareRequest} to create the request.
*
* @param requestor the object to receive the notification from the JVM.
* @param position the location of a breakpoint.
* @return the prepare request, or null if the code is managed by this {@code PositionManager} but no class prepare notification is needed
* @throws NoDataException if the position is not in the code managed by this {@code PositionManager}
*/
@Nullable
ClassPrepareRequest createPrepareRequest(ClassPrepareRequestor requestor, SourcePosition position) throws NoDataException;
}