Ošetřování chyb

SWT může spouštět tři typy výjimek: IllegalArgumentException, SWTException a SWTError. Aplikace by při volání SWT neměly zachytávat žádný jiný druh výjimky či chyby.

Poznámka: Pokud došlo k vyvolání nějaké jiné výjimky z SWT kromě těchto tří, mělo by to být považováno za chybu v implementaci SWT.

Tam, kde je to možné, se výjimky spouštějí na všech platformách konzistentně. Některé chyby jsou ovšem specifické pro implementaci SWT na konkrétní platformě.

IllegalArgumentException

U argumentů zadaných v metodách rozhraní API SWT je kontrolován odpovídající stav a rozsah hodnot předtím, než se provede jakákoli další práce. IllegalArgumentException se vyvolá, když se určí, že je argument neplatný.

Kód, který způsobí IllegalArgumentException na jedné platformě, způsobí stejnou výjimku na jiné platformě.

SWTException

SWTException se vyvolá, když se interně v SWT vyskytne napravitelná chyba. Chybový kód a text zprávy poskytnou další popis problému.

SWT po vyvolání výjimky setrvává ve známém a stabilním stavu. Tato výjimka se například vyvolá, když se volání SWT uskuteční z podprocesu nespadajícího do uživatelského rozhraní.

SWTError

SWTError se vyvolá, když se v SWT vyskytne nezotavitelná chyba.

SWT tuto chybu vyvolá, když selže volání základní platformy, což SWT zanechá v neznámém stavu, nebo když je známo, že SWT má nezotavitelnou chybu, jako je nedostatek grafických prostředků platformy.

Když se vyskytla chyba SWT, je málo pravděpodobné, že by aplikace mohla problém opravit. Tyto chyby by neměly být rozpoznány během normálního průběhu činnosti v aplikaci, ale aplikace s vysokou spolehlivostí přesto mohou chyby zachytit a oznámit.