| |
|
| org.eclipse.jdt.debug.core.IJavaBreakpoint
All known Subclasses: org.eclipse.jdt.internal.debug.core.breakpoints.JavaBreakpoint,
IJavaBreakpoint | public interface IJavaBreakpoint extends IBreakpoint(Code) | | A breakpoint specific to the Java debug model. A Java breakpoint
supports:
- a hit count
- a suspend policy that determines if the entire VM or
a single thread is suspended when hit
- a thread filter to restrict a breakpoint to a specific
thread within a VM
- an installed property that indicates a breakpoint was successfully
installed in a VM
Clients are not intended to implement this interface
since: 2.0 |
Field Summary | |
final public static int | SUSPEND_THREAD Default suspend policy constant indicating a breakpoint will
suspend only the thread in which it occurred. | final public static int | SUSPEND_VM Suspend policy constant indicating a breakpoint will
suspend the target VM when hit. |
Method Summary | |
public void | addInstanceFilter(IJavaObject object) Adds the given object to the list of objects in which this
breakpoint is restricted to suspend execution. | public int | getHitCount() Returns this breakpoint's hit count or, -1 if this
breakpoint does not have a hit count. | public IJavaObject[] | getInstanceFilters() Returns the current set of active instance filters. | public int | getSuspendPolicy() Returns the suspend policy used by this breakpoint, one of
SUSPEND_VM or SUSPEND_THREAD . | public IJavaThread | getThreadFilter(IJavaDebugTarget target) Returns the thread in the given target in which this breakpoint
is enabled or null if this breakpoint is enabled in
all threads in the given target. | public IJavaThread[] | getThreadFilters() Returns all thread filters set on this breakpoint. | public String | getTypeName() Returns the fully qualified name of the type this breakpoint
is located in, or null if this breakpoint
is not located in a specific type - for example, a pattern breakpoint. | public boolean | isInstalled() Returns whether this breakpoint is installed in at least
one debug target. | public void | removeInstanceFilter(IJavaObject object) Removes the given object from the list of objects in which this
breakpoint is restricted to suspend execution. | public void | removeThreadFilter(IJavaDebugTarget target) Removes this breakpoint's thread filter in the given target, if any. | public void | setHitCount(int count) Sets the hit count attribute of this breakpoint. | public void | setSuspendPolicy(int suspendPolicy) Sets whether all threads in the target VM will be suspended
when this breakpoint is hit. | public void | setThreadFilter(IJavaThread thread) Restricts this breakpoint to suspend only in the given thread
when encountered in the given thread's target. | public boolean | supportsInstanceFilters() Returns whether this breakpoints supports instance filters. | public boolean | supportsThreadFilters() Returns whether this breakpoints supports thread filters. |
SUSPEND_THREAD | final public static int SUSPEND_THREAD(Code) | | Default suspend policy constant indicating a breakpoint will
suspend only the thread in which it occurred.
|
SUSPEND_VM | final public static int SUSPEND_VM(Code) | | Suspend policy constant indicating a breakpoint will
suspend the target VM when hit.
|
addInstanceFilter | public void addInstanceFilter(IJavaObject object) throws CoreException(Code) | | Adds the given object to the list of objects in which this
breakpoint is restricted to suspend execution. Has no effect
if the object has already been added. Note that clients should
first ensure that a breakpoint supports instance filters.
Note: This implementation will add more than one filter. However, if there is
more than one instance filter for a debug target, the breakpoint will never be hit
in that target, as the current context cannot be two different instances at the
same time.
Parameters: object - instance filter to add exception: CoreException - if unable to add the given instance filter since: 2.1 |
getHitCount | public int getHitCount() throws CoreException(Code) | | Returns this breakpoint's hit count or, -1 if this
breakpoint does not have a hit count.
this breakpoint's hit count, or -1 exception: CoreException - if unable to access the propertyfrom this breakpoint's underlying marker |
getInstanceFilters | public IJavaObject[] getInstanceFilters() throws CoreException(Code) | | Returns the current set of active instance filters.
the current set of active instance filters. exception: CoreException - if unable to retrieve the list since: 2.1 |
getSuspendPolicy | public int getSuspendPolicy() throws CoreException(Code) | | Returns the suspend policy used by this breakpoint, one of
SUSPEND_VM or SUSPEND_THREAD .
one of SUSPEND_VM or SUSPEND_THREAD exception: CoreException - if unable to access the property from this breakpoint's underlying marker |
getThreadFilter | public IJavaThread getThreadFilter(IJavaDebugTarget target) throws CoreException(Code) | | Returns the thread in the given target in which this breakpoint
is enabled or null if this breakpoint is enabled in
all threads in the given target.
the thread in the given target that this breakpoint is enabled for exception: CoreException - if unable to determine this breakpoint's threadfilter |
getThreadFilters | public IJavaThread[] getThreadFilters() throws CoreException(Code) | | Returns all thread filters set on this breakpoint.
the threads that this breakpoint is restricted to exception: CoreException - if unable to determine this breakpoint'sthread filters |
getTypeName | public String getTypeName() throws CoreException(Code) | | Returns the fully qualified name of the type this breakpoint
is located in, or null if this breakpoint
is not located in a specific type - for example, a pattern breakpoint.
the fully qualified name of the type this breakpointis located in, or null exception: CoreException - if unable to access the propertyfrom this breakpoint's underlying marker |
isInstalled | public boolean isInstalled() throws CoreException(Code) | | Returns whether this breakpoint is installed in at least
one debug target.
whether this breakpoint is installed exception: CoreException - if unable to access the property on this breakpoint's underlying marker |
removeInstanceFilter | public void removeInstanceFilter(IJavaObject object) throws CoreException(Code) | | Removes the given object from the list of objects in which this
breakpoint is restricted to suspend execution. Has no effect if the
object has not yet been added as an instance filter.
Parameters: object - instance filter to remove exception: CoreException - if unable to remove the given instance filter since: 2.1 |
removeThreadFilter | public void removeThreadFilter(IJavaDebugTarget target) throws CoreException(Code) | | Removes this breakpoint's thread filter in the given target, if any.
Has no effect if this breakpoint does not have a filter in the given target.
Parameters: target - the target whose thread filter will be removed exception: CoreException - if unable to remove the thread filter |
setHitCount | public void setHitCount(int count) throws CoreException(Code) | | Sets the hit count attribute of this breakpoint.
If this breakpoint is currently disabled and the hit count
is set greater than -1, this breakpoint is automatically enabled.
Parameters: count - the new hit count exception: CoreException - if unable to set the propertyon this breakpoint's underlying marker |
setSuspendPolicy | public void setSuspendPolicy(int suspendPolicy) throws CoreException(Code) | | Sets whether all threads in the target VM will be suspended
when this breakpoint is hit. When SUSPEND_VM the target
VM is suspended, and when SUSPEND_THREAD only the thread
in which this breakpoint occurred is suspended.
Parameters: suspendPolicy - one of SUSPEND_VM orSUSPEND_THREAD exception: CoreException - if unable to set the propertyon this breakpoint's underlying marker |
setThreadFilter | public void setThreadFilter(IJavaThread thread) throws CoreException(Code) | | Restricts this breakpoint to suspend only in the given thread
when encountered in the given thread's target. A breakpoint can
only be restricted to one thread per target. Any previous
thread filter for the same target is lost.
A thread filter is not persisted
across workbench invocations.
exception: CoreException - if unable to set the thread filter |
supportsInstanceFilters | public boolean supportsInstanceFilters()(Code) | | Returns whether this breakpoints supports instance filters.
whether this breakpoints supports instance filters since: 3.0 |
supportsThreadFilters | public boolean supportsThreadFilters()(Code) | | Returns whether this breakpoints supports thread filters.
whether this breakpoints supports thread filters since: 3.0 |
|
|
|