|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
A status object represents the outcome of an operation.
All CoreException
s 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:
The class Status
is the standard public implementation
of status objects; the subclass MultiStatus
is the
implements multi-status objects.
MultiStatus
,
Status
Field Summary | |
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. |
Throwable |
getException()
Returns the relevant low-level exception, or null if none. |
String |
getMessage()
Returns the message describing the outcome. |
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 |
public static final int OK
getSeverity()
,
isOK()
,
Constant Field Valuespublic static final int INFO
getSeverity()
,
matches(int)
,
Constant Field Valuespublic static final int WARNING
getSeverity()
,
matches(int)
,
Constant Field Valuespublic static final int ERROR
getSeverity()
,
matches(int)
,
Constant Field ValuesMethod Detail |
public IStatus[] getChildren()
isMultiStatus()
public int getCode()
public Throwable getException()
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.
null
if nonepublic String getMessage()
public String getPlugin()
public int getSeverity()
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.
OK
,
ERROR
, INFO
, or WARNING
matches(int)
public boolean isMultiStatus()
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.
true
for a multi-status,
false
otherwisegetChildren()
public boolean isOK()
true
if this status has severity
OK
, and false
otherwisepublic boolean matches(int severityMask)
severityMask
- a mask formed by bitwise or'ing severity mask
constants (ERROR
, WARNING
,
INFO
)
true
if there is at least one match,
false
if there are no matchesgetSeverity()
,
ERROR
,
WARNING
,
INFO
|
Eclipse Platform 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |