blob: 9c53f8ef43a979dc596dc353ec1f647f5e307173 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
/*******************************************************************************
* Copyright (c) 2000, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/
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;
import org.eclipse.jdt.debug.core.IJavaDebugTarget;
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.
* <p>
* Clients are not intended to implement this interface.
*/
public interface IRuntimeContext {
/**
* 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.
*
* @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>
*/
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.
*
* @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>
*/
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.
*
* @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>
*/
IJavaVariable[] getLocals() throws CoreException;
/**
* 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.
*
* @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;
}
|
