saselang-bible/examples/018-result-erreurs-et-exceptions-examples.md

Exemples / DO-DON'T — Chapitre 18 — Result, erreurs et exceptions

Document compagnon non normatif tant qu'une règle n'est pas explicitement référencée comme normative par le chapitre.

Exemples actuellement présents dans le chapitre

Exemple 1

Object
└── Error
    ├── ResultError
    └── Exception

Exemple 2

public final class ParseError extends ResultError {
}

public final class FileNotFoundException extends Exception {
}

Exemple 3

message: String
cause: Option<Error>
i18nMessage: Option<I18nMessage>

Exemple 4

message
    message humain canonique / fallback

cause
    erreur causale purement informative
    peut contenir un ResultError ou une Exception
    n'est pas automatiquement propagée

i18nMessage
    clé et paramètres de localisation
    ne contient pas un tableau de traductions

Exemple 5

code: ResultErrorCode

Exemple 6

code       -> stable, machine-readable, non localisé
message    -> humain, canonique / fallback
i18nMessage -> localisation externe

Exemple 7

throw exception;

Exemple 8

Result::Ok(T)
Result::Err(E)

Exemple 9

E doit être ResultError ou un descendant de ResultError

Exemple 10

Result<Data,ResultError>
Result<Data,ParseError>
Result<Void,ResultError>

Exemple 11

Result<Data,Error>
Result<Data,Exception>
Result<Data,FileNotFoundException>

Exemple 12

Result<T>

Exemple 13

Result<T,ResultError>

Exemple 14

return Result::Ok(value);
return Result::Err(error);

Exemple 15

result::expectOk(...)
result::expectErr(...)

Exemple 16

ResultError -> Exception
Exception   -> ResultError

Exemple 17

throw ParseException(..., Option::Some(parseError));

Exemple 18

catch (FileNotFoundException error) {
    return Result::Err(FileResultError(..., Option::Some(error)));
}

Exemple 19

T + throws            -> interdit
Result<T,E>            -> valide sans throws
Result<T,E> + throws   -> valide

Exemple 20

throws IOException

Exemple 21

supprimer entièrement des exceptions déclarées
restreindre une famille à une ou plusieurs sous-familles compatibles
gérer localement tout ou partie des exceptions du contrat parent

Exemple 22

throw FileNotFoundException(...);    // valide
throw ParseError(...);               // erreur
throw Error(...);                    // erreur

Exemple 23

catch (IOException error) {
    throw error;
}

Exemple 24

try { ... }
try { ... } finally { ... }
finally { ... }

Exemple 25

try {
    ...
} catch (SpecificException error) {
    ...
} catch (ParentException error) {
    ...
} finally {
    ...
}

Exemple 26

catch (FileNotFoundException error) {
    ...
} catch (IOException error) {
    ...
}

Exemple 27

catch (IOException error) {
    ...
} catch (FileNotFoundException error) {
    ...
}

Exemple 28

fin normale du try
fin normale d'un catch
return traversant la construction
throw propagé
break / continue traversant la construction
Exception non capturée par les catch

Exemple 29

return
throw
break
continue
emit

Exemple 30

index hors limites
division entière par zéro
overflow checked
représentation mémoire invalide
borne dynamique invalide lors d'une construction directe lorsque la règle du type le définit

DO / DON'T / WHY / compiler error / edge cases

La couverture structurée de cette section sera enrichie au fur et à mesure de la fermeture des règles du chapitre. La migration 0.2.12 conserve volontairement les exemples historiques dans le chapitre afin de ne perdre aucun contexte normatif.