Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
serveurscrutari:json:messages [2011/03/21 19:28] vincent |
serveurscrutari:json:messages [2011/03/21 20:16] vincent |
||
---|---|---|---|
Ligne 5: | Ligne 5: | ||
Les erreurs sont envoyées si le le serveur est dans l'incapacité de faire le traitement, elle sont révélatrices de bogues côté client. Une erreur ne devrait jamais avoir lieu du fait de la saisie de l'utilisateur final. Par exemple, si l'utilisateur fait une recherche sur les fiches avec une chaine composée uniquement de caractères spéciaux (« "'(\ »), il ne s'agit pas d'une erreur pour le serveur qui renverra simplement un objet //ficheSearchResult// avec //qLength = 0// (ce qui signifie que la séquence de recherche est vide), à charge pour le client d'alerter l'utilisateur final sur sa saisie incorrecte. | Les erreurs sont envoyées si le le serveur est dans l'incapacité de faire le traitement, elle sont révélatrices de bogues côté client. Une erreur ne devrait jamais avoir lieu du fait de la saisie de l'utilisateur final. Par exemple, si l'utilisateur fait une recherche sur les fiches avec une chaine composée uniquement de caractères spéciaux (« "'(\ »), il ne s'agit pas d'une erreur pour le serveur qui renverra simplement un objet //ficheSearchResult// avec //qLength = 0// (ce qui signifie que la séquence de recherche est vide), à charge pour le client d'alerter l'utilisateur final sur sa saisie incorrecte. | ||
- | De la même manière, un paramètre optionnel incorrect (par exemple; //limit// qui n'a pas comme valeur un entier) ne donnera pas lieu à l'envoi d'un message d'erreur car le serveur prend alors la valeur par défaut du paramètre. Il est possible d'être informé d'une telle erreur avec les messages d'avertissement. | + | De la même manière, un paramètre optionnel incorrect (par exemple; //limit// qui n'a pas comme valeur un entier) ne donnera pas lieu à l'envoi d'un message d'erreur car le serveur prend alors la valeur par défaut du paramètre. Ce type d'erreur est géré par les [[serveurscrutari:json:warnings|messages d'avertissement]]. |
Une erreur est composé de trois éléments : une clé indiquant la nature de l'erreur, le paramètre concerné par l'erreur, la valeur de paramètre éventuellement à l'origine de l'erreur | Une erreur est composé de trois éléments : une clé indiquant la nature de l'erreur, le paramètre concerné par l'erreur, la valeur de paramètre éventuellement à l'origine de l'erreur | ||
Ligne 28: | Ligne 28: | ||
value: … , // valeur de paramètre à l'origine de l'erreur (optionnel, chaine) | value: … , // valeur de paramètre à l'origine de l'erreur (optionnel, chaine) | ||
} | } | ||
+ | } | ||
</code> | </code> | ||