OLD | NEW |
1 // This code was auto-generated, is not intended to be edited, and is subject to | 1 // This code was auto-generated, is not intended to be edited, and is subject to |
2 // significant change. Please see the README file for more information. | 2 // significant change. Please see the README file for more information. |
3 library engine.instrumentation; | 3 library engine.instrumentation; |
4 import 'java_core.dart'; | 4 import 'java_core.dart'; |
5 /** | 5 /** |
6 * The class `Instrumentation` implements support for logging instrumentation in
formation. | 6 * The class `Instrumentation` implements support for logging instrumentation in
formation. |
7 * | 7 * |
8 * Instrumentation information consists of information about specific operations
. Those operations | 8 * Instrumentation information consists of information about specific operations
. Those operations |
9 * can range from user-facing operations, such as saving the changes to a file,
to internal | 9 * can range from user-facing operations, such as saving the changes to a file,
to internal |
10 * operations, such as tokenizing source code. The information to be logged is g
athered by | 10 * operations, such as tokenizing source code. The information to be logged is g
athered by |
(...skipping 237 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
248 */ | 248 */ |
249 InstrumentationBuilder record(Exception exception); | 249 InstrumentationBuilder record(Exception exception); |
250 } | 250 } |
251 /** | 251 /** |
252 * The instrumentation recording level representing (1) recording [EVERYTHING] r
ecording of | 252 * The instrumentation recording level representing (1) recording [EVERYTHING] r
ecording of |
253 * all instrumentation data, (2) recording only [METRICS] information, or (3) re
cording | 253 * all instrumentation data, (2) recording only [METRICS] information, or (3) re
cording |
254 * turned [OFF] in which case nothing is recorded. | 254 * turned [OFF] in which case nothing is recorded. |
255 * | 255 * |
256 * @coverage dart.engine.utilities | 256 * @coverage dart.engine.utilities |
257 */ | 257 */ |
258 class InstrumentationLevel implements Enum<InstrumentationLevel> { | 258 class InstrumentationLevel extends Enum<InstrumentationLevel> { |
259 | 259 |
260 /** Recording all instrumented information */ | 260 /** Recording all instrumented information */ |
261 static final InstrumentationLevel EVERYTHING = new InstrumentationLevel('EVERY
THING', 0); | 261 static final InstrumentationLevel EVERYTHING = new InstrumentationLevel('EVERY
THING', 0); |
262 | 262 |
263 /** Recording only metrics */ | 263 /** Recording only metrics */ |
264 static final InstrumentationLevel METRICS = new InstrumentationLevel('METRICS'
, 1); | 264 static final InstrumentationLevel METRICS = new InstrumentationLevel('METRICS'
, 1); |
265 | 265 |
266 /** Nothing recorded */ | 266 /** Nothing recorded */ |
267 static final InstrumentationLevel OFF = new InstrumentationLevel('OFF', 2); | 267 static final InstrumentationLevel OFF = new InstrumentationLevel('OFF', 2); |
268 static final List<InstrumentationLevel> values = [EVERYTHING, METRICS, OFF]; | 268 static final List<InstrumentationLevel> values = [EVERYTHING, METRICS, OFF]; |
269 | |
270 /// The name of this enum constant, as declared in the enum declaration. | |
271 final String name; | |
272 | |
273 /// The position in the enum declaration. | |
274 final int ordinal; | |
275 static InstrumentationLevel fromString(String str) { | 269 static InstrumentationLevel fromString(String str) { |
276 if (str == "EVERYTHING") { | 270 if (str == "EVERYTHING") { |
277 return InstrumentationLevel.EVERYTHING; | 271 return InstrumentationLevel.EVERYTHING; |
278 } | 272 } |
279 if (str == "METRICS") { | 273 if (str == "METRICS") { |
280 return InstrumentationLevel.METRICS; | 274 return InstrumentationLevel.METRICS; |
281 } | 275 } |
282 if (str == "OFF") { | 276 if (str == "OFF") { |
283 return InstrumentationLevel.OFF; | 277 return InstrumentationLevel.OFF; |
284 } | 278 } |
285 throw new IllegalArgumentException("Unrecognised InstrumentationLevel"); | 279 throw new IllegalArgumentException("Unrecognised InstrumentationLevel"); |
286 } | 280 } |
287 InstrumentationLevel(this.name, this.ordinal); | 281 InstrumentationLevel(String name, int ordinal) : super(name, ordinal); |
288 int compareTo(InstrumentationLevel other) => ordinal - other.ordinal; | |
289 int get hashCode => ordinal; | |
290 String toString() => name; | |
291 } | 282 } |
292 /** | 283 /** |
293 * The interface `InstrumentationLogger` defines the behavior of objects that ar
e used to log | 284 * The interface `InstrumentationLogger` defines the behavior of objects that ar
e used to log |
294 * instrumentation data. | 285 * instrumentation data. |
295 * | 286 * |
296 * For an example of using objects that implement this interface, see [Instrumen
tation]. | 287 * For an example of using objects that implement this interface, see [Instrumen
tation]. |
297 * | 288 * |
298 * @coverage dart.engine.utilities | 289 * @coverage dart.engine.utilities |
299 */ | 290 */ |
300 abstract class InstrumentationLogger { | 291 abstract class InstrumentationLogger { |
301 | 292 |
302 /** | 293 /** |
303 * Create a builder that can collect the data associated with an operation ide
ntified by the given | 294 * Create a builder that can collect the data associated with an operation ide
ntified by the given |
304 * name. | 295 * name. |
305 * | 296 * |
306 * @param name the name used to uniquely identify the operation | 297 * @param name the name used to uniquely identify the operation |
307 * @return the builder that was created | 298 * @return the builder that was created |
308 */ | 299 */ |
309 InstrumentationBuilder createBuilder(String name); | 300 InstrumentationBuilder createBuilder(String name); |
310 } | 301 } |
OLD | NEW |