Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
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.java127
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;
+}

Back to the top