#include <berryIStatus.h>

Inheritance diagram for berry::IStatus:

Collaboration diagram for berry::IStatus:

Public Types
enum	Severity { OK_TYPE, INFO_TYPE, WARNING_TYPE, ERROR_TYPE, CANCEL_TYPE }

typedef berry::IStatus	Self

typedef berry::SmartPointer< Self >	Pointer

typedef berry::SmartPointer< const Self >	ConstPointer

typedef berry::WeakPointer< Self >	WeakPtr

typedef berry::WeakPointer< const Self >	ConstWeakPtr

Public Types inherited from berry::Object
typedef Object	Self

typedef berry::SmartPointer< Self >	Pointer

typedef berry::SmartPointer< const Self >	ConstPointer

typedef berry::WeakPointer< Self >	WeakPtr

typedef berry::WeakPointer< const Self >	ConstWeakPtr

Public Member Functions
virtual QList< IStatus::Pointer >	GetChildren () const =0

virtual int	GetCode () const =0

virtual const ctkException *	GetException () const =0

virtual QString	GetMessage () const =0

virtual QString	GetPlugin () const =0

virtual Severity	GetSeverity () const =0

virtual bool	IsMultiStatus () const =0

virtual bool	IsOK () const =0

virtual bool	Matches (const Severities &severityMask) const =0

virtual QString	GetFileName () const =0

virtual QString	GetMethodName () const =0

virtual int	GetLineNumber () const =0

Public Member Functions inherited from berry::Object
virtual QString	GetClassName () const

virtual Reflection::TypeInfo	GetTypeInfo () const

virtual QList< Reflection::TypeInfo >	GetSuperclasses () const

virtual void	Delete ()

QDebug	Print (QDebug os, Indent Indent=0) const

virtual QString	ToString () const

virtual uint	HashCode () const

virtual bool	operator< (const Object *) const

void	Register () const

void	UnRegister (bool del=true) const

int	GetReferenceCount () const

void	SetReferenceCount (int)

void	AddDestroyListener (const MessageAbstractDelegate<> &delegate) const

void	RemoveDestroyListener (const MessageAbstractDelegate<> &delegate) const

virtual bool	operator== (const Object *) const

Static Public Member Functions
static const char *	GetStaticClassName ()

Static Public Member Functions inherited from berry::Object
static const char *	GetStaticClassName ()

static Reflection::TypeInfo	GetStaticTypeInfo ()

static QList< Reflection::TypeInfo >	GetStaticSuperclasses ()

Additional Inherited Members
Protected Member Functions inherited from berry::Object
	Object ()

virtual	~Object ()

virtual QDebug	PrintSelf (QDebug os, Indent indent) const

virtual QDebug	PrintHeader (QDebug os, Indent indent) const

virtual QDebug	PrintTrailer (QDebug os, Indent indent) const

Protected Attributes inherited from berry::Object
QAtomicInt	m_ReferenceCount

QMutex	m_ReferenceCountLock

Detailed Description

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.

This interface can be used without OSGi running.

See also: MultiStatus; Status

Definition at line 56 of file berryIStatus.h.

Member Typedef Documentation

typedef berry::SmartPointer<const Self> berry::IStatus::ConstPointer

Definition at line 58 of file berryIStatus.h.

typedef berry::WeakPointer<const Self> berry::IStatus::ConstWeakPtr

Definition at line 58 of file berryIStatus.h.

typedef berry::SmartPointer<Self> berry::IStatus::Pointer

Definition at line 58 of file berryIStatus.h.

typedef berry::IStatus berry::IStatus::Self

Definition at line 58 of file berryIStatus.h.

typedef berry::WeakPointer<Self> berry::IStatus::WeakPtr

Definition at line 58 of file berryIStatus.h.

Member Enumeration Documentation

enum berry::IStatus::Severity

Enumerator
OK_TYPE	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.
INFO_TYPE	Status type severity (bit mask, value 1) indicating this status is informational only.
WARNING_TYPE	Status type severity (bit mask, value 2) indicating this status represents a warning.
ERROR_TYPE	Status type severity (bit mask, value 4) indicating this status represents an error.
CANCEL_TYPE	Status type severity (bit mask, value 8) indicating this status represents a cancelation.

Definition at line 58 of file berryIStatus.h.

Member Function Documentation

virtual QList<IStatus::Pointer> berry::IStatus::GetChildren ( ) const

pure virtual

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

Returns: an array of status objects

See also: #isMultiStatus()

Implemented in berry::Status, and berry::MultiStatus.

virtual int berry::IStatus::GetCode ( ) const

pure virtual

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

Returns: plug-in-specific status code

Implemented in berry::Status.

virtual const ctkException* berry::IStatus::GetException ( ) const

pure virtual

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.

Returns: the relevant low-level exception, or null if none

Implemented in berry::Status.

virtual QString berry::IStatus::GetFileName ( ) const

pure virtual

Implemented in berry::Status.

virtual int berry::IStatus::GetLineNumber ( ) const

pure virtual

Implemented in berry::Status.

virtual QString berry::IStatus::GetMessage ( ) const

pure virtual

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

Returns: a localized message

Implemented in berry::Status.

virtual QString berry::IStatus::GetMethodName ( ) const

pure virtual

Implemented in berry::Status.

virtual QString berry::IStatus::GetPlugin ( ) const

pure virtual

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

Returns: the unique identifier of the relevant plug-in

Implemented in berry::Status.

virtual Severity berry::IStatus::GetSeverity ( ) const

pure virtual

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

CANCEL_TYPE - cancelation occurred
ERROR_TYPE - a serious error (most severe)
WARNING_TYPE - a warning (less severe)
INFO_TYPE - an informational ("fyi") message (least severe)
OK_TYPE - 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.

Returns: the severity: one of OK_TYPE, ERROR_TYPE, INFO_TYPE, WARNING_TYPE, or CANCEL_TYPE

See also: #matches(int)

Implemented in berry::Status.

static const char* berry::IStatus::GetStaticClassName ( )

inlinestatic

Definition at line 58 of file berryIStatus.h.

virtual bool berry::IStatus::IsMultiStatus ( ) const

pure virtual

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

Returns: true for a multi-status, false otherwise

See also: #getChildren()

Implemented in berry::Status, and berry::MultiStatus.

virtual bool berry::IStatus::IsOK ( ) const

pure virtual

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

Returns: true if this status has severity OK, and false otherwise

Implemented in berry::Status.

virtual bool berry::IStatus::Matches ( const Severities & severityMask ) const

pure virtual

Returns whether the severity of this status matches the given severity mask. Note that a status with severity OK_TYPE will never match; use isOK instead to detect a status with a severity of OK.

Parameters

severityMask a mask formed by bitwise or'ing severity mask constants (ERROR_TYPE, WARNING_TYPE, INFO_TYPE, CANCEL_TYPE)

Returns: true if there is at least one match, false if there are no matches

See also: #getSeverity(); CANCEL_TYPE; ERROR_TYPE; WARNING_TYPE; INFO_TYPE

Implemented in berry::Status.

The documentation for this struct was generated from the following file:

berryIStatus.h

Public Types

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Member Function Documentation