org.opensolaris.os.dtrace
Enum InterfaceAttributes.Stability
java.lang.Object
java.lang.Enum<InterfaceAttributes.Stability>
org.opensolaris.os.dtrace.InterfaceAttributes.Stability
- All Implemented Interfaces:
- java.io.Serializable, java.lang.Comparable<InterfaceAttributes.Stability>
- Enclosing class:
- InterfaceAttributes
public static enum InterfaceAttributes.Stability
- extends java.lang.Enum<InterfaceAttributes.Stability>
Interface stability level. Assists developers in making risk
assessments when developing scripts and tools based on DTrace by
indicating how likely an interface or DTrace entity is to change
in a future release or patch.
Enum Constant Summary |
EVOLVING
The interface might eventually become Standard or Stable but
is still in transition. |
EXTERNAL
The interface is controlled by an entity other than Sun. |
INTERNAL
The interface is private to DTrace itself and represents an
implementation detail of DTrace. |
OBSOLETE
The interface is supported in the current release but is
scheduled to be removed, most likely in a future minor
release. |
PRIVATE
The interface is private to Sun and represents an interface
developed for use by other Sun products that is not yet
publicly documented for use by customers and ISVs. |
STABLE
The interface is a mature interface under Sun's control. |
STANDARD
The interface complies with an industry standard. |
UNSTABLE
The interface is provided to give developers early access to
new or rapidly changing technology or to an implementation
artifact that is essential for observing or debugging system
behavior for which a more stable solution is anticipated in
the future. |
Methods inherited from class java.lang.Enum |
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf |
Methods inherited from class java.lang.Object |
getClass, notify, notifyAll, wait, wait, wait |
INTERNAL
public static final InterfaceAttributes.Stability INTERNAL
- The interface is private to DTrace itself and represents an
implementation detail of DTrace. Internal interfaces might
change in minor or micro releases.
PRIVATE
public static final InterfaceAttributes.Stability PRIVATE
- The interface is private to Sun and represents an interface
developed for use by other Sun products that is not yet
publicly documented for use by customers and ISVs. Private
interfaces might change in minor or micro releases.
OBSOLETE
public static final InterfaceAttributes.Stability OBSOLETE
- The interface is supported in the current release but is
scheduled to be removed, most likely in a future minor
release. When support of an interface is to be discontinued,
Sun will attempt to provide notification before discontinuing
the interface. The D compiler might produce warning messages
if you attempt to use an Obsolete interface.
EXTERNAL
public static final InterfaceAttributes.Stability EXTERNAL
- The interface is controlled by an entity other than Sun. At
Sun's discretion, Sun can deliver updated and possibly
incompatible versions as part of any release, subject to
their availability from the controlling entity. Sun makes no
claims regarding either the source or binary compatibility
for External interfaces between two releases. Applications
based on these interfaces might not work in future releases,
including patches that contain External interfaces.
UNSTABLE
public static final InterfaceAttributes.Stability UNSTABLE
- The interface is provided to give developers early access to
new or rapidly changing technology or to an implementation
artifact that is essential for observing or debugging system
behavior for which a more stable solution is anticipated in
the future. Sun makes no claims about either source of
binary compatibility for Unstable interfaces from one minor
release to another.
EVOLVING
public static final InterfaceAttributes.Stability EVOLVING
- The interface might eventually become Standard or Stable but
is still in transition. Sun will make reasonable efforts to
ensure compatibility with previous releases as it eveolves.
When non-upward compatible changes become necessary, they
will occur in minor and major releases. These changes will
be avoided in micro releases whenever possible. If such a
change is necessary, it will be documented in the release
notes for the affected release, and when feasible, Sun will
provide migration aids for binary compatibility and continued
D program development.
STABLE
public static final InterfaceAttributes.Stability STABLE
- The interface is a mature interface under Sun's control. Sun
will try to avoid non-upward-compatible changes to these
interfaces, especially in minor or micro releases. If
support of a Stable interface must be discontinued, Sun will
attempt to provide notification and the stability level
changes to Obsolete.
STANDARD
public static final InterfaceAttributes.Stability STANDARD
- The interface complies with an industry standard. The
corresponding documentation for the interface will describe
the standard to which the interface conforms. Standards are
typically controlled by a standards development organization,
and changes can be made to the interface in accordance with
approved changes to the standard. This stability level can
also apply to interfaces that have been adopted (without a
formal standard) by an industry convention. Support is
provided for only the specified versions of a standard;
support for later versions is not guaranteed. If the
standards development organization approves a
non-upward-compatible change to a Standard interface that Sun
decides to support, Sun will announce a compatibility and
migration strategy.
values
public static InterfaceAttributes.Stability[] values()
- Returns an array containing the constants of this enum type, in
the order they are declared. This method may be used to iterate
over the constants as follows:
for (InterfaceAttributes.Stability c : InterfaceAttributes.Stability.values())
System.out.println(c);
- Returns:
- an array containing the constants of this enum type, in
the order they are declared
valueOf
public static InterfaceAttributes.Stability valueOf(java.lang.String name)
- Returns the enum constant of this type with the specified name.
The string must match exactly an identifier used to declare an
enum constant in this type. (Extraneous whitespace characters are
not permitted.)
- Parameters:
name
- the name of the enum constant to be returned.
- Returns:
- the enum constant with the specified name
- Throws:
java.lang.IllegalArgumentException
- if this enum type has no constant
with the specified name
java.lang.NullPointerException
- if the argument is null
toString
public java.lang.String toString()
- Overridden to get the default display value. To
internationalize the display value, use
Enum.name()
instead as a lookup key.
- Overrides:
toString
in class java.lang.Enum<InterfaceAttributes.Stability>