author | kamg |
Thu, 17 Apr 2008 22:00:16 -0400 | |
changeset 406 | bde3a21bcab0 |
child 491 | a394684ccfe6 |
permissions | -rw-r--r-- |
406
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
1 |
/* |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
2 |
* Copyright 2007 Sun Microsystems, Inc. All rights reserved. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
3 |
* SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
4 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
5 |
|
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
6 |
package com.sun.tracing.dtrace; |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
7 |
|
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
8 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
9 |
* Enumeration for the DTrace stability levels. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
10 |
* |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
11 |
* @see <a href="http://docs.sun.com/app/docs/doc/817-6223/6mlkidlnp?a=view">Solaris Dynamic Tracing Guide, Chapter 39: Stability</a> |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
12 |
* @since 1.7 |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
13 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
14 |
public enum StabilityLevel { |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
15 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
16 |
* The interface is private to DTrace and represents an implementation |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
17 |
* detail of DTrace. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
18 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
19 |
INTERNAL (0), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
20 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
21 |
* The interface is private to Sun for use by other Sun products. It is |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
22 |
* not yet publicly documented for use by customers and ISVs. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
23 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
24 |
PRIVATE (1), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
25 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
26 |
* The interface is supported in the current release but is scheduled |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
27 |
* to be removed, most likely in a future minor release. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
28 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
29 |
OBSOLETE (2), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
30 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
31 |
* The interface is controlled by an entity other than Sun. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
32 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
33 |
EXTERNAL (3), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
34 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
35 |
* The interface gives developers early access to new or |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
36 |
* rapidly changing technology or to an implementation artifact that is |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
37 |
* essential for observing or debugging system behavior. A more |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
38 |
* stable solution is anticipated in the future. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
39 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
40 |
UNSTABLE (4), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
41 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
42 |
* The interface might eventually become Standard or Stable but is |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
43 |
* still in transition. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
44 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
45 |
EVOLVING (5), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
46 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
47 |
* The interface is a mature interface under Sun's control. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
48 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
49 |
STABLE (6), |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
50 |
/** |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
51 |
* The interface complies with an industry standard. |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
52 |
*/ |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
53 |
STANDARD (7); |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
54 |
|
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
55 |
String toDisplayString() { |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
56 |
return toString().substring(0,1) + |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
57 |
toString().substring(1).toLowerCase(); |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
58 |
} |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
59 |
|
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
60 |
public int getEncoding() { return encoding; } |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
61 |
|
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
62 |
private int encoding; |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
63 |
|
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
64 |
private StabilityLevel(int encoding) { |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
65 |
this.encoding = encoding; |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
66 |
} |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
67 |
} |
bde3a21bcab0
6690122: Provide a mechanism for specifying Java-level USDT-like dtrace probes
kamg
parents:
diff
changeset
|
68 |