Instrument file reads

pkg/analyzer/lib/instrumentation/instrumentation.dart

 // Copyright (c) 2014, 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.
 
 library instrumentation;
 
 /**
  * The interface used by client code to communicate with an instrumentation
  * server.
  */
@@ skipping 29 matching lines @@
  */
 class InstrumentationService {
   /**
    * An instrumentation service that will not log any instrumentation data.
    */
   static final InstrumentationService NULL_SERVICE =
       new InstrumentationService(null);
 
   static const String TAG_ERROR = 'Err';
   static const String TAG_EXCEPTION = 'Ex';
+  static const String TAG_FILE_READ = 'Read';
   static const String TAG_LOG_ENTRY = 'Log';
   static const String TAG_NOTIFICATION = 'Noti';
   static const String TAG_REQUEST = 'Req';
   static const String TAG_RESPONSE = 'Res';
   static const String TAG_VERSION = 'Ver';
 
   /**
    * The instrumentation server used to communicate with the server, or `null`
    * if instrumentation data should not be logged.
    */
@@ skipping 23 matching lines @@
    */
   void logException(dynamic exception, StackTrace stackTrace) {
     if (_instrumentationServer != null) {
       String message = _toString(exception);
       String trace = _toString(stackTrace);
       _instrumentationServer.log(_join([TAG_EXCEPTION, message, trace]));
     }
   }
 
   /**
-   * Log a log entry that was written to the analysis engine's log.
+   * Log that the contents of the file with the given [path] were read. The file
+   * had the given [content] and [modificationTime].
+   */
+  void logFileRead(String path, int modificationTime, String content) {
+    if (_instrumentationServer != null) {
+      String timeStamp = _toString(modificationTime);
+      _instrumentationServer.log(_join([TAG_FILE_READ, path, timeStamp, content]));
+    }
+  }
+
+  /**
+   * Log that a log entry that was written to the analysis engine's log. The log
+   * entry has the given [level] and [message], and was created at the given
+   * [time].
    */
   void logLogEntry(String level, DateTime time, String message) {
     if (_instrumentationServer != null) {
-      String timeStamp = _toString(time);
+      String timeStamp = time == null ? 'null' : time.millisecondsSinceEpoch.toString();
       _instrumentationServer.log(
           _join([TAG_LOG_ENTRY, level, timeStamp, message]));
     }
   }
 
   /**
    * Log that a notification has been sent to the client.
    */
   void logNotification(String notification) {
     _log(TAG_NOTIFICATION, notification);
@@ skipping 113 matching lines @@
     }
   }
 
   @override
   void shutdown() {
     for (InstrumentationServer server in _servers) {
       server.shutdown();
     }
   }
 }