Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(55)

Unified Diff: pkg/analyzer_experimental/lib/src/generated/instrumentation.dart

Issue 16337007: Version 0.5.13.1 . (Closed) Base URL: http://dart.googlecode.com/svn/trunk/dart/
Patch Set: Created 7 years, 7 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: pkg/analyzer_experimental/lib/src/generated/instrumentation.dart
===================================================================
--- pkg/analyzer_experimental/lib/src/generated/instrumentation.dart (revision 23549)
+++ pkg/analyzer_experimental/lib/src/generated/instrumentation.dart (working copy)
@@ -5,6 +5,7 @@
import 'java_core.dart';
+
/**
* The class {@code Instrumentation} implements support for logging instrumentation information.
* <p>
@@ -31,46 +32,55 @@
* @coverage dart.engine.utilities
*/
class Instrumentation {
+
/**
* A builder that will silently ignore all data and logging requests.
*/
static InstrumentationBuilder _NULL_INSTRUMENTATION_BUILDER = new InstrumentationBuilder_13();
+
/**
* An instrumentation logger that can be used when no other instrumentation logger has been
* configured. This logger will silently ignore all data and logging requests.
*/
static InstrumentationLogger _NULL_LOGGER = new InstrumentationLogger_14();
+
/**
* The current instrumentation logger.
*/
static InstrumentationLogger _CURRENT_LOGGER = _NULL_LOGGER;
+
/**
* Create a builder that can collect the data associated with an operation.
* @param clazz the class performing the operation (not {@code null})
* @return the builder that was created (not {@code null})
*/
static InstrumentationBuilder builder(Type clazz) => _CURRENT_LOGGER.createBuilder(clazz.toString());
+
/**
* Create a builder that can collect the data associated with an operation.
* @param name the name used to uniquely identify the operation (not {@code null})
* @return the builder that was created (not {@code null})
*/
static InstrumentationBuilder builder2(String name) => _CURRENT_LOGGER.createBuilder(name);
+
/**
* Get the currently active instrumentation logger
*/
static InstrumentationLogger get logger => _CURRENT_LOGGER;
+
/**
* Return a builder that will silently ignore all data and logging requests.
* @return the builder (not {@code null})
*/
static InstrumentationBuilder get nullBuilder => _NULL_INSTRUMENTATION_BUILDER;
+
/**
* Is this instrumentation system currently configured to drop instrumentation data provided to
* it?
* @return
*/
static bool isNullLogger() => identical(_CURRENT_LOGGER, _NULL_LOGGER);
+
/**
* Set the logger that should receive instrumentation information to the given logger.
* @param logger the logger that should receive instrumentation information
@@ -78,11 +88,6 @@
static void set logger(InstrumentationLogger logger2) {
_CURRENT_LOGGER = logger2 == null ? _NULL_LOGGER : logger2;
}
- /**
- * Prevent the creation of instances of this class
- */
- Instrumentation() {
- }
}
class InstrumentationBuilder_13 implements InstrumentationBuilder {
InstrumentationBuilder data(String name, bool value) => this;
@@ -101,6 +106,7 @@
class InstrumentationLogger_14 implements InstrumentationLogger {
InstrumentationBuilder createBuilder(String name) => Instrumentation._NULL_INSTRUMENTATION_BUILDER;
}
+
/**
* The interface {@code InstrumentationBuilder} defines the behavior of objects used to collect data
* about an operation that has occurred and record that data through an instrumentation logger.
@@ -109,6 +115,7 @@
* @coverage dart.engine.utilities
*/
abstract class InstrumentationBuilder {
+
/**
* Append the given data to the data being collected by this builder. The information is declared
* to potentially contain data that is either user identifiable or contains user intellectual
@@ -118,6 +125,7 @@
* @return this builder
*/
InstrumentationBuilder data(String name, bool value);
+
/**
* Append the given data to the data being collected by this builder. The information is declared
* to potentially contain data that is either user identifiable or contains user intellectual
@@ -127,6 +135,7 @@
* @return this builder
*/
InstrumentationBuilder data2(String name, int value);
+
/**
* Append the given data to the data being collected by this builder. The information is declared
* to potentially contain data that is either user identifiable or contains user intellectual
@@ -136,6 +145,7 @@
* @return this builder
*/
InstrumentationBuilder data3(String name, String value);
+
/**
* Append the given data to the data being collected by this builder. The information is declared
* to potentially contain data that is either user identifiable or contains user intellectual
@@ -145,17 +155,20 @@
* @return this builder
*/
InstrumentationBuilder data4(String name, List<String> value);
+
/**
* Answer the {@link InstrumentationLevel} of this {@code InstrumentationBuilder}.
* @return one of {@link InstrumentationLevel#EVERYTHING}, {@link InstrumentationLevel#METRICS},{@link InstrumentationLevel#OFF}
*/
InstrumentationLevel get instrumentationLevel;
+
/**
* Log the data that has been collected. The instrumentation builder should not be used after this
* method is invoked. The behavior of any method defined on this interface that is used after this
* method is invoked is undefined.
*/
void log();
+
/**
* Append the given metric to the data being collected by this builder. The information is
* declared to contain only metrics data (data that is not user identifiable and does not contain
@@ -165,6 +178,7 @@
* @return this builder
*/
InstrumentationBuilder metric(String name, bool value);
+
/**
* Append the given metric to the data being collected by this builder. The information is
* declared to contain only metrics data (data that is not user identifiable and does not contain
@@ -174,6 +188,7 @@
* @return this builder
*/
InstrumentationBuilder metric2(String name, int value);
+
/**
* Append the given metric to the data being collected by this builder. The information is
* declared to contain only metrics data (data that is not user identifiable and does not contain
@@ -183,6 +198,7 @@
* @return this builder
*/
InstrumentationBuilder metric3(String name, String value);
+
/**
* Append the given metric to the data being collected by this builder. The information is
* declared to contain only metrics data (data that is not user identifiable and does not contain
@@ -192,6 +208,7 @@
* @return this builder
*/
InstrumentationBuilder metric4(String name, List<String> value);
+
/**
* Append the given exception to the information being collected by this builder. The exception's
* class name is captured using {@link #metric(String,String)}. Other aspects of the exception
@@ -201,6 +218,7 @@
*/
InstrumentationBuilder record(Exception exception);
}
+
/**
* The instrumentation recording level representing (1) recording {@link #EVERYTHING} recording of
* all instrumentation data, (2) recording only {@link #METRICS} information, or (3) recording
@@ -208,22 +226,28 @@
* @coverage dart.engine.utilities
*/
class InstrumentationLevel implements Comparable<InstrumentationLevel> {
+
/**
* Recording all instrumented information
*/
static final InstrumentationLevel EVERYTHING = new InstrumentationLevel('EVERYTHING', 0);
+
/**
* Recording only metrics
*/
static final InstrumentationLevel METRICS = new InstrumentationLevel('METRICS', 1);
+
/**
* Nothing recorded
*/
static final InstrumentationLevel OFF = new InstrumentationLevel('OFF', 2);
static final List<InstrumentationLevel> values = [EVERYTHING, METRICS, OFF];
- final String __name;
- final int __ordinal;
- int get ordinal => __ordinal;
+
+ /// The name of this enum constant, as declared in the enum declaration.
+ final String name;
+
+ /// The position in the enum declaration.
+ final int ordinal;
static InstrumentationLevel fromString(String str) {
if (str == "EVERYTHING") {
return InstrumentationLevel.EVERYTHING;
@@ -236,11 +260,12 @@
}
throw new IllegalArgumentException("Unrecognised InstrumentationLevel");
}
- InstrumentationLevel(this.__name, this.__ordinal) {
+ InstrumentationLevel(this.name, this.ordinal) {
}
- int compareTo(InstrumentationLevel other) => __ordinal - other.__ordinal;
- String toString() => __name;
+ int compareTo(InstrumentationLevel other) => ordinal - other.ordinal;
+ String toString() => name;
}
+
/**
* The interface {@code InstrumentationLogger} defines the behavior of objects that are used to log
* instrumentation data.
@@ -249,6 +274,7 @@
* @coverage dart.engine.utilities
*/
abstract class InstrumentationLogger {
+
/**
* Create a builder that can collect the data associated with an operation identified by the given
* name.
« no previous file with comments | « pkg/analyzer_experimental/lib/src/generated/html.dart ('k') | pkg/analyzer_experimental/lib/src/generated/java_core.dart » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698