Virheenkäsittely

SWT voi aiheuttaa kolmenlaisia poikkeuksia: IllegalArgumentException-, SWTException- ja SWTError-poikkeuksia. Sovellusten ei tarvitse siepata muita poikkeuslajeja tai virheitä kutsuessaan SWT-ympäristöä.

Huomautus: Jos SWT-ympäristö aiheuttaa jonkin muun poikkeuksen, sitä tulee pitää virheenä SWT-toteutuksessa.

Poikkeukset käsitellään mahdollisuuksien mukaan samalla tavalla eri käyttöympäristöissä. Jotkin virheet liittyvät kuitenkin tietyn käyttöympäristön SWT-toteutukseen.

IllegalArgumentException

SWT-sovellusohjelmaliittymän metodeissa välitettyjen argumenttien tila ja raja-arvot tarkistetaan, ennen kuin muuta työtä tehdään. IllegalArgumentException-poikkeus aiheutuu, jos argumentti todetaan virheelliseksi.

Jos koodi aiheuttaa IllegalArgumentException-poikkeuksen jossakin käyttöympäristössä, se aiheuttaa saman poikkeuksen myös muissa käyttöympäristöissä.

SWTException

SWTException-poikkeus aiheutuu, kun SWT-ympäristössä ilmenee sisäinen korjattavissa oleva virhe. Virhekoodissa ja sanomatekstissä on ongelman tarkempi kuvaus.

SWT-ympäristö säilyy tunnetussa vakaassa tilassa ongelman aiheutumisen jälkeen. Tämä poikkeus ilmenee esimerkiksi, kun SWT-kutsu tehdään muusta kuin käyttöliittymäsäikeestä.

SWTError

SWTError-poikkeus aiheutuu, kun SWT-ympäristössä ilmenee virhe, jota ei voi korjata.

SWT aiheuttaa tämän virheen, kun taustalla oleva käyttöympäristön kutsu epäonnistuu ja SWT jää tuntemattomaan tilaan tai kun SWT-ympäristön tiedetään sisältävän virheen, jota ei voi korjata. Tällaisen virhetilanteen aiheuttaa esimerkiksi käyttöympäristön grafiikkaresurssien loppuminen.

Kun SWT-virhe on ilmennyt, sovellus ei voi tehdä paljoakaan virheen korjaamiseksi. Tällaisia virheitä ei yleensä ilmene, kun sovellusta käytetään normaalisti, mutta luotettavien sovellusten on kuitenkin siepattava ja raportoitava virheet.