Introduce remote objects in Debugger protocol

runtime/include/dart_debugger_api.h

Index: runtime/include/dart_debugger_api.h
===================================================================
--- runtime/include/dart_debugger_api.h	(revision 7818)
+++ runtime/include/dart_debugger_api.h	(working copy)
@@ -22,7 +22,25 @@
                  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.
  *
@@ -285,6 +303,17 @@
 
 
 /**
+ * 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.
@@ -295,6 +324,29 @@
 
 
 /**
+ * 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.
  *