| 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; |
| |
| } |
| |