annotate agent/src/share/classes/sun/jvm/hotspot/debugger/cdbg/ObjectVisitor.java @ 1552:c18cbe5936b8

6941466: Oracle rebranding changes for Hotspot repositories Summary: Change all the Sun copyrights to Oracle copyright Reviewed-by: ohair
author trims
date Thu, 27 May 2010 19:08:38 -0700
parents a61af66fc99e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
2 * Copyright (c) 2001, Oracle and/or its affiliates. All rights reserved.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load
duke
parents:
diff changeset
4 *
a61af66fc99e Initial load
duke
parents:
diff changeset
5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load
duke
parents:
diff changeset
6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load
duke
parents:
diff changeset
7 * published by the Free Software Foundation.
a61af66fc99e Initial load
duke
parents:
diff changeset
8 *
a61af66fc99e Initial load
duke
parents:
diff changeset
9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load
duke
parents:
diff changeset
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load
duke
parents:
diff changeset
11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load
duke
parents:
diff changeset
12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load
duke
parents:
diff changeset
13 * accompanied this code).
a61af66fc99e Initial load
duke
parents:
diff changeset
14 *
a61af66fc99e Initial load
duke
parents:
diff changeset
15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load
duke
parents:
diff changeset
16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load
duke
parents:
diff changeset
17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load
duke
parents:
diff changeset
18 *
1552
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
20 * or visit www.oracle.com if you need additional information or have any
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories
trims
parents: 0
diff changeset
21 * questions.
0
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 package sun.jvm.hotspot.debugger.cdbg;
a61af66fc99e Initial load
duke
parents:
diff changeset
26
a61af66fc99e Initial load
duke
parents:
diff changeset
27 import sun.jvm.hotspot.debugger.*;
a61af66fc99e Initial load
duke
parents:
diff changeset
28
a61af66fc99e Initial load
duke
parents:
diff changeset
29 /** Provides uniform visitation to primitive and compound objects.
a61af66fc99e Initial load
duke
parents:
diff changeset
30 Typically one will have an Address of an "object" (in the
a61af66fc99e Initial load
duke
parents:
diff changeset
31 idealistic C++ definition, including "primitive objects" like
a61af66fc99e Initial load
duke
parents:
diff changeset
32 ints) and a Type for that object. This visitor interface allows
a61af66fc99e Initial load
duke
parents:
diff changeset
33 one to either get the value of the object (if of primitive type)
a61af66fc99e Initial load
duke
parents:
diff changeset
34 or iterate through its fields, getting the value of each, in a
a61af66fc99e Initial load
duke
parents:
diff changeset
35 consistent fashion. Also supports iteration through arrays of
a61af66fc99e Initial load
duke
parents:
diff changeset
36 known length. */
a61af66fc99e Initial load
duke
parents:
diff changeset
37
a61af66fc99e Initial load
duke
parents:
diff changeset
38 public interface ObjectVisitor {
a61af66fc99e Initial load
duke
parents:
diff changeset
39 /** This is called before beginning iterating through either the
a61af66fc99e Initial load
duke
parents:
diff changeset
40 fields declared in this compound type (not its superclasses) or
a61af66fc99e Initial load
duke
parents:
diff changeset
41 the elements of this array */
a61af66fc99e Initial load
duke
parents:
diff changeset
42 public void enterType(Type type, Address objectAddress);
a61af66fc99e Initial load
duke
parents:
diff changeset
43
a61af66fc99e Initial load
duke
parents:
diff changeset
44 /** This is called after finishing iterating through this compound
a61af66fc99e Initial load
duke
parents:
diff changeset
45 type */
a61af66fc99e Initial load
duke
parents:
diff changeset
46 public void exitType();
a61af66fc99e Initial load
duke
parents:
diff changeset
47
a61af66fc99e Initial load
duke
parents:
diff changeset
48 /** Primitive field or object of integer bitfield
a61af66fc99e Initial load
duke
parents:
diff changeset
49 type. FieldIdentifier is null if not a field of an enclosing
a61af66fc99e Initial load
duke
parents:
diff changeset
50 object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
51 public void doBit(FieldIdentifier f, long val);
a61af66fc99e Initial load
duke
parents:
diff changeset
52
a61af66fc99e Initial load
duke
parents:
diff changeset
53 /** Primitive field or object of integer type. FieldIdentifier is
a61af66fc99e Initial load
duke
parents:
diff changeset
54 null if not a field of an enclosing object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
55 public void doInt(FieldIdentifier f, long val);
a61af66fc99e Initial load
duke
parents:
diff changeset
56
a61af66fc99e Initial load
duke
parents:
diff changeset
57 /** Primitive field or object of enumerated type type.
a61af66fc99e Initial load
duke
parents:
diff changeset
58 FieldIdentifier is null if not a field of an enclosing
a61af66fc99e Initial load
duke
parents:
diff changeset
59 object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
60 public void doEnum(FieldIdentifier f, long val, String enumName);
a61af66fc99e Initial load
duke
parents:
diff changeset
61
a61af66fc99e Initial load
duke
parents:
diff changeset
62 /** Primitive field or object of single-precision floating-point
a61af66fc99e Initial load
duke
parents:
diff changeset
63 type. FieldIdentifier is null if not a field of an enclosing
a61af66fc99e Initial load
duke
parents:
diff changeset
64 object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
65 public void doFloat(FieldIdentifier f, float val);
a61af66fc99e Initial load
duke
parents:
diff changeset
66
a61af66fc99e Initial load
duke
parents:
diff changeset
67 /** Primitive field or object of double-precision floating-point
a61af66fc99e Initial load
duke
parents:
diff changeset
68 type. FieldIdentifier is null if not a field of an enclosing
a61af66fc99e Initial load
duke
parents:
diff changeset
69 object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
70 public void doDouble(FieldIdentifier f, double val);
a61af66fc99e Initial load
duke
parents:
diff changeset
71
a61af66fc99e Initial load
duke
parents:
diff changeset
72 /** Primitive field or object of pointer type. FieldIdentifier is
a61af66fc99e Initial load
duke
parents:
diff changeset
73 null if not a field of an enclosing object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
74 public void doPointer(FieldIdentifier f, Address val);
a61af66fc99e Initial load
duke
parents:
diff changeset
75
a61af66fc99e Initial load
duke
parents:
diff changeset
76 /** Primitive field or object of array type. FieldIdentifier is null
a61af66fc99e Initial load
duke
parents:
diff changeset
77 if not a field of an enclosing object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
78 public void doArray(FieldIdentifier f, Address val);
a61af66fc99e Initial load
duke
parents:
diff changeset
79
a61af66fc99e Initial load
duke
parents:
diff changeset
80 /** Primitive field or object of (C++) reference
a61af66fc99e Initial load
duke
parents:
diff changeset
81 type. FieldIdentifier is null if not a field of an enclosing
a61af66fc99e Initial load
duke
parents:
diff changeset
82 object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
83 public void doRef(FieldIdentifier f, Address val);
a61af66fc99e Initial load
duke
parents:
diff changeset
84
a61af66fc99e Initial load
duke
parents:
diff changeset
85 /** Identifies embedded objects in compound objects. FieldIdentifier
a61af66fc99e Initial load
duke
parents:
diff changeset
86 is null if not a field of an enclosing object. */
a61af66fc99e Initial load
duke
parents:
diff changeset
87 public void doCompound(FieldIdentifier f, Address addressOfEmbeddedCompoundObject);
a61af66fc99e Initial load
duke
parents:
diff changeset
88 }