Das Status-Objekt repräsentiert das Ergebnis einer Operation. Jede auftretende Meldung besitzt ein Status-Objekt, das anzeigt, was bei der Ausführung passiert ist. Weiterführende Informationen erhalten Sie in der Dokumentation zu org.eclipse.core.runtime.IStatus.
Ein Status-Objekt enthält die folgenden Informationen:
- plug-in identifier (benötigt)
- severity (benötigt)
- status code (benötigt)
- message (benötigt)
- exception (optional)
Das Status-Objekt enthält folgende Felder:
Feld | Modifier und Typ | Beschreibung |
---|---|---|
CANCEL | static int | Status zeigt an, dass eine Operation abgebrochen wurde. |
ERROR | static int | Status zeigt an, dass ein Fehler aufgetreten ist. |
INFO | static int | Status zeigt an, dass es sich lediglich um eine Information handelt. |
[OK] | static int | Status zeigt an, dass die Operation fehlerfrei ausgeführt wurde. |
WARNING | static int | Status zeigt an, dass eine Warnung aufgetreten ist. |
Folgende Methoden stellt das Status-Objekt bereit:
Methode | Modifier und Typ | Beschreibung |
---|---|---|
getChildren() | IStatus[ ] | Gibt eine Liste der direkten Kind-Objekte zurück oder eine leere Liste wenn es kein Multistatus ist. |
getCode() | int | Gibt den Plugin-spezifischen Statuscode zurück, der das Ergebnis der Operation beschreibt. |
getException() | Throwable | Gibt die relevante low-level-Ausnahme zurück oder null wenn es keine Ausnahme gibt. |
getMessage() | String | Gibt die beschreibende Meldung für das Ergebnis der Operation zurück. |
getPlugin() | String | Gibt die eindeutige ID des plug-in in Verbindung mit diesem Status zurück. |
getSeverity() | int | Gibt die Gewichtung der Meldung zurück. |
isMultiStatus() | boolean | Gibt true zurück wenn es sich um ein Multi-Status-Objekt handelt. |
isOK() | boolean | Gibt true zurück wenn die Operation fehlerfrei ausgeführt wurde. |
matches(int severityMask) | boolean | Gibt true zurück wenn die Gewichtung der angegebenen Gewichtung entspricht. |