--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/agent/src/share/classes/sun/jvm/hotspot/debugger/cdbg/ObjectVisitor.java	Sat Dec 01 00:00:00 2007 +0000
@@ -0,0 +1,88 @@
+/*
+ * Copyright 2001 Sun Microsystems, Inc.  All Rights Reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
+ * CA 95054 USA or visit www.sun.com if you need additional information or
+ * have any questions.
+ *
+ */
+
+package sun.jvm.hotspot.debugger.cdbg;
+
+import sun.jvm.hotspot.debugger.*;
+
+/** Provides uniform visitation to primitive and compound objects.
+    Typically one will have an Address of an "object" (in the
+    idealistic C++ definition, including "primitive objects" like
+    ints) and a Type for that object. This visitor interface allows
+    one to either get the value of the object (if of primitive type)
+    or iterate through its fields, getting the value of each, in a
+    consistent fashion. Also supports iteration through arrays of
+    known length. */
+
+public interface ObjectVisitor {
+  /** This is called before beginning iterating through either the
+      fields declared in this compound type (not its superclasses) or
+      the elements of this array */
+  public void enterType(Type type, Address objectAddress);
+
+  /** This is called after finishing iterating through this compound
+      type */
+  public void exitType();
+
+  /** Primitive field or object of integer bitfield
+      type. FieldIdentifier is null if not a field of an enclosing
+      object. */
+  public void doBit(FieldIdentifier f, long val);
+
+  /** Primitive field or object of integer type. FieldIdentifier is
+      null if not a field of an enclosing object. */
+  public void doInt(FieldIdentifier f, long val);
+
+  /** Primitive field or object of enumerated type type.
+      FieldIdentifier is null if not a field of an enclosing
+      object. */
+  public void doEnum(FieldIdentifier f, long val, String enumName);
+
+  /** Primitive field or object of single-precision floating-point
+      type. FieldIdentifier is null if not a field of an enclosing
+      object. */
+  public void doFloat(FieldIdentifier f, float val);
+
+  /** Primitive field or object of double-precision floating-point
+      type. FieldIdentifier is null if not a field of an enclosing
+      object. */
+  public void doDouble(FieldIdentifier f, double val);
+
+  /** Primitive field or object of pointer type. FieldIdentifier is
+      null if not a field of an enclosing object. */
+  public void doPointer(FieldIdentifier f, Address val);
+
+  /** Primitive field or object of array type. FieldIdentifier is null
+      if not a field of an enclosing object. */
+  public void doArray(FieldIdentifier f, Address val);
+
+  /** Primitive field or object of (C++) reference
+      type. FieldIdentifier is null if not a field of an enclosing
+      object. */
+  public void doRef(FieldIdentifier f, Address val);
+
+  /** Identifies embedded objects in compound objects. FieldIdentifier
+      is null if not a field of an enclosing object. */
+  public void doCompound(FieldIdentifier f, Address addressOfEmbeddedCompoundObject);
+}