Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | ENUM CONSTANTS | FIELD | METHOD | DETAIL: ENUM CONSTANTS | FIELD | METHOD

## 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.

Method Summary
`java.lang.String` | `toString()` Overridden to get the default display value.
`static InterfaceAttributes.Stability` | `valueOf(java.lang.String name)` Returns the enum constant of this type with the specified name.
`static InterfaceAttributes.Stability[]` | `values()` Returns an array containing the constants of this enum type, in the order they're declared.

Methods inherited from class java.lang.Enum
`clone, compareTo, equals, getDeclaringClass, hashCode, name, ordinal, valueOf`

Methods inherited from class java.lang.Object
`finalize, getClass, notify, notifyAll, wait, wait, wait`

Enum Constant Detail

### 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.

Method Detail

### values

    public static final InterfaceAttributes.Stability[] values()

  Returns an array containing the constants of this enum type, in the order they're 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're 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

### 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>`

Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | ENUM CONSTANTS | FIELD | METHOD | DETAIL: ENUM CONSTANTS | FIELD | METHOD