org.eclipse.core.runtime
Class MultiStatus

java.lang.Object
  |
  +--org.eclipse.core.runtime.Status
        |
        +--org.eclipse.core.runtime.MultiStatus

All Implemented Interfaces:

IStatus

public class MultiStatus

extends Status

A concrete multi-status implementation, suitable either for instantiating or subclassing.

Field Summary

Fields inherited from interface org.eclipse.core.runtime.IStatus

ERROR, INFO, OK, WARNING

Constructor Summary

MultiStatus(String pluginId, int code, IStatus[] children, String message, Throwable exception)
Creates and returns a new multi-status object with the given children.

MultiStatus(String pluginId, int code, String message, Throwable exception)
Creates and returns a new multi-status object with no children.

Method Summary

void	add(IStatus status) Adds the given status to this multi-status.
void	addAll(IStatus status) Adds all of the children of the given status to this multi-status.
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.
boolean	isMultiStatus() Returns whether this status is a multi-status.
void	merge(IStatus status) Merges the given status into this multi-status.
String	toString() Returns a string representation of the status, suitable for debugging purposes only.

Methods inherited from class org.eclipse.core.runtime.Status

getCode, getException, getMessage, getPlugin, getSeverity, isOK, matches, setCode, setException, setMessage, setPlugin, setSeverity

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

MultiStatus

public MultiStatus(String pluginId,
                   int code,
                   IStatus[] children,
                   String message,
                   Throwable exception)

Creates and returns a new multi-status object with the given children.

Parameters:

pluginId - the unique identifier of the relevant plug-in

code - the plug-in-specific status code

children - the list of children status objects

message - a human-readable message, localized to the current locale

exception - a low-level exception, or null if not applicable

MultiStatus

public MultiStatus(String pluginId,
                   int code,
                   String message,
                   Throwable exception)

Creates and returns a new multi-status object with no children.

Parameters:

pluginId - the unique identifier of the relevant plug-in

code - the plug-in-specific status code

message - a human-readable message, localized to the current locale

exception - a low-level exception, or null if not applicable

Method Detail

add

public void add(IStatus status)

Adds the given status to this multi-status.

Parameters:

status - the new child status

addAll

public void addAll(IStatus status)

Adds all of the children of the given status to this multi-status. Does nothing if the given status has no children (which includes the case where it is not a multi-status).

Parameters:

status - the status whose children are to be added to this one

getChildren

public IStatus[] getChildren()

Description copied from interface: IStatus

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

Specified by:

getChildren in interface IStatus

Overrides:

getChildren in class Status

Returns:

an array of status objects

See Also:

IStatus.isMultiStatus()

isMultiStatus

public boolean isMultiStatus()

Description copied from interface: IStatus

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.

Specified by:

isMultiStatus in interface IStatus

Overrides:

isMultiStatus in class Status

Returns:

true for a multi-status, false otherwise

See Also:

IStatus.getChildren()

merge

public void merge(IStatus status)

Merges the given status into this multi-status. Equivalent to add(status) if the given status is not a multi-status. Equivalent to addAll(status) if the given status is a multi-status.

Parameters:

status - the status to merge into this one

See Also:

add(org.eclipse.core.runtime.IStatus), addAll(org.eclipse.core.runtime.IStatus)

toString

public String toString()

Returns a string representation of the status, suitable for debugging purposes only.

Overrides:

toString in class Status