IStatus

Overview

Package

Class

Use

Deprecated

Index

Home >> All >> org >> eclipse >> core >> [ runtime overview ]

PREV CLASS NEXT CLASS

SUMMARY:

JAVADOC |

Sourc code of org.eclipse.core.runtime.IStatus

SOURCE |

Download org.eclipse.core.runtime.IStatus

DOWNLOAD | NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.eclipse.core.runtime
Interface IStatus

All Known Implementing Classes:: Status

public interface IStatus

A status object represents the outcome of an operation. All CoreExceptions carry a status object to indicate what went wrong. Status objects are also returned by methods needing to provide details of failures (e.g., validation methods).

A status carries the following information:

plug-in identifier (required)
severity (required)
status code (required)
message (required) - localized to current locale
exception (optional) - for problems stemming from a failure at a lower level

Some status objects, known as multi-statuses, have other status objects as children.

The class Status is the standard public implementation of status objects; the subclass MultiStatus is the implements multi-status objects.

Field Summary

static int CANCEL
          Status type severity (bit mask, value 8) indicating this status represents a cancelation

static int ERROR
          Status type severity (bit mask, value 4) indicating this status represents an error.

static int INFO
          Status type severity (bit mask, value 1) indicating this status is informational only.

static int OK
          Status severity constant (value 0) indicating this status represents the nominal case.

static int WARNING
          Status type severity (bit mask, value 2) indicating this status represents a warning.

Method Summary

IStatus[] getChildren()
          Returns a list of status object immediately contained in this multi-status, or an empty list if this is not a multi-status.

int getCode()
          Returns the plug-in-specific status code describing the outcome.

java.lang.Throwable getException()
          Returns the relevant low-level exception, or null if none.

java.lang.String getMessage()
          Returns the message describing the outcome.

java.lang.String getPlugin()
          Returns the unique identifier of the plug-in associated with this status (this is the plug-in that defines the meaning of the status code).

int getSeverity()
          Returns the severity.

boolean isMultiStatus()
          Returns whether this status is a multi-status.

boolean isOK()
          Returns whether this status indicates everything is okay (neither info, warning, nor error).

boolean matches(int severityMask)
          Returns whether the severity of this status matches the given specification.

Field Detail

OK

public static final int OK

Status severity constant (value 0) indicating this status represents the nominal case. This constant is also used as the status code representing the nominal case.

See Also:: getSeverity() 55 , isOK() 55 , Constant Field Values

INFO

public static final int INFO

Status type severity (bit mask, value 1) indicating this status is informational only.

See Also:: getSeverity() 55 , matches(int) 55 , Constant Field Values

WARNING

public static final int WARNING

Status type severity (bit mask, value 2) indicating this status represents a warning.

See Also:: getSeverity() 55 , matches(int) 55 , Constant Field Values

ERROR

public static final int ERROR

Status type severity (bit mask, value 4) indicating this status represents an error.

See Also:: getSeverity() 55 , matches(int) 55 , Constant Field Values

CANCEL

public static final int CANCEL

Status type severity (bit mask, value 8) indicating this status represents a cancelation

Since:: 3.0
See Also:: getSeverity() 55 , matches(int) 55 , Constant Field Values

Method Detail

getChildren

public IStatus[] getChildren()

Returns a list of status object immediately contained in this multi-status, or an empty list if this is not a multi-status.

getCode

public int getCode()

Returns the plug-in-specific status code describing the outcome.

getException

public java.lang.Throwable getException()

Returns the relevant low-level exception, or null if none. For example, when an operation fails because of a network communications failure, this might return the java.io.IOException describing the exact nature of that failure.

getMessage

public java.lang.String getMessage()

Returns the message describing the outcome. The message is localized to the current locale.

getPlugin

public java.lang.String getPlugin()

Returns the unique identifier of the plug-in associated with this status (this is the plug-in that defines the meaning of the status code).

getSeverity

public int getSeverity()

Returns the severity. The severities are as follows (in descending order):

CANCEL - cancelation occurred
ERROR - a serious error (most severe)
WARNING - a warning (less severe)
INFO - an informational ("fyi") message (least severe)
OK - everything is just fine

The severity of a multi-status is defined to be the maximum severity of any of its children, or OK if it has no children.

isMultiStatus

public boolean isMultiStatus()

Returns whether this status is a multi-status. A multi-status describes the outcome of an operation involving multiple operands.

The severity of a multi-status is derived from the severities of its children; a multi-status with no children is OK by definition. A multi-status carries a plug-in identifier, a status code, a message, and an optional exception. Clients may treat multi-status objects in a multi-status unaware way.

isOK

public boolean isOK()

Returns whether this status indicates everything is okay (neither info, warning, nor error).

matches

public boolean matches(int severityMask)

Returns whether the severity of this status matches the given specification.