package org.eclipse.jdt.debug.core; | |
/* | |
* (c) Copyright IBM Corp. 2000, 2001. | |
* All Rights Reserved. | |
*/ | |
import org.eclipse.core.runtime.CoreException; | |
import org.eclipse.debug.core.model.ILineBreakpoint; | |
/** | |
* A breakpoint that suspend execution when a particular line of code | |
* is reached. | |
* <p> | |
* Clients are not intended to implement this interface | |
* </p> | |
* @since 2.0 | |
*/ | |
public interface IJavaLineBreakpoint extends IJavaBreakpoint, ILineBreakpoint { | |
/** | |
* Returns whether this breakpoint supports a conditional | |
* expression. Conditional breakpoints only suspend when | |
* their associated condition evaluates to <code>true</code>. | |
* | |
* @return whether this breakpoint supports a condition | |
*/ | |
public boolean supportsCondition(); | |
/** | |
* Returns the conditional expression associated with this breakpoint, | |
* or <code>null</code> if this breakpoint does not have a condition. | |
* | |
* @return this breakpoint's conditional expression, or <code>null</code> | |
* @exception CoreException if unable to access the property on | |
* this breakpoint's underlying marker | |
*/ | |
public String getCondition() throws CoreException; | |
/** | |
* Sets the condition associated with this breakpoint. | |
* When the condition is enabled, this breakpoint will only suspend execution | |
* when the given condition evaluates to <code>true</code>. | |
* Setting the condition to <code>null</code> or an empty string removes | |
* the condition. | |
* <p> | |
* If this breakpoint does not support conditions, setting the condition has | |
* no effect. | |
* </p> | |
* @param condition conditional expression | |
* @exception CoreException if unable to set the property on | |
* this breakpoint's underlying marker | |
*/ | |
public void setCondition(String condition) throws CoreException; | |
/** | |
* Returns whether the condition on this breakpoint is enabled. | |
* | |
* @return whether this breakpoint's condition is enabled | |
* @exception CoreException if unable to access the property on | |
* this breakpoint's underlying marker | |
*/ | |
public boolean isConditionEnabled() throws CoreException; | |
/** | |
* Sets the enabled state of this breakpoint's condition to the given | |
* state. When enabled, this breakpoint will only suspend when its | |
* condition evaluates to true. When disabled, this breakpoint will suspend | |
* as it would with no condition defined. | |
* | |
* @exception CoreException if unable to set the property on | |
* this breakpoint's underlying marker | |
*/ | |
public void setConditionEnabled(boolean enabled) throws CoreException; | |
} | |