diff options
Diffstat (limited to 'org.eclipse.jdt.debug/eval/org/eclipse/jdt/internal/debug/eval/ast/engine/IRuntimeContext.java')
-rw-r--r-- | org.eclipse.jdt.debug/eval/org/eclipse/jdt/internal/debug/eval/ast/engine/IRuntimeContext.java | 127 |
1 files changed, 66 insertions, 61 deletions
diff --git a/org.eclipse.jdt.debug/eval/org/eclipse/jdt/internal/debug/eval/ast/engine/IRuntimeContext.java b/org.eclipse.jdt.debug/eval/org/eclipse/jdt/internal/debug/eval/ast/engine/IRuntimeContext.java index 8c68f51eb..9c53f8ef4 100644 --- a/org.eclipse.jdt.debug/eval/org/eclipse/jdt/internal/debug/eval/ast/engine/IRuntimeContext.java +++ b/org.eclipse.jdt.debug/eval/org/eclipse/jdt/internal/debug/eval/ast/engine/IRuntimeContext.java @@ -10,7 +10,6 @@ *******************************************************************************/ package org.eclipse.jdt.internal.debug.eval.ast.engine; - import org.eclipse.core.runtime.CoreException; import org.eclipse.jdt.core.IJavaProject; import org.eclipse.jdt.debug.core.IJavaClassObject; @@ -19,107 +18,113 @@ import org.eclipse.jdt.debug.core.IJavaObject; import org.eclipse.jdt.debug.core.IJavaReferenceType; import org.eclipse.jdt.debug.core.IJavaThread; import org.eclipse.jdt.debug.core.IJavaVariable; - + /** - * The context in which an evaluation is to be performed. An - * evaluation is performed in the context of an object or class. - * The evaluation may be in the context of a method, in which case - * there could be local variables. + * The context in which an evaluation is to be performed. An evaluation is + * performed in the context of an object or class. The evaluation may be in the + * context of a method, in which case there could be local variables. * <p> * Clients are not intended to implement this interface. */ public interface IRuntimeContext { - + /** - * Returns the virtual machine in which to perform the - * evaluation. + * Returns the virtual machine in which to perform the evaluation. * * @return virtual machine */ IJavaDebugTarget getVM(); - + /** - * Returns the receiving object context in which to perform - * the evaluation - equivalent to 'this'. Returns <code>null</code> - * if the context of an evaluation is in a class rather than - * an object. + * Returns the receiving object context in which to perform the evaluation - + * equivalent to 'this'. Returns <code>null</code> if the context of an + * evaluation is in a class rather than an object. * * @return 'this', or <code>null</code> - * @exception EvaluationException if this method fails. Reasons include: - * <ul><li>Failure communicating with the VM. The exception's - * status code contains the underlying exception responsible for - * the failure.</li></ul> + * @exception EvaluationException + * if this method fails. Reasons include: + * <ul> + * <li>Failure communicating with the VM. The exception's + * status code contains the underlying exception responsible + * for the failure.</li> + * </ul> */ IJavaObject getThis() throws CoreException; - + /** - * Returns the receiving type context in which to perform - * the evaluation. The type of 'this', or in the case of a - * static context, the class or interface in which the evaluation is being - * performed. + * Returns the receiving type context in which to perform the evaluation. + * The type of 'this', or in the case of a static context, the class or + * interface in which the evaluation is being performed. * * @return receiving class - * @exception EvaluationException if this method fails. Reasons include: - * <ul><li>Failure communicating with the VM. The exception's - * status code contains the underlying exception responsible for - * the failure.</li></ul> + * @exception EvaluationException + * if this method fails. Reasons include: + * <ul> + * <li>Failure communicating with the VM. The exception's + * status code contains the underlying exception responsible + * for the failure.</li> + * </ul> */ IJavaReferenceType getReceivingType() throws CoreException; - + /** - * Returns the local variables visible for the evaluation. - * This includes method arguments, if any. Does not return - * <code>null</code> returns an empty collection if there - * are no locals. + * Returns the local variables visible for the evaluation. This includes + * method arguments, if any. Does not return <code>null</code> returns an + * empty collection if there are no locals. * * @return local variables - * @exception EvaluationException if this method fails. Reasons include: - * <ul><li>Failure communicating with the VM. The exception's - * status code contains the underlying exception responsible for - * the failure.</li></ul> + * @exception EvaluationException + * if this method fails. Reasons include: + * <ul> + * <li>Failure communicating with the VM. The exception's + * status code contains the underlying exception responsible + * for the failure.</li> + * </ul> */ IJavaVariable[] getLocals() throws CoreException; /** - * Returns the Java project context in which this expression - * should be compiled. + * Returns the Java project context in which this expression should be + * compiled. * * @return project */ IJavaProject getProject(); - + /** * Returns the thread in which message sends may be performed. * * @return thread */ IJavaThread getThread(); - + /** - * Returns whether the context of this evaluation is within - * a constructor. + * Returns whether the context of this evaluation is within a constructor. * - * @return whether the context of this evaluation is within - * a constructor - * @exception EvaluationException if this method fails. Reasons include: - * <ul><li>Failure communicating with the VM. The exception's - * status code contains the underlying exception responsible for - * the failure.</li></ul> + * @return whether the context of this evaluation is within a constructor + * @exception EvaluationException + * if this method fails. Reasons include: + * <ul> + * <li>Failure communicating with the VM. The exception's + * status code contains the underlying exception responsible + * for the failure.</li> + * </ul> */ public boolean isConstructor() throws CoreException; - /** - * Loads, prepares and returns the class with the given name in this runtime - * context's receiving type's class loader. If the class is already loaded, - * it is simply returned. - * - * @param name fully qualified class name - * @return class object - * @throws CoreException if unable to load the class - * @since 3.2 - */ - public IJavaClassObject classForName(String name) throws CoreException; - -} + /** + * Loads, prepares and returns the class with the given name in this runtime + * context's receiving type's class loader. If the class is already loaded, + * it is simply returned. + * + * @param name + * fully qualified class name + * @return class object + * @throws CoreException + * if unable to load the class + * @since 3.2 + */ + public IJavaClassObject classForName(String name) throws CoreException; +} |