1 <!DOCTYPE HTML>
2 <!-- NewPage -->
3 <html lang="en">
4 <head>
5 <!-- Generated by javadoc -->
6 <title>VirtualMachine (Java SE 14 & JDK 14 [ad-hoc build])</title>
7 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
8 <meta name="description" content="declaration: module: jdk.jdi, package: com.sun.jdi, interface: VirtualMachine">
9 <meta name="generator" content="javadoc/ClassWriterImpl">
10 <meta name="keywords" content="com.sun.jdi.VirtualMachine interface">
11 <meta name="keywords" content="TRACE_NONE">
12 <meta name="keywords" content="TRACE_SENDS">
13 <meta name="keywords" content="TRACE_RECEIVES">
14 <meta name="keywords" content="TRACE_EVENTS">
15 <meta name="keywords" content="TRACE_REFTYPES">
16 <meta name="keywords" content="TRACE_OBJREFS">
17 <meta name="keywords" content="TRACE_ALL">
18 <meta name="keywords" content="allModules()">
19 <meta name="keywords" content="classesByName()">
20 <meta name="keywords" content="allClasses()">
21 <meta name="keywords" content="redefineClasses()">
22 <meta name="keywords" content="allThreads()">
23 <meta name="keywords" content="suspend()">
24 <meta name="keywords" content="resume()">
25 <meta name="keywords" content="topLevelThreadGroups()">
26 <meta name="keywords" content="eventQueue()">
27 <meta name="keywords" content="eventRequestManager()">
28 <meta name="keywords" content="mirrorOf()">
29 <meta name="keywords" content="mirrorOfVoid()">
30 <meta name="keywords" content="process()">
31 <meta name="keywords" content="dispose()">
32 <meta name="keywords" content="exit()">
33 <meta name="keywords" content="canWatchFieldModification()">
34 <meta name="keywords" content="canWatchFieldAccess()">
35 <meta name="keywords" content="canGetBytecodes()">
36 <meta name="keywords" content="canGetSyntheticAttribute()">
37 <meta name="keywords" content="canGetOwnedMonitorInfo()">
38 <meta name="keywords" content="canGetCurrentContendedMonitor()">
39 <meta name="keywords" content="canGetMonitorInfo()">
40 <meta name="keywords" content="canUseInstanceFilters()">
41 <meta name="keywords" content="canRedefineClasses()">
42 <meta name="keywords" content="canAddMethod()">
43 <meta name="keywords" content="canUnrestrictedlyRedefineClasses()">
44 <meta name="keywords" content="canPopFrames()">
45 <meta name="keywords" content="canGetSourceDebugExtension()">
46 <meta name="keywords" content="canRequestVMDeathEvent()">
47 <meta name="keywords" content="canGetMethodReturnValues()">
48 <meta name="keywords" content="canGetInstanceInfo()">
49 <meta name="keywords" content="canUseSourceNameFilters()">
50 <meta name="keywords" content="canForceEarlyReturn()">
51 <meta name="keywords" content="canBeModified()">
52 <meta name="keywords" content="canRequestMonitorEvents()">
53 <meta name="keywords" content="canGetMonitorFrameInfo()">
54 <meta name="keywords" content="canGetClassFileVersion()">
55 <meta name="keywords" content="canGetConstantPool()">
56 <meta name="keywords" content="canGetModuleInfo()">
57 <meta name="keywords" content="setDefaultStratum()">
58 <meta name="keywords" content="getDefaultStratum()">
59 <meta name="keywords" content="instanceCounts()">
60 <meta name="keywords" content="description()">
61 <meta name="keywords" content="version()">
62 <meta name="keywords" content="name()">
63 <meta name="keywords" content="setDebugTraceMode()">
64 <link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
65 <link rel="stylesheet" type="text/css" href="../../../../script-dir/jquery-ui.css" title="Style">
66 <script type="text/javascript" src="../../../../script.js"></script>
67 <script type="text/javascript" src="../../../../script-dir/jszip/dist/jszip.min.js"></script>
68 <script type="text/javascript" src="../../../../script-dir/jszip-utils/dist/jszip-utils.min.js"></script>
69 <!--[if IE]>
70 <script type="text/javascript" src="../../../../script-dir/jszip-utils/dist/jszip-utils-ie.min.js"></script>
71 <![endif]-->
72 <script type="text/javascript" src="../../../../script-dir/jquery-3.4.1.js"></script>
73 <script type="text/javascript" src="../../../../script-dir/jquery-ui.js"></script>
74 </head>
75 <body class="class-declaration">
76 <script type="text/javascript">var data = {"i0":6,"i1":18,"i2":6,"i3":6,"i4":6,"i5":6,"i6":6,"i7":6,"i8":6,"i9":6,"i10":6,"i11":6,"i12":18,"i13":6,"i14":6,"i15":6,"i16":6,"i17":6,"i18":6,"i19":6,"i20":6,"i21":6,"i22":6,"i23":6,"i24":6,"i25":6,"i26":6,"i27":6,"i28":6,"i29":6,"i30":6,"i31":6,"i32":6,"i33":6,"i34":6,"i35":6,"i36":6,"i37":6,"i38":6,"i39":6,"i40":6,"i41":6,"i42":6,"i43":6,"i44":6,"i45":6,"i46":6,"i47":6,"i48":6,"i49":6,"i50":6,"i51":6,"i52":6,"i53":6};
77 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],4:["t3","Abstract Methods"],16:["t5","Default Methods"]};
78 var altColor = "altColor";
79 var rowColor = "rowColor";
80 var tableTab = "tableTab";
81 var activeTableTab = "activeTableTab";
82 var pathtoroot = "../../../../";
83 loadScripts(document, 'script');</script>
84 <noscript>
85 <div>JavaScript is disabled on your browser.</div>
86 </noscript>
87 <div class="flexBox">
88 <header role="banner" class="flexHeader"><div style="padding: 6px; text-align: center; font-size: 80%; font-family: DejaVu Sans, Arial, Helvetica, sans-serif; font-weight: normal;">This specification is not final and is subject to change. Use is subject to <a href="https://www.oracle.com/technetwork/java/javase/terms/license/java14speclicense.html">license terms</a>.</div>
89 <nav role="navigation">
90 <!-- ========= START OF TOP NAVBAR ======= -->
91 <div class="topNav"><a id="navbar.top">
92 <!-- -->
93 </a>
94 <div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
95 <a id="navbar.top.firstrow">
96 <!-- -->
97 </a>
98 <ul class="navList" title="Navigation">
99 <li><a href="../../../../index.html">Overview</a></li>
100 <li><a href="../../../module-summary.html">Module</a></li>
101 <li><a href="package-summary.html">Package</a></li>
102 <li class="navBarCell1Rev">Class</li>
103 <li><a href="class-use/VirtualMachine.html">Use</a></li>
104 <li><a href="package-tree.html">Tree</a></li>
105 <li><a href="../../../../deprecated-list.html">Deprecated</a></li>
106 <li><a href="../../../../index-files/index-1.html">Index</a></li>
107 <li><a href="../../../../help-doc.html">Help</a></li>
108 </ul>
109 <div class="aboutLanguage"><div style="margin-top: 9px;"><strong>Java SE 14 & JDK 14</strong> <br><strong>DRAFT 14-internal+0-2019-12-04-2218569.hseigel.bug8235360</strong></div></div>
110 </div>
111 <div class="subNav">
112 <div>
113 <ul class="subNavList">
114 <li>Summary: </li>
115 <li>Nested | </li>
116 <li><a href="#field.summary">Field</a> | </li>
117 <li>Constr | </li>
118 <li><a href="#method.summary">Method</a></li>
119 </ul>
120 <ul class="subNavList">
121 <li>Detail: </li>
122 <li><a href="#field.detail">Field</a> | </li>
123 <li>Constr | </li>
124 <li><a href="#method.detail">Method</a></li>
125 </ul>
126 </div>
127 <div class="navListSearch"><label for="search">SEARCH:</label>
128 <input type="text" id="search" value="search" disabled="disabled">
129 <input type="reset" id="reset" value="reset" disabled="disabled">
130 </div>
131 </div>
132 <!-- ========= END OF TOP NAVBAR ========= -->
133 <div class="skipNav"><a id="skip.navbar.top">
134 <!-- -->
135 </a></div>
136 </nav>
137 </header>
138 <div class="flexContent">
139 <main role="main">
140 <!-- ======== START OF CLASS DATA ======== -->
141 <div class="header">
142 <div class="subTitle"><span class="moduleLabelInType">Module</span> <a href="../../../module-summary.html">jdk.jdi</a></div>
143 <div class="subTitle"><span class="packageLabelInType">Package</span> <a href="package-summary.html">com.sun.jdi</a></div>
144 <h1 title="Interface VirtualMachine" class="title">Interface VirtualMachine</h1>
145 </div>
146 <div class="contentContainer">
147 <section class="description">
148 <dl>
149 <dt>All Superinterfaces:</dt>
150 <dd><code><a href="Mirror.html" title="interface in com.sun.jdi">Mirror</a></code></dd>
151 </dl>
152 <dl>
153 <dt>All Known Subinterfaces:</dt>
154 <dd><code><a href="PathSearchingVirtualMachine.html" title="interface in com.sun.jdi">PathSearchingVirtualMachine</a></code></dd>
155 </dl>
156 <hr>
157 <pre>public interface <span class="typeNameLabel">VirtualMachine</span>
158 extends <a href="Mirror.html" title="interface in com.sun.jdi">Mirror</a></pre>
159 <div class="block">A virtual machine targeted for debugging.
160 More precisely, a <a href="Mirror.html" title="interface in com.sun.jdi"><code>mirror</code></a> representing the
161 composite state of the target VM.
162 All other mirrors are associated with an instance of this
163 interface. Access to all other mirrors is achieved
164 directly or indirectly through an instance of this
165 interface.
166 Access to global VM properties and control of VM execution
167 are supported directly by this interface.
168 <P>
169 Instances of this interface are created by instances of
170 <a href="connect/Connector.html" title="interface in com.sun.jdi.connect"><code>Connector</code></a>. For example,
171 an <a href="connect/AttachingConnector.html" title="interface in com.sun.jdi.connect"><code>AttachingConnector</code></a>
172 attaches to a target VM and returns its virtual machine mirror.
173 A Connector will typically create a VirtualMachine by invoking
174 the VirtualMachineManager's <a href="VirtualMachineManager.html#createVirtualMachine(com.sun.jdi.connect.spi.Connection)"><code>VirtualMachineManager.createVirtualMachine(Connection)</code></a>
175 createVirtualMachine(Connection) method.
176 <p>
177 Note that a target VM launched by a launching connector is not
178 guaranteed to be stable until after the <a href="event/VMStartEvent.html" title="interface in com.sun.jdi.event"><code>VMStartEvent</code></a> has been
179 received.
180 <p>
181 Any method on <code>VirtualMachine</code> which
182 takes <code>VirtualMachine</code> as an parameter may throw
183 <a href="VMDisconnectedException.html" title="class in com.sun.jdi"><code>VMDisconnectedException</code></a> if the target VM is
184 disconnected and the <a href="event/VMDisconnectEvent.html" title="interface in com.sun.jdi.event"><code>VMDisconnectEvent</code></a> has been or is
185 available to be read from the <a href="event/EventQueue.html" title="interface in com.sun.jdi.event"><code>EventQueue</code></a>.
186 <p>
187 Any method on <code>VirtualMachine</code> which
188 takes <code>VirtualMachine</code> as an parameter may throw
189 <a href="VMOutOfMemoryException.html" title="class in com.sun.jdi"><code>VMOutOfMemoryException</code></a> if the target VM has run out of memory.</div>
190 <dl>
191 <dt><span class="simpleTagLabel">Since:</span></dt>
192 <dd>1.3</dd>
193 </dl>
194 </section>
195 <section class="summary">
196 <ul class="blockList">
197 <!-- =========== FIELD SUMMARY =========== -->
198 <li class="blockList">
199 <section class="fieldSummary"><a id="field.summary">
200 <!-- -->
201 </a>
202 <h2>Field Summary</h2>
203 <div class="memberSummary">
204 <table>
205 <caption><span>Fields</span><span class="tabEnd"> </span></caption>
206 <thead>
207 <tr>
208 <th class="colFirst" scope="col">Modifier and Type</th>
209 <th class="colSecond" scope="col">Field</th>
210 <th class="colLast" scope="col">Description</th>
211 </tr>
212 </thead>
213 <tbody>
214 <tr class="altColor">
215 <td class="colFirst"><code>static int</code></td>
216 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_ALL">TRACE_ALL</a></span></code></th>
217 <td class="colLast">
218 <div class="block">All tracing is enabled.</div>
219 </td>
220 </tr>
221 <tr class="rowColor">
222 <td class="colFirst"><code>static int</code></td>
223 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_EVENTS">TRACE_EVENTS</a></span></code></th>
224 <td class="colLast">
225 <div class="block">Tracing enabled for internal event handling.</div>
226 </td>
227 </tr>
228 <tr class="altColor">
229 <td class="colFirst"><code>static int</code></td>
230 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_NONE">TRACE_NONE</a></span></code></th>
231 <td class="colLast">
232 <div class="block">All tracing is disabled.</div>
233 </td>
234 </tr>
235 <tr class="rowColor">
236 <td class="colFirst"><code>static int</code></td>
237 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_OBJREFS">TRACE_OBJREFS</a></span></code></th>
238 <td class="colLast">
239 <div class="block">Tracing enabled for internal management of object references.</div>
240 </td>
241 </tr>
242 <tr class="altColor">
243 <td class="colFirst"><code>static int</code></td>
244 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_RECEIVES">TRACE_RECEIVES</a></span></code></th>
245 <td class="colLast">
246 <div class="block">Tracing enabled for JDWP packets received from target VM.</div>
247 </td>
248 </tr>
249 <tr class="rowColor">
250 <td class="colFirst"><code>static int</code></td>
251 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_REFTYPES">TRACE_REFTYPES</a></span></code></th>
252 <td class="colLast">
253 <div class="block">Tracing enabled for internal managment of reference types.</div>
254 </td>
255 </tr>
256 <tr class="altColor">
257 <td class="colFirst"><code>static int</code></td>
258 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#TRACE_SENDS">TRACE_SENDS</a></span></code></th>
259 <td class="colLast">
260 <div class="block">Tracing enabled for JDWP packets sent to target VM.</div>
261 </td>
262 </tr>
263 </tbody>
264 </table>
265 </div>
266 </section>
267 </li>
268 <!-- ========== METHOD SUMMARY =========== -->
269 <li class="blockList">
270 <section class="methodSummary"><a id="method.summary">
271 <!-- -->
272 </a>
273 <h2>Method Summary</h2>
274 <div class="memberSummary">
275 <div role="tablist" aria-orientation="horizontal"><button role="tab" aria-selected="true" aria-controls="memberSummary_tabpanel" tabindex="0" onkeydown="switchTab(event)" id="t0" class="activeTableTab">All Methods</button><button role="tab" aria-selected="false" aria-controls="memberSummary_tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t2" class="tableTab" onclick="show(2);">Instance Methods</button><button role="tab" aria-selected="false" aria-controls="memberSummary_tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t3" class="tableTab" onclick="show(4);">Abstract Methods</button><button role="tab" aria-selected="false" aria-controls="memberSummary_tabpanel" tabindex="-1" onkeydown="switchTab(event)" id="t5" class="tableTab" onclick="show(16);">Default Methods</button></div>
276 <div id="memberSummary_tabpanel" role="tabpanel">
277 <table aria-labelledby="t0">
278 <thead>
279 <tr>
280 <th class="colFirst" scope="col">Modifier and Type</th>
281 <th class="colSecond" scope="col">Method</th>
282 <th class="colLast" scope="col">Description</th>
283 </tr>
284 </thead>
285 <tbody>
286 <tr class="altColor" id="i0">
287 <td class="colFirst"><code><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>></code></td>
288 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#allClasses()">allClasses</a></span>()</code></th>
289 <td class="colLast">
290 <div class="block">Returns all loaded types.</div>
291 </td>
292 </tr>
293 <tr class="rowColor" id="i1">
294 <td class="colFirst"><code>default <a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ModuleReference.html" title="interface in com.sun.jdi">ModuleReference</a>></code></td>
295 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#allModules()">allModules</a></span>()</code></th>
296 <td class="colLast">
297 <div class="block">Returns all modules.</div>
298 </td>
299 </tr>
300 <tr class="altColor" id="i2">
301 <td class="colFirst"><code><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ThreadReference.html" title="interface in com.sun.jdi">ThreadReference</a>></code></td>
302 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#allThreads()">allThreads</a></span>()</code></th>
303 <td class="colLast">
304 <div class="block">Returns a list of the currently running threads.</div>
305 </td>
306 </tr>
307 <tr class="rowColor" id="i3">
308 <td class="colFirst"><code>boolean</code></td>
309 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canAddMethod()">canAddMethod</a></span>()</code></th>
310 <td class="colLast">
311 <div class="block">Determines if the target VM supports the addition
312 of methods when performing class redefinition.</div>
313 </td>
314 </tr>
315 <tr class="altColor" id="i4">
316 <td class="colFirst"><code>boolean</code></td>
317 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canBeModified()">canBeModified</a></span>()</code></th>
318 <td class="colLast">
319 <div class="block">Determines if the target VM is a read-only VM.</div>
320 </td>
321 </tr>
322 <tr class="rowColor" id="i5">
323 <td class="colFirst"><code>boolean</code></td>
324 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canForceEarlyReturn()">canForceEarlyReturn</a></span>()</code></th>
325 <td class="colLast">
326 <div class="block">Determines if the target VM supports the forcing of a method to
327 return early.</div>
328 </td>
329 </tr>
330 <tr class="altColor" id="i6">
331 <td class="colFirst"><code>boolean</code></td>
332 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetBytecodes()">canGetBytecodes</a></span>()</code></th>
333 <td class="colLast">
334 <div class="block">Determines if the target VM supports the retrieval
335 of a method's bytecodes.</div>
336 </td>
337 </tr>
338 <tr class="rowColor" id="i7">
339 <td class="colFirst"><code>boolean</code></td>
340 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetClassFileVersion()">canGetClassFileVersion</a></span>()</code></th>
341 <td class="colLast">
342 <div class="block">Determines if the target VM supports reading class file
343 major and minor versions.</div>
344 </td>
345 </tr>
346 <tr class="altColor" id="i8">
347 <td class="colFirst"><code>boolean</code></td>
348 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetConstantPool()">canGetConstantPool</a></span>()</code></th>
349 <td class="colLast">
350 <div class="block">Determines if the target VM supports getting constant pool
351 information of a class.</div>
352 </td>
353 </tr>
354 <tr class="rowColor" id="i9">
355 <td class="colFirst"><code>boolean</code></td>
356 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetCurrentContendedMonitor()">canGetCurrentContendedMonitor</a></span>()</code></th>
357 <td class="colLast">
358 <div class="block">Determines if the target VM supports the retrieval
359 of the monitor for which a thread is currently waiting.</div>
360 </td>
361 </tr>
362 <tr class="altColor" id="i10">
363 <td class="colFirst"><code>boolean</code></td>
364 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetInstanceInfo()">canGetInstanceInfo</a></span>()</code></th>
365 <td class="colLast">
366 <div class="block">Determines if the target VM supports the accessing of class instances,
367 instance counts, and referring objects.</div>
368 </td>
369 </tr>
370 <tr class="rowColor" id="i11">
371 <td class="colFirst"><code>boolean</code></td>
372 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetMethodReturnValues()">canGetMethodReturnValues</a></span>()</code></th>
373 <td class="colLast">
374 <div class="block">Determines if the target VM supports the inclusion of return values
375 in
376 <a href="event/MethodExitEvent.html" title="interface in com.sun.jdi.event"><code>MethodExitEvent</code></a>s.</div>
377 </td>
378 </tr>
379 <tr class="altColor" id="i12">
380 <td class="colFirst"><code>default boolean</code></td>
381 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetModuleInfo()">canGetModuleInfo</a></span>()</code></th>
382 <td class="colLast">
383 <div class="block">Determines if the target VM supports getting information about modules.</div>
384 </td>
385 </tr>
386 <tr class="rowColor" id="i13">
387 <td class="colFirst"><code>boolean</code></td>
388 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetMonitorFrameInfo()">canGetMonitorFrameInfo</a></span>()</code></th>
389 <td class="colLast">
390 <div class="block">Determines if the target VM supports getting which
391 frame has acquired a monitor.</div>
392 </td>
393 </tr>
394 <tr class="altColor" id="i14">
395 <td class="colFirst"><code>boolean</code></td>
396 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetMonitorInfo()">canGetMonitorInfo</a></span>()</code></th>
397 <td class="colLast">
398 <div class="block">Determines if the target VM supports the retrieval
399 of the monitor information for an object.</div>
400 </td>
401 </tr>
402 <tr class="rowColor" id="i15">
403 <td class="colFirst"><code>boolean</code></td>
404 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetOwnedMonitorInfo()">canGetOwnedMonitorInfo</a></span>()</code></th>
405 <td class="colLast">
406 <div class="block">Determines if the target VM supports the retrieval
407 of the monitors owned by a thread.</div>
408 </td>
409 </tr>
410 <tr class="altColor" id="i16">
411 <td class="colFirst"><code>boolean</code></td>
412 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetSourceDebugExtension()">canGetSourceDebugExtension</a></span>()</code></th>
413 <td class="colLast">
414 <div class="block">Determines if the target VM supports getting
415 the source debug extension.</div>
416 </td>
417 </tr>
418 <tr class="rowColor" id="i17">
419 <td class="colFirst"><code>boolean</code></td>
420 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canGetSyntheticAttribute()">canGetSyntheticAttribute</a></span>()</code></th>
421 <td class="colLast">
422 <div class="block">Determines if the target VM supports the query
423 of the synthetic attribute of a method or field.</div>
424 </td>
425 </tr>
426 <tr class="altColor" id="i18">
427 <td class="colFirst"><code>boolean</code></td>
428 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canPopFrames()">canPopFrames</a></span>()</code></th>
429 <td class="colLast">
430 <div class="block">Determines if the target VM supports popping
431 frames of a threads stack.</div>
432 </td>
433 </tr>
434 <tr class="rowColor" id="i19">
435 <td class="colFirst"><code>boolean</code></td>
436 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canRedefineClasses()">canRedefineClasses</a></span>()</code></th>
437 <td class="colLast">
438 <div class="block">Determines if the target VM supports any level
439 of class redefinition.</div>
440 </td>
441 </tr>
442 <tr class="altColor" id="i20">
443 <td class="colFirst"><code>boolean</code></td>
444 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canRequestMonitorEvents()">canRequestMonitorEvents</a></span>()</code></th>
445 <td class="colLast">
446 <div class="block">Determines if the target VM supports the creation of
447 <a href="request/MonitorContendedEnterRequest.html" title="interface in com.sun.jdi.request"><code>MonitorContendedEnterRequest</code></a>s.</div>
448 </td>
449 </tr>
450 <tr class="rowColor" id="i21">
451 <td class="colFirst"><code>boolean</code></td>
452 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canRequestVMDeathEvent()">canRequestVMDeathEvent</a></span>()</code></th>
453 <td class="colLast">
454 <div class="block">Determines if the target VM supports the creation of
455 <a href="request/VMDeathRequest.html" title="interface in com.sun.jdi.request"><code>VMDeathRequest</code></a>s.</div>
456 </td>
457 </tr>
458 <tr class="altColor" id="i22">
459 <td class="colFirst"><code>boolean</code></td>
460 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canUnrestrictedlyRedefineClasses()">canUnrestrictedlyRedefineClasses</a></span>()</code></th>
461 <td class="colLast">
462 <div class="block">Determines if the target VM supports
463 changes when performing class redefinition that are
464 otherwise restricted by <a href="#redefineClasses(java.util.Map)"><code>redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)</code></a>.</div>
465 </td>
466 </tr>
467 <tr class="rowColor" id="i23">
468 <td class="colFirst"><code>boolean</code></td>
469 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canUseInstanceFilters()">canUseInstanceFilters</a></span>()</code></th>
470 <td class="colLast">
471 <div class="block">Determines if the target VM supports filtering
472 events by specific instance object.</div>
473 </td>
474 </tr>
475 <tr class="altColor" id="i24">
476 <td class="colFirst"><code>boolean</code></td>
477 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canUseSourceNameFilters()">canUseSourceNameFilters</a></span>()</code></th>
478 <td class="colLast">
479 <div class="block">Determines if the target VM supports the filtering of
480 class prepare events by source name.</div>
481 </td>
482 </tr>
483 <tr class="rowColor" id="i25">
484 <td class="colFirst"><code>boolean</code></td>
485 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canWatchFieldAccess()">canWatchFieldAccess</a></span>()</code></th>
486 <td class="colLast">
487 <div class="block">Determines if the target VM supports watchpoints
488 for field access.</div>
489 </td>
490 </tr>
491 <tr class="altColor" id="i26">
492 <td class="colFirst"><code>boolean</code></td>
493 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#canWatchFieldModification()">canWatchFieldModification</a></span>()</code></th>
494 <td class="colLast">
495 <div class="block">Determines if the target VM supports watchpoints
496 for field modification.</div>
497 </td>
498 </tr>
499 <tr class="rowColor" id="i27">
500 <td class="colFirst"><code><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>></code></td>
501 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#classesByName(java.lang.String)">classesByName</a></span>(<a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a> className)</code></th>
502 <td class="colLast">
503 <div class="block">Returns the loaded reference types that
504 match a given name.</div>
505 </td>
506 </tr>
507 <tr class="altColor" id="i28">
508 <td class="colFirst"><code><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></code></td>
509 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#description()">description</a></span>()</code></th>
510 <td class="colLast">
511 <div class="block">Returns text information on the target VM and the
512 debugger support that mirrors it.</div>
513 </td>
514 </tr>
515 <tr class="rowColor" id="i29">
516 <td class="colFirst"><code>void</code></td>
517 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#dispose()">dispose</a></span>()</code></th>
518 <td class="colLast">
519 <div class="block">Invalidates this virtual machine mirror.</div>
520 </td>
521 </tr>
522 <tr class="altColor" id="i30">
523 <td class="colFirst"><code><a href="event/EventQueue.html" title="interface in com.sun.jdi.event">EventQueue</a></code></td>
524 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#eventQueue()">eventQueue</a></span>()</code></th>
525 <td class="colLast">
526 <div class="block">Returns the event queue for this virtual machine.</div>
527 </td>
528 </tr>
529 <tr class="rowColor" id="i31">
530 <td class="colFirst"><code><a href="request/EventRequestManager.html" title="interface in com.sun.jdi.request">EventRequestManager</a></code></td>
531 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#eventRequestManager()">eventRequestManager</a></span>()</code></th>
532 <td class="colLast">
533 <div class="block">Returns the event request manager for this virtual machine.</div>
534 </td>
535 </tr>
536 <tr class="altColor" id="i32">
537 <td class="colFirst"><code>void</code></td>
538 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#exit(int)">exit</a></span>(int exitCode)</code></th>
539 <td class="colLast">
540 <div class="block">Causes the mirrored VM to terminate with the given error code.</div>
541 </td>
542 </tr>
543 <tr class="rowColor" id="i33">
544 <td class="colFirst"><code><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></code></td>
545 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getDefaultStratum()">getDefaultStratum</a></span>()</code></th>
546 <td class="colLast">
547 <div class="block">Return this VM's default stratum.</div>
548 </td>
549 </tr>
550 <tr class="altColor" id="i34">
551 <td class="colFirst"><code>long[]</code></td>
552 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#instanceCounts(java.util.List)">instanceCounts</a></span>(<a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><? extends <a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>> refTypes)</code></th>
553 <td class="colLast">
554 <div class="block">Returns the number of instances of each ReferenceType in the 'refTypes'
555 list.</div>
556 </td>
557 </tr>
558 <tr class="rowColor" id="i35">
559 <td class="colFirst"><code><a href="BooleanValue.html" title="interface in com.sun.jdi">BooleanValue</a></code></td>
560 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(boolean)">mirrorOf</a></span>(boolean value)</code></th>
561 <td class="colLast">
562 <div class="block">Creates a <a href="BooleanValue.html" title="interface in com.sun.jdi"><code>BooleanValue</code></a> for the given value.</div>
563 </td>
564 </tr>
565 <tr class="altColor" id="i36">
566 <td class="colFirst"><code><a href="ByteValue.html" title="interface in com.sun.jdi">ByteValue</a></code></td>
567 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(byte)">mirrorOf</a></span>(byte value)</code></th>
568 <td class="colLast">
569 <div class="block">Creates a <a href="ByteValue.html" title="interface in com.sun.jdi"><code>ByteValue</code></a> for the given value.</div>
570 </td>
571 </tr>
572 <tr class="rowColor" id="i37">
573 <td class="colFirst"><code><a href="CharValue.html" title="interface in com.sun.jdi">CharValue</a></code></td>
574 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(char)">mirrorOf</a></span>(char value)</code></th>
575 <td class="colLast">
576 <div class="block">Creates a <a href="CharValue.html" title="interface in com.sun.jdi"><code>CharValue</code></a> for the given value.</div>
577 </td>
578 </tr>
579 <tr class="altColor" id="i38">
580 <td class="colFirst"><code><a href="DoubleValue.html" title="interface in com.sun.jdi">DoubleValue</a></code></td>
581 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(double)">mirrorOf</a></span>(double value)</code></th>
582 <td class="colLast">
583 <div class="block">Creates a <a href="DoubleValue.html" title="interface in com.sun.jdi"><code>DoubleValue</code></a> for the given value.</div>
584 </td>
585 </tr>
586 <tr class="rowColor" id="i39">
587 <td class="colFirst"><code><a href="FloatValue.html" title="interface in com.sun.jdi">FloatValue</a></code></td>
588 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(float)">mirrorOf</a></span>(float value)</code></th>
589 <td class="colLast">
590 <div class="block">Creates a <a href="FloatValue.html" title="interface in com.sun.jdi"><code>FloatValue</code></a> for the given value.</div>
591 </td>
592 </tr>
593 <tr class="altColor" id="i40">
594 <td class="colFirst"><code><a href="IntegerValue.html" title="interface in com.sun.jdi">IntegerValue</a></code></td>
595 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(int)">mirrorOf</a></span>(int value)</code></th>
596 <td class="colLast">
597 <div class="block">Creates an <a href="IntegerValue.html" title="interface in com.sun.jdi"><code>IntegerValue</code></a> for the given value.</div>
598 </td>
599 </tr>
600 <tr class="rowColor" id="i41">
601 <td class="colFirst"><code><a href="LongValue.html" title="interface in com.sun.jdi">LongValue</a></code></td>
602 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(long)">mirrorOf</a></span>(long value)</code></th>
603 <td class="colLast">
604 <div class="block">Creates a <a href="LongValue.html" title="interface in com.sun.jdi"><code>LongValue</code></a> for the given value.</div>
605 </td>
606 </tr>
607 <tr class="altColor" id="i42">
608 <td class="colFirst"><code><a href="ShortValue.html" title="interface in com.sun.jdi">ShortValue</a></code></td>
609 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(short)">mirrorOf</a></span>(short value)</code></th>
610 <td class="colLast">
611 <div class="block">Creates a <a href="ShortValue.html" title="interface in com.sun.jdi"><code>ShortValue</code></a> for the given value.</div>
612 </td>
613 </tr>
614 <tr class="rowColor" id="i43">
615 <td class="colFirst"><code><a href="StringReference.html" title="interface in com.sun.jdi">StringReference</a></code></td>
616 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOf(java.lang.String)">mirrorOf</a></span>(<a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a> value)</code></th>
617 <td class="colLast">
618 <div class="block">Creates a string in this virtual machine.</div>
619 </td>
620 </tr>
621 <tr class="altColor" id="i44">
622 <td class="colFirst"><code><a href="VoidValue.html" title="interface in com.sun.jdi">VoidValue</a></code></td>
623 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#mirrorOfVoid()">mirrorOfVoid</a></span>()</code></th>
624 <td class="colLast">
625 <div class="block">Creates a <a href="VoidValue.html" title="interface in com.sun.jdi"><code>VoidValue</code></a>.</div>
626 </td>
627 </tr>
628 <tr class="rowColor" id="i45">
629 <td class="colFirst"><code><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></code></td>
630 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#name()">name</a></span>()</code></th>
631 <td class="colLast">
632 <div class="block">Returns the name of the target VM as reported by the
633 property <code>java.vm.name</code>.</div>
634 </td>
635 </tr>
636 <tr class="altColor" id="i46">
637 <td class="colFirst"><code><a href="../../../../java.base/java/lang/Process.html" title="class in java.lang">Process</a></code></td>
638 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#process()">process</a></span>()</code></th>
639 <td class="colLast">
640 <div class="block">Returns the <a href="../../../../java.base/java/lang/Process.html" title="class in java.lang"><code>Process</code></a> object for this
641 virtual machine if launched by a <a href="connect/LaunchingConnector.html" title="interface in com.sun.jdi.connect"><code>LaunchingConnector</code></a></div>
642 </td>
643 </tr>
644 <tr class="rowColor" id="i47">
645 <td class="colFirst"><code>void</code></td>
646 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#redefineClasses(java.util.Map)">redefineClasses</a></span>(<a href="../../../../java.base/java/util/Map.html" title="interface in java.util">Map</a><? extends <a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>,byte[]> classToBytes)</code></th>
647 <td class="colLast">
648 <div class="block">All classes given are redefined according to the
649 definitions supplied.</div>
650 </td>
651 </tr>
652 <tr class="altColor" id="i48">
653 <td class="colFirst"><code>void</code></td>
654 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#resume()">resume</a></span>()</code></th>
655 <td class="colLast">
656 <div class="block">Continues the execution of the application running in this
657 virtual machine.</div>
658 </td>
659 </tr>
660 <tr class="rowColor" id="i49">
661 <td class="colFirst"><code>void</code></td>
662 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setDebugTraceMode(int)">setDebugTraceMode</a></span>(int traceFlags)</code></th>
663 <td class="colLast">
664 <div class="block">Traces the activities performed by the com.sun.jdi implementation.</div>
665 </td>
666 </tr>
667 <tr class="altColor" id="i50">
668 <td class="colFirst"><code>void</code></td>
669 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setDefaultStratum(java.lang.String)">setDefaultStratum</a></span>(<a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a> stratum)</code></th>
670 <td class="colLast">
671 <div class="block">Set this VM's default stratum (see <a href="Location.html" title="interface in com.sun.jdi"><code>Location</code></a> for a
672 discussion of strata).</div>
673 </td>
674 </tr>
675 <tr class="rowColor" id="i51">
676 <td class="colFirst"><code>void</code></td>
677 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#suspend()">suspend</a></span>()</code></th>
678 <td class="colLast">
679 <div class="block">Suspends the execution of the application running in this
680 virtual machine.</div>
681 </td>
682 </tr>
683 <tr class="altColor" id="i52">
684 <td class="colFirst"><code><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ThreadGroupReference.html" title="interface in com.sun.jdi">ThreadGroupReference</a>></code></td>
685 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#topLevelThreadGroups()">topLevelThreadGroups</a></span>()</code></th>
686 <td class="colLast">
687 <div class="block">Returns each thread group which does not have a parent.</div>
688 </td>
689 </tr>
690 <tr class="rowColor" id="i53">
691 <td class="colFirst"><code><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></code></td>
692 <th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#version()">version</a></span>()</code></th>
693 <td class="colLast">
694 <div class="block">Returns the version of the Java Runtime Environment in the target
695 VM as reported by the property <code>java.version</code>.</div>
696 </td>
697 </tr>
698 </tbody>
699 </table>
700 </div>
701 </div>
702 <div class="inheritedList">
703 <h3>Methods declared in interface com.sun.jdi.<a href="Mirror.html" title="interface in com.sun.jdi">Mirror</a></h3>
704 <a id="methods.inherited.from.class.com.sun.jdi.Mirror">
705 <!-- -->
706 </a><code><a href="Mirror.html#toString()">toString</a>, <a href="Mirror.html#virtualMachine()">virtualMachine</a></code></div>
707 </section>
708 </li>
709 </ul>
710 </section>
711 <section class="details">
712 <ul class="blockList">
713 <!-- ============ FIELD DETAIL =========== -->
714 <li class="blockList">
715 <section class="fieldDetails"><a id="field.detail">
716 <!-- -->
717 </a>
718 <h2>Field Details</h2>
719 <ul class="blockList">
720 <li class="blockList">
721 <section class="detail">
722 <h3><a id="TRACE_NONE">TRACE_NONE</a></h3>
723 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_NONE</span></div>
724 <div class="block">All tracing is disabled.</div>
725 <dl>
726 <dt><span class="seeLabel">See Also:</span></dt>
727 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_NONE">Constant Field Values</a></dd>
728 </dl>
729 </section>
730 </li>
731 <li class="blockList">
732 <section class="detail">
733 <h3><a id="TRACE_SENDS">TRACE_SENDS</a></h3>
734 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_SENDS</span></div>
735 <div class="block">Tracing enabled for JDWP packets sent to target VM.</div>
736 <dl>
737 <dt><span class="seeLabel">See Also:</span></dt>
738 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_SENDS">Constant Field Values</a></dd>
739 </dl>
740 </section>
741 </li>
742 <li class="blockList">
743 <section class="detail">
744 <h3><a id="TRACE_RECEIVES">TRACE_RECEIVES</a></h3>
745 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_RECEIVES</span></div>
746 <div class="block">Tracing enabled for JDWP packets received from target VM.</div>
747 <dl>
748 <dt><span class="seeLabel">See Also:</span></dt>
749 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_RECEIVES">Constant Field Values</a></dd>
750 </dl>
751 </section>
752 </li>
753 <li class="blockList">
754 <section class="detail">
755 <h3><a id="TRACE_EVENTS">TRACE_EVENTS</a></h3>
756 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_EVENTS</span></div>
757 <div class="block">Tracing enabled for internal event handling.</div>
758 <dl>
759 <dt><span class="seeLabel">See Also:</span></dt>
760 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_EVENTS">Constant Field Values</a></dd>
761 </dl>
762 </section>
763 </li>
764 <li class="blockList">
765 <section class="detail">
766 <h3><a id="TRACE_REFTYPES">TRACE_REFTYPES</a></h3>
767 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_REFTYPES</span></div>
768 <div class="block">Tracing enabled for internal managment of reference types.</div>
769 <dl>
770 <dt><span class="seeLabel">See Also:</span></dt>
771 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_REFTYPES">Constant Field Values</a></dd>
772 </dl>
773 </section>
774 </li>
775 <li class="blockList">
776 <section class="detail">
777 <h3><a id="TRACE_OBJREFS">TRACE_OBJREFS</a></h3>
778 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_OBJREFS</span></div>
779 <div class="block">Tracing enabled for internal management of object references.</div>
780 <dl>
781 <dt><span class="seeLabel">See Also:</span></dt>
782 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_OBJREFS">Constant Field Values</a></dd>
783 </dl>
784 </section>
785 </li>
786 <li class="blockList">
787 <section class="detail">
788 <h3><a id="TRACE_ALL">TRACE_ALL</a></h3>
789 <div class="memberSignature"><span class="modifiers">static final</span> <span class="returnType">int</span> <span class="memberName">TRACE_ALL</span></div>
790 <div class="block">All tracing is enabled.</div>
791 <dl>
792 <dt><span class="seeLabel">See Also:</span></dt>
793 <dd><a href="../../../../constant-values.html#com.sun.jdi.VirtualMachine.TRACE_ALL">Constant Field Values</a></dd>
794 </dl>
795 </section>
796 </li>
797 </ul>
798 </section>
799 </li>
800 <!-- ============ METHOD DETAIL ========== -->
801 <li class="blockList">
802 <section class="methodDetails"><a id="method.detail">
803 <!-- -->
804 </a>
805 <h2>Method Details</h2>
806 <ul class="blockList">
807 <li class="blockList">
808 <section class="detail">
809 <h3><a id="allModules()">allModules</a></h3>
810 <div class="memberSignature"><span class="modifiers">default</span> <span class="returnType"><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ModuleReference.html" title="interface in com.sun.jdi">ModuleReference</a>></span> <span class="memberName">allModules</span>()</div>
811 <div class="block">Returns all modules. For each module in the target
812 VM a <a href="ModuleReference.html" title="interface in com.sun.jdi"><code>ModuleReference</code></a> will be placed in the returned list.
813 <P>
814
815 Not all target virtual machines support this operation.
816 Use <a href="#canGetModuleInfo()"><code>canGetModuleInfo()</code></a>
817 to determine if the operation is supported.</div>
818 <dl>
819 <dt><span class="simpleTagLabel">Implementation Requirements:</span></dt>
820 <dd>The default implementation throws <code>UnsupportedOperationException</code>.</dd>
821 <dt><span class="returnLabel">Returns:</span></dt>
822 <dd>a list of <a href="ModuleReference.html" title="interface in com.sun.jdi"><code>ModuleReference</code></a> objects, each mirroring
823 a module in the target VM.</dd>
824 <dt><span class="throwsLabel">Throws:</span></dt>
825 <dd><code><a href="../../../../java.base/java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - if
826 the target virtual machine does not support this
827 operation.</dd>
828 <dt><span class="simpleTagLabel">Since:</span></dt>
829 <dd>9</dd>
830 </dl>
831 </section>
832 </li>
833 <li class="blockList">
834 <section class="detail">
835 <h3><a id="classesByName(java.lang.String)">classesByName</a></h3>
836 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>></span> <span class="memberName">classesByName</span>(<span class="arguments"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a> className)</span></div>
837 <div class="block">Returns the loaded reference types that
838 match a given name. The name must be fully qualified
839 (for example, java.lang.String). The returned list
840 will contain a <a href="ReferenceType.html" title="interface in com.sun.jdi"><code>ReferenceType</code></a> for each class
841 or interface found with the given name. The search
842 is confined to loaded classes only; no attempt is made
843 to load a class of the given name.
844 <P>
845 The returned list will include reference types
846 loaded at least to the point of preparation and
847 types (like array) for which preparation is
848 not defined.</div>
849 <dl>
850 <dt><span class="paramLabel">Parameters:</span></dt>
851 <dd><code>className</code> - the class/interface name to search for</dd>
852 <dt><span class="returnLabel">Returns:</span></dt>
853 <dd>a list of <a href="ReferenceType.html" title="interface in com.sun.jdi"><code>ReferenceType</code></a> objects, each
854 mirroring a type in the target VM with the given name.</dd>
855 </dl>
856 </section>
857 </li>
858 <li class="blockList">
859 <section class="detail">
860 <h3><a id="allClasses()">allClasses</a></h3>
861 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>></span> <span class="memberName">allClasses</span>()</div>
862 <div class="block">Returns all loaded types. For each loaded type in the target
863 VM a <a href="ReferenceType.html" title="interface in com.sun.jdi"><code>ReferenceType</code></a> will be placed in the returned list.
864 The list will include ReferenceTypes which mirror classes,
865 interfaces, and array types.
866 <P>
867 The returned list will include reference types
868 loaded at least to the point of preparation and
869 types (like array) for which preparation is
870 not defined.</div>
871 <dl>
872 <dt><span class="returnLabel">Returns:</span></dt>
873 <dd>a list of <a href="ReferenceType.html" title="interface in com.sun.jdi"><code>ReferenceType</code></a> objects, each mirroring
874 a loaded type in the target VM.</dd>
875 </dl>
876 </section>
877 </li>
878 <li class="blockList">
879 <section class="detail">
880 <h3><a id="redefineClasses(java.util.Map)">redefineClasses</a></h3>
881 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">redefineClasses</span>(<span class="arguments"><a href="../../../../java.base/java/util/Map.html" title="interface in java.util">Map</a><? extends <a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>,byte[]> classToBytes)</span></div>
882 <div class="block">All classes given are redefined according to the
883 definitions supplied. A method in a redefined class
884 is called 'equivalent' (to the old version of the
885 method) if
886 <UL>
887 <LI>their bytecodes are the same except for indicies into
888 the constant pool, and
889 <LI>the referenced constants are equal.
890 </UL>
891 Otherwise, the new method is called 'non-equivalent'.
892 If a redefined method has active stack frames, those active
893 frames continue to run the bytecodes of the previous version of the
894 method. If the new version of such a method is non-equivalent,
895 then a method from one of these active frames is called 'obsolete' and
896 <a href="Method.html#isObsolete()"><code>Method.isObsolete()</code></a>
897 will return true when called on one of these methods.
898 If resetting such a frame is desired, use
899 <a href="ThreadReference.html#popFrames(com.sun.jdi.StackFrame)"><code>ThreadReference.popFrames(StackFrame)</code></a>
900 to pop the old obsolete method execution from the stack.
901 New invocations of redefined methods will always invoke the new versions.
902 <p>
903 This function does not cause any initialization except
904 that which would occur under the customary JVM semantics.
905 In other words, redefining a class does not cause
906 its initializers to be run. The values of preexisting
907 static variables will remain as they were prior to the
908 call. However, completely uninitialized (new) static
909 variables will be assigned their default value.
910 <p>
911 If a redefined class has instances then all those
912 instances will have the fields defined by the redefined
913 class at the completion of the call. Preexisting fields
914 will retain their previous values. Any new fields will
915 have their default values; no instance initializers or
916 constructors are run.
917 <p>
918 Threads need not be suspended.
919 <p>
920 No events are generated by this function.
921 <p>
922 All breakpoints in the redefined classes are deleted.
923 <p>
924 Not all target virtual machines support this operation.
925 Use <a href="#canRedefineClasses()"><code>canRedefineClasses()</code></a>
926 to determine if the operation is supported.
927 Use <a href="#canAddMethod()"><code>canAddMethod()</code></a>
928 to determine if the redefinition can add methods.
929 Use <a href="#canUnrestrictedlyRedefineClasses()"><code>canUnrestrictedlyRedefineClasses()</code></a>
930 to determine if the redefinition can change the schema,
931 delete methods, change the class hierarchy, etc.</div>
932 <dl>
933 <dt><span class="paramLabel">Parameters:</span></dt>
934 <dd><code>classToBytes</code> - A map from <a href="ReferenceType.html" title="interface in com.sun.jdi"><code>ReferenceType</code></a>
935 to array of byte.
936 The bytes represent the new class definition and
937 are in Java Virtual Machine class file format.</dd>
938 <dt><span class="throwsLabel">Throws:</span></dt>
939 <dd><code><a href="../../../../java.base/java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - if
940 the target virtual machine does not support this
941 operation.
942 <UL>
943 <LI>If <a href="#canRedefineClasses()"><code>canRedefineClasses()</code></a>
944 is false any call of this method will throw this exception.
945 <LI>If <a href="#canAddMethod()"><code>canAddMethod()</code></a> is false
946 attempting to add a method will throw this exception.
947 <LI>If <a href="#canUnrestrictedlyRedefineClasses()"><code>canUnrestrictedlyRedefineClasses()</code></a>
948 is false, attempting any of the following will throw
949 this exception
950 <UL>
951 <LI>changing the schema (the fields)
952 <LI>changing the hierarchy (superclasses, interfaces)
953 <LI>deleting a method
954 <LI>changing class modifiers
955 <LI>changing method modifiers
956 <LI>changing the <code>NestHost</code>, <code>NestMembers</code>, or <code>Record</code> class attributes
957 </UL>
958 </UL></dd>
959 <dd><code><a href="../../../../java.base/java/lang/NoClassDefFoundError.html" title="class in java.lang">NoClassDefFoundError</a></code> - if the bytes
960 don't correspond to the reference type (the names
961 don't match).</dd>
962 <dd><code><a href="../../../../java.base/java/lang/VerifyError.html" title="class in java.lang">VerifyError</a></code> - if a "verifier" detects
963 that a class, though well formed, contains an internal
964 inconsistency or security problem.</dd>
965 <dd><code><a href="../../../../java.base/java/lang/ClassFormatError.html" title="class in java.lang">ClassFormatError</a></code> - if the bytes
966 do not represent a valid class.</dd>
967 <dd><code><a href="../../../../java.base/java/lang/ClassCircularityError.html" title="class in java.lang">ClassCircularityError</a></code> - if a
968 circularity has been detected while initializing a class.</dd>
969 <dd><code><a href="../../../../java.base/java/lang/UnsupportedClassVersionError.html" title="class in java.lang">UnsupportedClassVersionError</a></code> - if the
970 major and minor version numbers in bytes
971 are not supported by the VM.</dd>
972 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only - see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
973 <dt><span class="simpleTagLabel">Since:</span></dt>
974 <dd>1.4</dd>
975 <dt><span class="seeLabel">See Also:</span></dt>
976 <dd><a href="Method.html#isObsolete()"><code>Method.isObsolete()</code></a>,
977 <a href="ThreadReference.html#popFrames(com.sun.jdi.StackFrame)"><code>ThreadReference.popFrames(com.sun.jdi.StackFrame)</code></a>,
978 <a href="#canRedefineClasses()"><code>canRedefineClasses()</code></a>,
979 <a href="#canAddMethod()"><code>canAddMethod()</code></a>,
980 <a href="#canUnrestrictedlyRedefineClasses()"><code>canUnrestrictedlyRedefineClasses()</code></a></dd>
981 </dl>
982 </section>
983 </li>
984 <li class="blockList">
985 <section class="detail">
986 <h3><a id="allThreads()">allThreads</a></h3>
987 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ThreadReference.html" title="interface in com.sun.jdi">ThreadReference</a>></span> <span class="memberName">allThreads</span>()</div>
988 <div class="block">Returns a list of the currently running threads. For each
989 running thread in the target VM, a <a href="ThreadReference.html" title="interface in com.sun.jdi"><code>ThreadReference</code></a>
990 that mirrors it is placed in the list.
991 The returned list contains threads created through
992 java.lang.Thread, all native threads attached to
993 the target VM through JNI, and system threads created
994 by the target VM. Thread objects that have
995 not yet been started
996 (see <a href="../../../../java.base/java/lang/Thread.html#start()"><code>Thread.start()</code></a>)
997 and thread objects that have
998 completed their execution are not included in the returned list.</div>
999 <dl>
1000 <dt><span class="returnLabel">Returns:</span></dt>
1001 <dd>a list of <a href="ThreadReference.html" title="interface in com.sun.jdi"><code>ThreadReference</code></a> objects, one for each
1002 running thread in the mirrored VM.</dd>
1003 </dl>
1004 </section>
1005 </li>
1006 <li class="blockList">
1007 <section class="detail">
1008 <h3><a id="suspend()">suspend</a></h3>
1009 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">suspend</span>()</div>
1010 <div class="block">Suspends the execution of the application running in this
1011 virtual machine. All threads currently running will be suspended.
1012 <p>
1013 Unlike <a href="../../../../java.base/java/lang/Thread.html#suspend()"><code>Thread.suspend()</code></a>,
1014 suspends of both the virtual machine and individual threads are
1015 counted. Before a thread will run again, it must be resumed
1016 (through <a href="#resume()"><code>resume()</code></a> or <a href="ThreadReference.html#resume()"><code>ThreadReference.resume()</code></a>)
1017 the same number of times it has been suspended.</div>
1018 <dl>
1019 <dt><span class="throwsLabel">Throws:</span></dt>
1020 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only - see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1021 </dl>
1022 </section>
1023 </li>
1024 <li class="blockList">
1025 <section class="detail">
1026 <h3><a id="resume()">resume</a></h3>
1027 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">resume</span>()</div>
1028 <div class="block">Continues the execution of the application running in this
1029 virtual machine. All threads are resumed as documented in
1030 <a href="ThreadReference.html#resume()"><code>ThreadReference.resume()</code></a>.</div>
1031 <dl>
1032 <dt><span class="throwsLabel">Throws:</span></dt>
1033 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only - see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1034 <dt><span class="seeLabel">See Also:</span></dt>
1035 <dd><a href="#suspend()"><code>suspend()</code></a></dd>
1036 </dl>
1037 </section>
1038 </li>
1039 <li class="blockList">
1040 <section class="detail">
1041 <h3><a id="topLevelThreadGroups()">topLevelThreadGroups</a></h3>
1042 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><<a href="ThreadGroupReference.html" title="interface in com.sun.jdi">ThreadGroupReference</a>></span> <span class="memberName">topLevelThreadGroups</span>()</div>
1043 <div class="block">Returns each thread group which does not have a parent. For each
1044 top level thread group a <a href="ThreadGroupReference.html" title="interface in com.sun.jdi"><code>ThreadGroupReference</code></a> is placed in the
1045 returned list.
1046 <p>
1047 This command may be used as the first step in building a tree
1048 (or trees) of the existing thread groups.</div>
1049 <dl>
1050 <dt><span class="returnLabel">Returns:</span></dt>
1051 <dd>a list of <a href="ThreadGroupReference.html" title="interface in com.sun.jdi"><code>ThreadGroupReference</code></a> objects, one for each
1052 top level thread group.</dd>
1053 </dl>
1054 </section>
1055 </li>
1056 <li class="blockList">
1057 <section class="detail">
1058 <h3><a id="eventQueue()">eventQueue</a></h3>
1059 <div class="memberSignature"><span class="returnType"><a href="event/EventQueue.html" title="interface in com.sun.jdi.event">EventQueue</a></span> <span class="memberName">eventQueue</span>()</div>
1060 <div class="block">Returns the event queue for this virtual machine.
1061 A virtual machine has only one <a href="event/EventQueue.html" title="interface in com.sun.jdi.event"><code>EventQueue</code></a> object, this
1062 method will return the same instance each time it
1063 is invoked.</div>
1064 <dl>
1065 <dt><span class="returnLabel">Returns:</span></dt>
1066 <dd>the <a href="event/EventQueue.html" title="interface in com.sun.jdi.event"><code>EventQueue</code></a> for this virtual machine.</dd>
1067 <dt><span class="throwsLabel">Throws:</span></dt>
1068 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only - see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1069 </dl>
1070 </section>
1071 </li>
1072 <li class="blockList">
1073 <section class="detail">
1074 <h3><a id="eventRequestManager()">eventRequestManager</a></h3>
1075 <div class="memberSignature"><span class="returnType"><a href="request/EventRequestManager.html" title="interface in com.sun.jdi.request">EventRequestManager</a></span> <span class="memberName">eventRequestManager</span>()</div>
1076 <div class="block">Returns the event request manager for this virtual machine.
1077 The <a href="request/EventRequestManager.html" title="interface in com.sun.jdi.request"><code>EventRequestManager</code></a> controls user settable events
1078 such as breakpoints.
1079 A virtual machine has only one <a href="request/EventRequestManager.html" title="interface in com.sun.jdi.request"><code>EventRequestManager</code></a> object,
1080 this method will return the same instance each time it
1081 is invoked.</div>
1082 <dl>
1083 <dt><span class="returnLabel">Returns:</span></dt>
1084 <dd>the <a href="request/EventRequestManager.html" title="interface in com.sun.jdi.request"><code>EventRequestManager</code></a> for this virtual machine.</dd>
1085 <dt><span class="throwsLabel">Throws:</span></dt>
1086 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only - see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1087 </dl>
1088 </section>
1089 </li>
1090 <li class="blockList">
1091 <section class="detail">
1092 <h3><a id="mirrorOf(boolean)">mirrorOf</a></h3>
1093 <div class="memberSignature"><span class="returnType"><a href="BooleanValue.html" title="interface in com.sun.jdi">BooleanValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">boolean value)</span></div>
1094 <div class="block">Creates a <a href="BooleanValue.html" title="interface in com.sun.jdi"><code>BooleanValue</code></a> for the given value. This value
1095 can be used for setting and comparing against a value retrieved
1096 from a variable or field in this virtual machine.</div>
1097 <dl>
1098 <dt><span class="paramLabel">Parameters:</span></dt>
1099 <dd><code>value</code> - a boolean for which to create the value</dd>
1100 <dt><span class="returnLabel">Returns:</span></dt>
1101 <dd>the <a href="BooleanValue.html" title="interface in com.sun.jdi"><code>BooleanValue</code></a> for the given boolean.</dd>
1102 </dl>
1103 </section>
1104 </li>
1105 <li class="blockList">
1106 <section class="detail">
1107 <h3><a id="mirrorOf(byte)">mirrorOf</a></h3>
1108 <div class="memberSignature"><span class="returnType"><a href="ByteValue.html" title="interface in com.sun.jdi">ByteValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">byte value)</span></div>
1109 <div class="block">Creates a <a href="ByteValue.html" title="interface in com.sun.jdi"><code>ByteValue</code></a> for the given value. This value
1110 can be used for setting and comparing against a value retrieved
1111 from a variable or field in this virtual machine.</div>
1112 <dl>
1113 <dt><span class="paramLabel">Parameters:</span></dt>
1114 <dd><code>value</code> - a byte for which to create the value</dd>
1115 <dt><span class="returnLabel">Returns:</span></dt>
1116 <dd>the <a href="ByteValue.html" title="interface in com.sun.jdi"><code>ByteValue</code></a> for the given byte.</dd>
1117 </dl>
1118 </section>
1119 </li>
1120 <li class="blockList">
1121 <section class="detail">
1122 <h3><a id="mirrorOf(char)">mirrorOf</a></h3>
1123 <div class="memberSignature"><span class="returnType"><a href="CharValue.html" title="interface in com.sun.jdi">CharValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">char value)</span></div>
1124 <div class="block">Creates a <a href="CharValue.html" title="interface in com.sun.jdi"><code>CharValue</code></a> for the given value. This value
1125 can be used for setting and comparing against a value retrieved
1126 from a variable or field in this virtual machine.</div>
1127 <dl>
1128 <dt><span class="paramLabel">Parameters:</span></dt>
1129 <dd><code>value</code> - a char for which to create the value</dd>
1130 <dt><span class="returnLabel">Returns:</span></dt>
1131 <dd>the <a href="CharValue.html" title="interface in com.sun.jdi"><code>CharValue</code></a> for the given char.</dd>
1132 </dl>
1133 </section>
1134 </li>
1135 <li class="blockList">
1136 <section class="detail">
1137 <h3><a id="mirrorOf(short)">mirrorOf</a></h3>
1138 <div class="memberSignature"><span class="returnType"><a href="ShortValue.html" title="interface in com.sun.jdi">ShortValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">short value)</span></div>
1139 <div class="block">Creates a <a href="ShortValue.html" title="interface in com.sun.jdi"><code>ShortValue</code></a> for the given value. This value
1140 can be used for setting and comparing against a value retrieved
1141 from a variable or field in this virtual machine.</div>
1142 <dl>
1143 <dt><span class="paramLabel">Parameters:</span></dt>
1144 <dd><code>value</code> - a short for which to create the value</dd>
1145 <dt><span class="returnLabel">Returns:</span></dt>
1146 <dd>the <a href="ShortValue.html" title="interface in com.sun.jdi"><code>ShortValue</code></a> for the given short.</dd>
1147 </dl>
1148 </section>
1149 </li>
1150 <li class="blockList">
1151 <section class="detail">
1152 <h3><a id="mirrorOf(int)">mirrorOf</a></h3>
1153 <div class="memberSignature"><span class="returnType"><a href="IntegerValue.html" title="interface in com.sun.jdi">IntegerValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">int value)</span></div>
1154 <div class="block">Creates an <a href="IntegerValue.html" title="interface in com.sun.jdi"><code>IntegerValue</code></a> for the given value. This value
1155 can be used for setting and comparing against a value retrieved
1156 from a variable or field in this virtual machine.</div>
1157 <dl>
1158 <dt><span class="paramLabel">Parameters:</span></dt>
1159 <dd><code>value</code> - an int for which to create the value</dd>
1160 <dt><span class="returnLabel">Returns:</span></dt>
1161 <dd>the <a href="IntegerValue.html" title="interface in com.sun.jdi"><code>IntegerValue</code></a> for the given int.</dd>
1162 </dl>
1163 </section>
1164 </li>
1165 <li class="blockList">
1166 <section class="detail">
1167 <h3><a id="mirrorOf(long)">mirrorOf</a></h3>
1168 <div class="memberSignature"><span class="returnType"><a href="LongValue.html" title="interface in com.sun.jdi">LongValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">long value)</span></div>
1169 <div class="block">Creates a <a href="LongValue.html" title="interface in com.sun.jdi"><code>LongValue</code></a> for the given value. This value
1170 can be used for setting and comparing against a value retrieved
1171 from a variable or field in this virtual machine.</div>
1172 <dl>
1173 <dt><span class="paramLabel">Parameters:</span></dt>
1174 <dd><code>value</code> - a long for which to create the value</dd>
1175 <dt><span class="returnLabel">Returns:</span></dt>
1176 <dd>the <a href="LongValue.html" title="interface in com.sun.jdi"><code>LongValue</code></a> for the given long.</dd>
1177 </dl>
1178 </section>
1179 </li>
1180 <li class="blockList">
1181 <section class="detail">
1182 <h3><a id="mirrorOf(float)">mirrorOf</a></h3>
1183 <div class="memberSignature"><span class="returnType"><a href="FloatValue.html" title="interface in com.sun.jdi">FloatValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">float value)</span></div>
1184 <div class="block">Creates a <a href="FloatValue.html" title="interface in com.sun.jdi"><code>FloatValue</code></a> for the given value. This value
1185 can be used for setting and comparing against a value retrieved
1186 from a variable or field in this virtual machine.</div>
1187 <dl>
1188 <dt><span class="paramLabel">Parameters:</span></dt>
1189 <dd><code>value</code> - a float for which to create the value</dd>
1190 <dt><span class="returnLabel">Returns:</span></dt>
1191 <dd>the <a href="FloatValue.html" title="interface in com.sun.jdi"><code>FloatValue</code></a> for the given float.</dd>
1192 </dl>
1193 </section>
1194 </li>
1195 <li class="blockList">
1196 <section class="detail">
1197 <h3><a id="mirrorOf(double)">mirrorOf</a></h3>
1198 <div class="memberSignature"><span class="returnType"><a href="DoubleValue.html" title="interface in com.sun.jdi">DoubleValue</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments">double value)</span></div>
1199 <div class="block">Creates a <a href="DoubleValue.html" title="interface in com.sun.jdi"><code>DoubleValue</code></a> for the given value. This value
1200 can be used for setting and comparing against a value retrieved
1201 from a variable or field in this virtual machine.</div>
1202 <dl>
1203 <dt><span class="paramLabel">Parameters:</span></dt>
1204 <dd><code>value</code> - a double for which to create the value</dd>
1205 <dt><span class="returnLabel">Returns:</span></dt>
1206 <dd>the <a href="DoubleValue.html" title="interface in com.sun.jdi"><code>DoubleValue</code></a> for the given double.</dd>
1207 </dl>
1208 </section>
1209 </li>
1210 <li class="blockList">
1211 <section class="detail">
1212 <h3><a id="mirrorOf(java.lang.String)">mirrorOf</a></h3>
1213 <div class="memberSignature"><span class="returnType"><a href="StringReference.html" title="interface in com.sun.jdi">StringReference</a></span> <span class="memberName">mirrorOf</span>(<span class="arguments"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a> value)</span></div>
1214 <div class="block">Creates a string in this virtual machine.
1215 The created string can be used for setting and comparing against
1216 a string value retrieved from a variable or field in this
1217 virtual machine.</div>
1218 <dl>
1219 <dt><span class="paramLabel">Parameters:</span></dt>
1220 <dd><code>value</code> - the string to be created</dd>
1221 <dt><span class="returnLabel">Returns:</span></dt>
1222 <dd>a <a href="StringReference.html" title="interface in com.sun.jdi"><code>StringReference</code></a> that mirrors the newly created
1223 string in the target VM.</dd>
1224 <dt><span class="throwsLabel">Throws:</span></dt>
1225 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only
1226 -see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1227 </dl>
1228 </section>
1229 </li>
1230 <li class="blockList">
1231 <section class="detail">
1232 <h3><a id="mirrorOfVoid()">mirrorOfVoid</a></h3>
1233 <div class="memberSignature"><span class="returnType"><a href="VoidValue.html" title="interface in com.sun.jdi">VoidValue</a></span> <span class="memberName">mirrorOfVoid</span>()</div>
1234 <div class="block">Creates a <a href="VoidValue.html" title="interface in com.sun.jdi"><code>VoidValue</code></a>. This value
1235 can be passed to <a href="ThreadReference.html#forceEarlyReturn(com.sun.jdi.Value)"><code>ThreadReference.forceEarlyReturn(com.sun.jdi.Value)</code></a>
1236 when a void method is to be exited.</div>
1237 <dl>
1238 <dt><span class="returnLabel">Returns:</span></dt>
1239 <dd>the <a href="VoidValue.html" title="interface in com.sun.jdi"><code>VoidValue</code></a>.</dd>
1240 </dl>
1241 </section>
1242 </li>
1243 <li class="blockList">
1244 <section class="detail">
1245 <h3><a id="process()">process</a></h3>
1246 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/lang/Process.html" title="class in java.lang">Process</a></span> <span class="memberName">process</span>()</div>
1247 <div class="block">Returns the <a href="../../../../java.base/java/lang/Process.html" title="class in java.lang"><code>Process</code></a> object for this
1248 virtual machine if launched by a <a href="connect/LaunchingConnector.html" title="interface in com.sun.jdi.connect"><code>LaunchingConnector</code></a></div>
1249 <dl>
1250 <dt><span class="returnLabel">Returns:</span></dt>
1251 <dd>the <a href="../../../../java.base/java/lang/Process.html" title="class in java.lang"><code>Process</code></a> object for this virtual
1252 machine, or null if it was not launched by a <a href="connect/LaunchingConnector.html" title="interface in com.sun.jdi.connect"><code>LaunchingConnector</code></a>.</dd>
1253 <dt><span class="throwsLabel">Throws:</span></dt>
1254 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only
1255 -see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1256 </dl>
1257 </section>
1258 </li>
1259 <li class="blockList">
1260 <section class="detail">
1261 <h3><a id="dispose()">dispose</a></h3>
1262 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">dispose</span>()</div>
1263 <div class="block">Invalidates this virtual machine mirror.
1264 The communication channel to the target VM is closed, and
1265 the target VM prepares to accept another subsequent connection
1266 from this debugger or another debugger, including the
1267 following tasks:
1268 <ul>
1269 <li>All event requests are cancelled.
1270 <li>All threads suspended by <a href="#suspend()"><code>suspend()</code></a> or by
1271 <a href="ThreadReference.html#suspend()"><code>ThreadReference.suspend()</code></a> are resumed as many
1272 times as necessary for them to run.
1273 <li>Garbage collection is re-enabled in all cases where it was
1274 disabled through <a href="ObjectReference.html#disableCollection()"><code>ObjectReference.disableCollection()</code></a>.
1275 </ul>
1276 Any current method invocations executing in the target VM
1277 are continued after the disconnection. Upon completion of any such
1278 method invocation, the invoking thread continues from the
1279 location where it was originally stopped.
1280 <p>
1281 Resources originating in
1282 this VirtualMachine (ObjectReferences, ReferenceTypes, etc.)
1283 will become invalid.</div>
1284 </section>
1285 </li>
1286 <li class="blockList">
1287 <section class="detail">
1288 <h3><a id="exit(int)">exit</a></h3>
1289 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">exit</span>(<span class="arguments">int exitCode)</span></div>
1290 <div class="block">Causes the mirrored VM to terminate with the given error code.
1291 All resources associated with this VirtualMachine are freed.
1292 If the mirrored VM is remote, the communication channel
1293 to it will be closed. Resources originating in
1294 this VirtualMachine (ObjectReferences, ReferenceTypes, etc.)
1295 will become invalid.
1296 <p>
1297 Threads running in the mirrored VM are abruptly terminated.
1298 A thread death exception is not thrown and
1299 finally blocks are not run.</div>
1300 <dl>
1301 <dt><span class="paramLabel">Parameters:</span></dt>
1302 <dd><code>exitCode</code> - the exit code for the target VM. On some platforms,
1303 the exit code might be truncated, for example, to the lower order 8 bits.</dd>
1304 <dt><span class="throwsLabel">Throws:</span></dt>
1305 <dd><code><a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi">VMCannotBeModifiedException</a></code> - if the VirtualMachine is read-only - see <a href="#canBeModified()"><code>canBeModified()</code></a>.</dd>
1306 </dl>
1307 </section>
1308 </li>
1309 <li class="blockList">
1310 <section class="detail">
1311 <h3><a id="canWatchFieldModification()">canWatchFieldModification</a></h3>
1312 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canWatchFieldModification</span>()</div>
1313 <div class="block">Determines if the target VM supports watchpoints
1314 for field modification.</div>
1315 <dl>
1316 <dt><span class="returnLabel">Returns:</span></dt>
1317 <dd><code>true</code> if the feature is supported,
1318 <code>false</code> otherwise.</dd>
1319 </dl>
1320 </section>
1321 </li>
1322 <li class="blockList">
1323 <section class="detail">
1324 <h3><a id="canWatchFieldAccess()">canWatchFieldAccess</a></h3>
1325 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canWatchFieldAccess</span>()</div>
1326 <div class="block">Determines if the target VM supports watchpoints
1327 for field access.</div>
1328 <dl>
1329 <dt><span class="returnLabel">Returns:</span></dt>
1330 <dd><code>true</code> if the feature is supported,
1331 <code>false</code> otherwise.</dd>
1332 </dl>
1333 </section>
1334 </li>
1335 <li class="blockList">
1336 <section class="detail">
1337 <h3><a id="canGetBytecodes()">canGetBytecodes</a></h3>
1338 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetBytecodes</span>()</div>
1339 <div class="block">Determines if the target VM supports the retrieval
1340 of a method's bytecodes.</div>
1341 <dl>
1342 <dt><span class="returnLabel">Returns:</span></dt>
1343 <dd><code>true</code> if the feature is supported,
1344 <code>false</code> otherwise.</dd>
1345 </dl>
1346 </section>
1347 </li>
1348 <li class="blockList">
1349 <section class="detail">
1350 <h3><a id="canGetSyntheticAttribute()">canGetSyntheticAttribute</a></h3>
1351 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetSyntheticAttribute</span>()</div>
1352 <div class="block">Determines if the target VM supports the query
1353 of the synthetic attribute of a method or field.</div>
1354 <dl>
1355 <dt><span class="returnLabel">Returns:</span></dt>
1356 <dd><code>true</code> if the feature is supported,
1357 <code>false</code> otherwise.</dd>
1358 </dl>
1359 </section>
1360 </li>
1361 <li class="blockList">
1362 <section class="detail">
1363 <h3><a id="canGetOwnedMonitorInfo()">canGetOwnedMonitorInfo</a></h3>
1364 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetOwnedMonitorInfo</span>()</div>
1365 <div class="block">Determines if the target VM supports the retrieval
1366 of the monitors owned by a thread.</div>
1367 <dl>
1368 <dt><span class="returnLabel">Returns:</span></dt>
1369 <dd><code>true</code> if the feature is supported,
1370 <code>false</code> otherwise.</dd>
1371 </dl>
1372 </section>
1373 </li>
1374 <li class="blockList">
1375 <section class="detail">
1376 <h3><a id="canGetCurrentContendedMonitor()">canGetCurrentContendedMonitor</a></h3>
1377 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetCurrentContendedMonitor</span>()</div>
1378 <div class="block">Determines if the target VM supports the retrieval
1379 of the monitor for which a thread is currently waiting.</div>
1380 <dl>
1381 <dt><span class="returnLabel">Returns:</span></dt>
1382 <dd><code>true</code> if the feature is supported,
1383 <code>false</code> otherwise.</dd>
1384 </dl>
1385 </section>
1386 </li>
1387 <li class="blockList">
1388 <section class="detail">
1389 <h3><a id="canGetMonitorInfo()">canGetMonitorInfo</a></h3>
1390 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetMonitorInfo</span>()</div>
1391 <div class="block">Determines if the target VM supports the retrieval
1392 of the monitor information for an object.</div>
1393 <dl>
1394 <dt><span class="returnLabel">Returns:</span></dt>
1395 <dd><code>true</code> if the feature is supported,
1396 <code>false</code> otherwise.</dd>
1397 </dl>
1398 </section>
1399 </li>
1400 <li class="blockList">
1401 <section class="detail">
1402 <h3><a id="canUseInstanceFilters()">canUseInstanceFilters</a></h3>
1403 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canUseInstanceFilters</span>()</div>
1404 <div class="block">Determines if the target VM supports filtering
1405 events by specific instance object. For example,
1406 see <a href="request/BreakpointRequest.html#addInstanceFilter(com.sun.jdi.ObjectReference)"><code>BreakpointRequest.addInstanceFilter(com.sun.jdi.ObjectReference)</code></a>.</div>
1407 <dl>
1408 <dt><span class="returnLabel">Returns:</span></dt>
1409 <dd><code>true</code> if the feature is supported,
1410 <code>false</code> otherwise.</dd>
1411 </dl>
1412 </section>
1413 </li>
1414 <li class="blockList">
1415 <section class="detail">
1416 <h3><a id="canRedefineClasses()">canRedefineClasses</a></h3>
1417 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canRedefineClasses</span>()</div>
1418 <div class="block">Determines if the target VM supports any level
1419 of class redefinition.</div>
1420 <dl>
1421 <dt><span class="returnLabel">Returns:</span></dt>
1422 <dd><code>true</code> if the feature is supported,
1423 <code>false</code> otherwise.</dd>
1424 <dt><span class="simpleTagLabel">Since:</span></dt>
1425 <dd>1.4</dd>
1426 <dt><span class="seeLabel">See Also:</span></dt>
1427 <dd><a href="#redefineClasses(java.util.Map)"><code>redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)</code></a></dd>
1428 </dl>
1429 </section>
1430 </li>
1431 <li class="blockList">
1432 <section class="detail">
1433 <h3><a id="canAddMethod()">canAddMethod</a></h3>
1434 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canAddMethod</span>()</div>
1435 <div class="block">Determines if the target VM supports the addition
1436 of methods when performing class redefinition.</div>
1437 <dl>
1438 <dt><span class="returnLabel">Returns:</span></dt>
1439 <dd><code>true</code> if the feature is supported,
1440 <code>false</code> otherwise.</dd>
1441 <dt><span class="simpleTagLabel">Since:</span></dt>
1442 <dd>1.4</dd>
1443 <dt><span class="seeLabel">See Also:</span></dt>
1444 <dd><a href="#redefineClasses(java.util.Map)"><code>redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)</code></a></dd>
1445 </dl>
1446 </section>
1447 </li>
1448 <li class="blockList">
1449 <section class="detail">
1450 <h3><a id="canUnrestrictedlyRedefineClasses()">canUnrestrictedlyRedefineClasses</a></h3>
1451 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canUnrestrictedlyRedefineClasses</span>()</div>
1452 <div class="block">Determines if the target VM supports
1453 changes when performing class redefinition that are
1454 otherwise restricted by <a href="#redefineClasses(java.util.Map)"><code>redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)</code></a>.</div>
1455 <dl>
1456 <dt><span class="returnLabel">Returns:</span></dt>
1457 <dd><code>true</code> if the feature is supported,
1458 <code>false</code> otherwise.</dd>
1459 <dt><span class="simpleTagLabel">Since:</span></dt>
1460 <dd>1.4</dd>
1461 <dt><span class="seeLabel">See Also:</span></dt>
1462 <dd><a href="#redefineClasses(java.util.Map)"><code>redefineClasses(java.util.Map<? extends com.sun.jdi.ReferenceType, byte[]>)</code></a></dd>
1463 </dl>
1464 </section>
1465 </li>
1466 <li class="blockList">
1467 <section class="detail">
1468 <h3><a id="canPopFrames()">canPopFrames</a></h3>
1469 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canPopFrames</span>()</div>
1470 <div class="block">Determines if the target VM supports popping
1471 frames of a threads stack.</div>
1472 <dl>
1473 <dt><span class="returnLabel">Returns:</span></dt>
1474 <dd><code>true</code> if the feature is supported,
1475 <code>false</code> otherwise.</dd>
1476 <dt><span class="simpleTagLabel">Since:</span></dt>
1477 <dd>1.4</dd>
1478 <dt><span class="seeLabel">See Also:</span></dt>
1479 <dd><a href="ThreadReference.html#popFrames(com.sun.jdi.StackFrame)"><code>ThreadReference.popFrames(com.sun.jdi.StackFrame)</code></a></dd>
1480 </dl>
1481 </section>
1482 </li>
1483 <li class="blockList">
1484 <section class="detail">
1485 <h3><a id="canGetSourceDebugExtension()">canGetSourceDebugExtension</a></h3>
1486 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetSourceDebugExtension</span>()</div>
1487 <div class="block">Determines if the target VM supports getting
1488 the source debug extension.</div>
1489 <dl>
1490 <dt><span class="returnLabel">Returns:</span></dt>
1491 <dd><code>true</code> if the feature is supported,
1492 <code>false</code> otherwise.</dd>
1493 <dt><span class="simpleTagLabel">Since:</span></dt>
1494 <dd>1.4</dd>
1495 <dt><span class="seeLabel">See Also:</span></dt>
1496 <dd><a href="ReferenceType.html#sourceDebugExtension()"><code>ReferenceType.sourceDebugExtension()</code></a></dd>
1497 </dl>
1498 </section>
1499 </li>
1500 <li class="blockList">
1501 <section class="detail">
1502 <h3><a id="canRequestVMDeathEvent()">canRequestVMDeathEvent</a></h3>
1503 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canRequestVMDeathEvent</span>()</div>
1504 <div class="block">Determines if the target VM supports the creation of
1505 <a href="request/VMDeathRequest.html" title="interface in com.sun.jdi.request"><code>VMDeathRequest</code></a>s.</div>
1506 <dl>
1507 <dt><span class="returnLabel">Returns:</span></dt>
1508 <dd><code>true</code> if the feature is supported,
1509 <code>false</code> otherwise.</dd>
1510 <dt><span class="simpleTagLabel">Since:</span></dt>
1511 <dd>1.4</dd>
1512 <dt><span class="seeLabel">See Also:</span></dt>
1513 <dd><a href="request/EventRequestManager.html#createVMDeathRequest()"><code>EventRequestManager.createVMDeathRequest()</code></a></dd>
1514 </dl>
1515 </section>
1516 </li>
1517 <li class="blockList">
1518 <section class="detail">
1519 <h3><a id="canGetMethodReturnValues()">canGetMethodReturnValues</a></h3>
1520 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetMethodReturnValues</span>()</div>
1521 <div class="block">Determines if the target VM supports the inclusion of return values
1522 in
1523 <a href="event/MethodExitEvent.html" title="interface in com.sun.jdi.event"><code>MethodExitEvent</code></a>s.</div>
1524 <dl>
1525 <dt><span class="returnLabel">Returns:</span></dt>
1526 <dd><code>true</code> if the feature is supported,
1527 <code>false</code> otherwise.</dd>
1528 <dt><span class="simpleTagLabel">Since:</span></dt>
1529 <dd>1.6</dd>
1530 <dt><span class="seeLabel">See Also:</span></dt>
1531 <dd><a href="request/EventRequestManager.html#createMethodExitRequest()"><code>EventRequestManager.createMethodExitRequest()</code></a></dd>
1532 </dl>
1533 </section>
1534 </li>
1535 <li class="blockList">
1536 <section class="detail">
1537 <h3><a id="canGetInstanceInfo()">canGetInstanceInfo</a></h3>
1538 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetInstanceInfo</span>()</div>
1539 <div class="block">Determines if the target VM supports the accessing of class instances,
1540 instance counts, and referring objects.</div>
1541 <dl>
1542 <dt><span class="returnLabel">Returns:</span></dt>
1543 <dd><code>true</code> if the feature is supported,
1544 <code>false</code> otherwise.</dd>
1545 <dt><span class="simpleTagLabel">Since:</span></dt>
1546 <dd>1.6</dd>
1547 <dt><span class="seeLabel">See Also:</span></dt>
1548 <dd><a href="#instanceCounts(java.util.List)"><code>instanceCounts(java.util.List<? extends com.sun.jdi.ReferenceType>)</code></a>,
1549 <a href="ReferenceType.html#instances(long)"><code>ReferenceType.instances(long)</code></a>,
1550 <a href="ObjectReference.html#referringObjects(long)"><code>ObjectReference.referringObjects(long)</code></a></dd>
1551 </dl>
1552 </section>
1553 </li>
1554 <li class="blockList">
1555 <section class="detail">
1556 <h3><a id="canUseSourceNameFilters()">canUseSourceNameFilters</a></h3>
1557 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canUseSourceNameFilters</span>()</div>
1558 <div class="block">Determines if the target VM supports the filtering of
1559 class prepare events by source name.
1560
1561 see <a href="request/ClassPrepareRequest.html#addSourceNameFilter(java.lang.String)"><code>ClassPrepareRequest.addSourceNameFilter(java.lang.String)</code></a>.</div>
1562 <dl>
1563 <dt><span class="returnLabel">Returns:</span></dt>
1564 <dd><code>true</code> if the feature is supported,
1565 <code>false</code> otherwise.</dd>
1566 <dt><span class="simpleTagLabel">Since:</span></dt>
1567 <dd>1.6</dd>
1568 </dl>
1569 </section>
1570 </li>
1571 <li class="blockList">
1572 <section class="detail">
1573 <h3><a id="canForceEarlyReturn()">canForceEarlyReturn</a></h3>
1574 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canForceEarlyReturn</span>()</div>
1575 <div class="block">Determines if the target VM supports the forcing of a method to
1576 return early.</div>
1577 <dl>
1578 <dt><span class="returnLabel">Returns:</span></dt>
1579 <dd><code>true</code> if the feature is supported,
1580 <code>false</code> otherwise.</dd>
1581 <dt><span class="simpleTagLabel">Since:</span></dt>
1582 <dd>1.6</dd>
1583 <dt><span class="seeLabel">See Also:</span></dt>
1584 <dd><a href="ThreadReference.html#forceEarlyReturn(com.sun.jdi.Value)"><code>ThreadReference.forceEarlyReturn(Value)</code></a></dd>
1585 </dl>
1586 </section>
1587 </li>
1588 <li class="blockList">
1589 <section class="detail">
1590 <h3><a id="canBeModified()">canBeModified</a></h3>
1591 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canBeModified</span>()</div>
1592 <div class="block">Determines if the target VM is a read-only VM. If a method which
1593 would modify the state of the VM is called on a read-only VM,
1594 then <a href="VMCannotBeModifiedException.html" title="class in com.sun.jdi"><code>VMCannotBeModifiedException</code></a> is thrown.</div>
1595 <dl>
1596 <dt><span class="returnLabel">Returns:</span></dt>
1597 <dd><code>true</code> if the feature is supported,
1598 <code>false</code> otherwise.</dd>
1599 <dt><span class="simpleTagLabel">Since:</span></dt>
1600 <dd>1.5</dd>
1601 </dl>
1602 </section>
1603 </li>
1604 <li class="blockList">
1605 <section class="detail">
1606 <h3><a id="canRequestMonitorEvents()">canRequestMonitorEvents</a></h3>
1607 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canRequestMonitorEvents</span>()</div>
1608 <div class="block">Determines if the target VM supports the creation of
1609 <a href="request/MonitorContendedEnterRequest.html" title="interface in com.sun.jdi.request"><code>MonitorContendedEnterRequest</code></a>s.
1610 <a href="request/MonitorContendedEnteredRequest.html" title="interface in com.sun.jdi.request"><code>MonitorContendedEnteredRequest</code></a>s.
1611 <a href="request/MonitorWaitRequest.html" title="interface in com.sun.jdi.request"><code>MonitorWaitRequest</code></a>s.
1612 <a href="request/MonitorWaitedRequest.html" title="interface in com.sun.jdi.request"><code>MonitorWaitedRequest</code></a>s.</div>
1613 <dl>
1614 <dt><span class="returnLabel">Returns:</span></dt>
1615 <dd><code>true</code> if the feature is supported,
1616 <code>false</code> otherwise.</dd>
1617 <dt><span class="simpleTagLabel">Since:</span></dt>
1618 <dd>1.6</dd>
1619 <dt><span class="seeLabel">See Also:</span></dt>
1620 <dd><a href="request/EventRequestManager.html#createMonitorContendedEnterRequest()"><code>EventRequestManager.createMonitorContendedEnterRequest()</code></a>,
1621 <a href="request/EventRequestManager.html#createMonitorContendedEnteredRequest()"><code>EventRequestManager.createMonitorContendedEnteredRequest()</code></a>,
1622 <a href="request/EventRequestManager.html#createMonitorWaitRequest()"><code>EventRequestManager.createMonitorWaitRequest()</code></a>,
1623 <a href="request/EventRequestManager.html#createMonitorWaitedRequest()"><code>EventRequestManager.createMonitorWaitedRequest()</code></a></dd>
1624 </dl>
1625 </section>
1626 </li>
1627 <li class="blockList">
1628 <section class="detail">
1629 <h3><a id="canGetMonitorFrameInfo()">canGetMonitorFrameInfo</a></h3>
1630 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetMonitorFrameInfo</span>()</div>
1631 <div class="block">Determines if the target VM supports getting which
1632 frame has acquired a monitor.</div>
1633 <dl>
1634 <dt><span class="returnLabel">Returns:</span></dt>
1635 <dd><code>true</code> if the feature is supported,
1636 <code>false</code> otherwise.</dd>
1637 <dt><span class="simpleTagLabel">Since:</span></dt>
1638 <dd>1.6</dd>
1639 <dt><span class="seeLabel">See Also:</span></dt>
1640 <dd><a href="ThreadReference.html#ownedMonitorsAndFrames()"><code>ThreadReference.ownedMonitorsAndFrames()</code></a></dd>
1641 </dl>
1642 </section>
1643 </li>
1644 <li class="blockList">
1645 <section class="detail">
1646 <h3><a id="canGetClassFileVersion()">canGetClassFileVersion</a></h3>
1647 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetClassFileVersion</span>()</div>
1648 <div class="block">Determines if the target VM supports reading class file
1649 major and minor versions.</div>
1650 <dl>
1651 <dt><span class="returnLabel">Returns:</span></dt>
1652 <dd><code>true</code> if the feature is supported,
1653 <code>false</code> otherwise.</dd>
1654 <dt><span class="simpleTagLabel">Since:</span></dt>
1655 <dd>1.6</dd>
1656 <dt><span class="seeLabel">See Also:</span></dt>
1657 <dd><a href="ReferenceType.html#majorVersion()"><code>ReferenceType.majorVersion()</code></a>,
1658 <a href="ReferenceType.html#minorVersion()"><code>ReferenceType.minorVersion()</code></a></dd>
1659 </dl>
1660 </section>
1661 </li>
1662 <li class="blockList">
1663 <section class="detail">
1664 <h3><a id="canGetConstantPool()">canGetConstantPool</a></h3>
1665 <div class="memberSignature"><span class="returnType">boolean</span> <span class="memberName">canGetConstantPool</span>()</div>
1666 <div class="block">Determines if the target VM supports getting constant pool
1667 information of a class.</div>
1668 <dl>
1669 <dt><span class="returnLabel">Returns:</span></dt>
1670 <dd><code>true</code> if the feature is supported,
1671 <code>false</code> otherwise.</dd>
1672 <dt><span class="simpleTagLabel">Since:</span></dt>
1673 <dd>1.6</dd>
1674 <dt><span class="seeLabel">See Also:</span></dt>
1675 <dd><a href="ReferenceType.html#constantPoolCount()"><code>ReferenceType.constantPoolCount()</code></a>,
1676 <a href="ReferenceType.html#constantPool()"><code>ReferenceType.constantPool()</code></a></dd>
1677 </dl>
1678 </section>
1679 </li>
1680 <li class="blockList">
1681 <section class="detail">
1682 <h3><a id="canGetModuleInfo()">canGetModuleInfo</a></h3>
1683 <div class="memberSignature"><span class="modifiers">default</span> <span class="returnType">boolean</span> <span class="memberName">canGetModuleInfo</span>()</div>
1684 <div class="block">Determines if the target VM supports getting information about modules.</div>
1685 <dl>
1686 <dt><span class="simpleTagLabel">Implementation Requirements:</span></dt>
1687 <dd>The default implementation returns <code>false</code>.</dd>
1688 <dt><span class="returnLabel">Returns:</span></dt>
1689 <dd><code>true</code> if the feature is supported, <code>false</code> otherwise</dd>
1690 <dt><span class="simpleTagLabel">Since:</span></dt>
1691 <dd>9</dd>
1692 <dt><span class="seeLabel">See Also:</span></dt>
1693 <dd><a href="#allModules()"><code>allModules()</code></a>,
1694 <a href="ReferenceType.html#module()"><code>ReferenceType.module()</code></a>,
1695 <a href="ModuleReference.html" title="interface in com.sun.jdi"><code>ModuleReference</code></a></dd>
1696 </dl>
1697 </section>
1698 </li>
1699 <li class="blockList">
1700 <section class="detail">
1701 <h3><a id="setDefaultStratum(java.lang.String)">setDefaultStratum</a></h3>
1702 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">setDefaultStratum</span>(<span class="arguments"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a> stratum)</span></div>
1703 <div class="block">Set this VM's default stratum (see <a href="Location.html" title="interface in com.sun.jdi"><code>Location</code></a> for a
1704 discussion of strata). Overrides the per-class default set
1705 in the class file.
1706 <P>
1707 Affects location queries (such as,
1708 <a href="Location.html#sourceName()"><code>Location.sourceName()</code></a>)
1709 and the line boundaries used in
1710 single stepping.</div>
1711 <dl>
1712 <dt><span class="paramLabel">Parameters:</span></dt>
1713 <dd><code>stratum</code> - the stratum to set as VM default,
1714 or null to use per-class defaults.</dd>
1715 <dt><span class="throwsLabel">Throws:</span></dt>
1716 <dd><code><a href="../../../../java.base/java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - if the
1717 target virtual machine does not support this operation.</dd>
1718 <dt><span class="simpleTagLabel">Since:</span></dt>
1719 <dd>1.4</dd>
1720 </dl>
1721 </section>
1722 </li>
1723 <li class="blockList">
1724 <section class="detail">
1725 <h3><a id="getDefaultStratum()">getDefaultStratum</a></h3>
1726 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></span> <span class="memberName">getDefaultStratum</span>()</div>
1727 <div class="block">Return this VM's default stratum.</div>
1728 <dl>
1729 <dt><span class="returnLabel">Returns:</span></dt>
1730 <dd><code>null</code> (meaning that the per-class
1731 default - <a href="ReferenceType.html#defaultStratum()"><code>ReferenceType.defaultStratum()</code></a> -
1732 should be used) unless the default stratum has been
1733 set with
1734 <a href="#setDefaultStratum(java.lang.String)"><code>setDefaultStratum(String)</code></a>.</dd>
1735 <dt><span class="simpleTagLabel">Since:</span></dt>
1736 <dd>1.4</dd>
1737 <dt><span class="seeLabel">See Also:</span></dt>
1738 <dd><a href="#setDefaultStratum(java.lang.String)"><code>setDefaultStratum(String)</code></a>,
1739 <a href="ReferenceType.html#defaultStratum()"><code>ReferenceType.defaultStratum()</code></a></dd>
1740 </dl>
1741 </section>
1742 </li>
1743 <li class="blockList">
1744 <section class="detail">
1745 <h3><a id="instanceCounts(java.util.List)">instanceCounts</a></h3>
1746 <div class="memberSignature"><span class="returnType">long[]</span> <span class="memberName">instanceCounts</span>(<span class="arguments"><a href="../../../../java.base/java/util/List.html" title="interface in java.util">List</a><? extends <a href="ReferenceType.html" title="interface in com.sun.jdi">ReferenceType</a>> refTypes)</span></div>
1747 <div class="block">Returns the number of instances of each ReferenceType in the 'refTypes'
1748 list.
1749 Only instances that are reachable for the purposes of garbage collection
1750 are counted.
1751 <p>
1752 Not all target virtual machines support this operation.
1753 Use <a href="#canGetInstanceInfo()"><code>canGetInstanceInfo()</code></a>
1754 to determine if the operation is supported.</div>
1755 <dl>
1756 <dt><span class="paramLabel">Parameters:</span></dt>
1757 <dd><code>refTypes</code> - the list of <a href="ReferenceType.html" title="interface in com.sun.jdi"><code>ReferenceType</code></a> objects for which counts
1758 are to be obtained.</dd>
1759 <dt><span class="returnLabel">Returns:</span></dt>
1760 <dd>an array of <code>long</code> containing one element for each
1761 element in the 'refTypes' list. Element i of the array contains
1762 the number of instances in the target VM of the ReferenceType at
1763 position i in the 'refTypes' list.
1764 If the 'refTypes' list is empty, a zero-length array is returned.
1765 If a ReferenceType in refTypes has been garbage collected, zero
1766 is returned for its instance count.</dd>
1767 <dt><span class="throwsLabel">Throws:</span></dt>
1768 <dd><code><a href="../../../../java.base/java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - if
1769 the target virtual machine does not support this
1770 operation - see
1771 <a href="#canGetInstanceInfo()"><code>canGetInstanceInfo()</code></a></dd>
1772 <dd><code><a href="../../../../java.base/java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - if the 'refTypes' list is null.</dd>
1773 <dt><span class="simpleTagLabel">Since:</span></dt>
1774 <dd>1.6</dd>
1775 <dt><span class="seeLabel">See Also:</span></dt>
1776 <dd><a href="ReferenceType.html#instances(long)"><code>ReferenceType.instances(long)</code></a>,
1777 <a href="ObjectReference.html#referringObjects(long)"><code>ObjectReference.referringObjects(long)</code></a></dd>
1778 </dl>
1779 </section>
1780 </li>
1781 <li class="blockList">
1782 <section class="detail">
1783 <h3><a id="description()">description</a></h3>
1784 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></span> <span class="memberName">description</span>()</div>
1785 <div class="block">Returns text information on the target VM and the
1786 debugger support that mirrors it. No specific format
1787 for this information is guaranteed.
1788 Typically, this string contains version information for the
1789 target VM and debugger interfaces.
1790 More precise information
1791 on VM and JDI versions is available through
1792 <a href="#version()"><code>version()</code></a>, <a href="VirtualMachineManager.html#majorInterfaceVersion()"><code>VirtualMachineManager.majorInterfaceVersion()</code></a>,
1793 and <a href="VirtualMachineManager.html#minorInterfaceVersion()"><code>VirtualMachineManager.minorInterfaceVersion()</code></a></div>
1794 <dl>
1795 <dt><span class="returnLabel">Returns:</span></dt>
1796 <dd>the description.</dd>
1797 </dl>
1798 </section>
1799 </li>
1800 <li class="blockList">
1801 <section class="detail">
1802 <h3><a id="version()">version</a></h3>
1803 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></span> <span class="memberName">version</span>()</div>
1804 <div class="block">Returns the version of the Java Runtime Environment in the target
1805 VM as reported by the property <code>java.version</code>.
1806 For obtaining the JDI interface version, use
1807 <a href="VirtualMachineManager.html#majorInterfaceVersion()"><code>VirtualMachineManager.majorInterfaceVersion()</code></a>
1808 and <a href="VirtualMachineManager.html#minorInterfaceVersion()"><code>VirtualMachineManager.minorInterfaceVersion()</code></a></div>
1809 <dl>
1810 <dt><span class="returnLabel">Returns:</span></dt>
1811 <dd>the target VM version.</dd>
1812 </dl>
1813 </section>
1814 </li>
1815 <li class="blockList">
1816 <section class="detail">
1817 <h3><a id="name()">name</a></h3>
1818 <div class="memberSignature"><span class="returnType"><a href="../../../../java.base/java/lang/String.html" title="class in java.lang">String</a></span> <span class="memberName">name</span>()</div>
1819 <div class="block">Returns the name of the target VM as reported by the
1820 property <code>java.vm.name</code>.</div>
1821 <dl>
1822 <dt><span class="returnLabel">Returns:</span></dt>
1823 <dd>the target VM name.</dd>
1824 </dl>
1825 </section>
1826 </li>
1827 <li class="blockList">
1828 <section class="detail">
1829 <h3><a id="setDebugTraceMode(int)">setDebugTraceMode</a></h3>
1830 <div class="memberSignature"><span class="returnType">void</span> <span class="memberName">setDebugTraceMode</span>(<span class="arguments">int traceFlags)</span></div>
1831 <div class="block">Traces the activities performed by the com.sun.jdi implementation.
1832 All trace information is output to System.err. The given trace
1833 flags are used to limit the output to only the information
1834 desired. The given flags are in effect and the corresponding
1835 trace will continue until the next call to
1836 this method.
1837 <p>
1838 Output is implementation dependent and trace mode may be ignored.</div>
1839 <dl>
1840 <dt><span class="paramLabel">Parameters:</span></dt>
1841 <dd><code>traceFlags</code> - identifies which kinds of tracing to enable.</dd>
1842 </dl>
1843 </section>
1844 </li>
1845 </ul>
1846 </section>
1847 </li>
1848 </ul>
1849 </section>
1850 </div>
1851 <!-- ========= END OF CLASS DATA ========= -->
1852 </main>
1853 <footer role="contentinfo">
1854 <nav role="navigation">
1855 <!-- ======= START OF BOTTOM NAVBAR ====== -->
1856 <div class="bottomNav"><a id="navbar.bottom">
1857 <!-- -->
1858 </a>
1859 <div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
1860 <a id="navbar.bottom.firstrow">
1861 <!-- -->
1862 </a>
1863 <ul class="navList" title="Navigation">
1864 <li><a href="../../../../index.html">Overview</a></li>
1865 <li><a href="../../../module-summary.html">Module</a></li>
1866 <li><a href="package-summary.html">Package</a></li>
1867 <li class="navBarCell1Rev">Class</li>
1868 <li><a href="class-use/VirtualMachine.html">Use</a></li>
1869 <li><a href="package-tree.html">Tree</a></li>
1870 <li><a href="../../../../deprecated-list.html">Deprecated</a></li>
1871 <li><a href="../../../../index-files/index-1.html">Index</a></li>
1872 <li><a href="../../../../help-doc.html">Help</a></li>
1873 </ul>
1874 <div class="aboutLanguage"><div style="margin-top: 9px;"><strong>Java SE 14 & JDK 14</strong> <br><strong>DRAFT 14-internal+0-2019-12-04-2218569.hseigel.bug8235360</strong></div></div>
1875 </div>
1876 <div class="subNav">
1877 <div>
1878 <ul class="subNavList">
1879 <li>Summary: </li>
1880 <li>Nested | </li>
1881 <li><a href="#field.summary">Field</a> | </li>
1882 <li>Constr | </li>
1883 <li><a href="#method.summary">Method</a></li>
1884 </ul>
1885 <ul class="subNavList">
1886 <li>Detail: </li>
1887 <li><a href="#field.detail">Field</a> | </li>
1888 <li>Constr | </li>
1889 <li><a href="#method.detail">Method</a></li>
1890 </ul>
1891 </div>
1892 </div>
1893 <a id="skip.navbar.bottom">
1894 <!-- -->
1895 </a>
1896 <!-- ======== END OF BOTTOM NAVBAR ======= -->
1897 </nav>
1898 <p class="legalCopy"><small><a href="https://bugreport.java.com/bugreport/">Report a bug or suggest an enhancement</a><br> For further API reference and developer documentation see the <a href="https://docs.oracle.com/pls/topic/lookup?ctx=javase14&id=homepage" target="_blank">Java SE Documentation</a>, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.<br> Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.<br> <a href="../../../../../legal/copyright.html">Copyright</a> © 1993, 2019, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.<br>All rights reserved. Use is subject to <a href="https://www.oracle.com/technetwork/java/javase/terms/license/java14speclicense.html">license terms</a> and the <a href="https://www.oracle.com/technetwork/java/redist-137594.html">documentation redistribution policy</a>. <br><strong>DRAFT 14-internal+0-2019-12-04-2218569.hseigel.bug8235360</strong> <!-- Version 14-internal+0-2019-12-04-2218569.hseigel.bug8235360 --></small></p>
1899 </footer>
1900 </div>
1901 </div>
1902 </body>
1903 </html>