Introduce remote objects in Debugger protocol

runtime/include/dart_debugger_api.h

 // Copyright (c) 2011, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 #ifndef INCLUDE_DART_DEBUGGER_API_H_
 #define INCLUDE_DART_DEBUGGER_API_H_
 
 #include "include/dart_api.h"
 
 typedef struct _Dart_Breakpoint* Dart_Breakpoint;
 
 typedef struct _Dart_StackTrace* Dart_StackTrace;
 
 typedef struct _Dart_ActivationFrame* Dart_ActivationFrame;
 
 typedef void Dart_BreakpointHandler(
                  Dart_Breakpoint breakpoint,
                  Dart_StackTrace stack_trace);
 
 typedef void Dart_BreakpointResolvedHandler(
                  intptr_t bp_id,
                  Dart_Handle url,
                  intptr_t line_number);
 
+
+/**
+ * Caches a given \object and returns an object id. The cache is only

[siva, 2012/05/22 01:49:09]

This object id is valid only while the VM is paused as the cache is destroyed
when execution is resumed.

[hausner, 2012/05/22 18:03:57]

Done.

+ * valid while the VM is paused.
+ *
+ * Requires there to be a current isolate.
+ */
+DART_EXPORT intptr_t Dart_CacheObject(Dart_Handle object_in);
+
+
+/**
+ * Returns a cached object given the \obj_id.
+ *
+ * Requires there to be a current isolate.
+ */
+DART_EXPORT Dart_Handle Dart_GetCachedObject(intptr_t obj_id);
+
+
 /**
  * Returns a list of urls (strings) of all the libraries loaded in the
  * current isolate.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to a list of string handles.
  */
 DART_EXPORT Dart_Handle Dart_GetLibraryURLs();
 
@@ skipping 243 matching lines @@
  * Returns the class of the given \object.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to the class object.
  */
 DART_EXPORT Dart_Handle Dart_GetObjClass(Dart_Handle object);
 
 
 /**
+ * Returns in \class_id the class id of the given \object.

[siva, 2012/05/22 01:49:09]

Should you put in some wording that the class id is valid even after execution
resumes and is valid until the isolate is shutdown.

[hausner, 2012/05/22 18:03:57]

Done.

+ *
+ * Requires there to be a current isolate.
+ *
+ * \return True if no error occurs.
+ */
+DART_EXPORT Dart_Handle Dart_GetObjClassId(Dart_Handle object,
+                                           intptr_t* class_id);
+
+
+/**
  * Returns the superclass of the given class \cls.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to the class object.
  */
 DART_EXPORT Dart_Handle Dart_GetSuperclass(Dart_Handle cls);
 
 
 /**
+ * Returns info about the given class \cls_id.
+ *
+ * \param class_name receives handle to class name (string) if non-null.
+ * \param library receives handle to library in which the class
+ *        is defined, if non-null.
+ * \param super_class_id receives the class id to the super class of
+ *        \cls_id if non-null.
+ * \param static_fields If non-null, receives an array containing field
+ *        names and values of static fields of the class. Names are
+ *        at array offsets 2*n, values at offset 2*n+1.
+ *
+ * Requires there to be a current isolate.
+ *
+ * \return A handle to the value true if no error occurs.
+ */
+DART_EXPORT Dart_Handle Dart_GetClassInfo(intptr_t class_id,
+                                          Dart_Handle* class_name,
+                                          Dart_Handle* library,
+                                          intptr_t* super_class_id,
+                                          Dart_Handle* static_fields);
+
+
+/**
  * Returns an array containing all instance field names and values of
  * the given \object.
  *
  * Requires there to be a current isolate.
  *
  * \return A handle to an array containing field names and
  * corresponding field values. The array is empty if the object has
  * no fields. If non-empty, field names are at array offsets 2*n,
  * values at offset 2*n+1. Field values may also be a handle to an
  * error object if an error was encountered evaluating the field.
@@ skipping 10 matching lines @@
  * \return A handle to an array containing field names and
  * corresponding field values. The array is empty if the class has
  * no static fields. If non-empty, field names are at array offsets 2*n,
  * values at offset 2*n+1. Field values may also be a handle to an
  * error object if an error was encountered evaluating the field.
  */
 DART_EXPORT Dart_Handle Dart_GetStaticFields(Dart_Handle cls);
 
 
 #endif  // INCLUDE_DART_DEBUGGER_API_H_