Discussion :

[Mickael Baron]

Bonjour,

Fran�ois-Xavier Robin nous propose un tutoriel pour apprendre � contr�ler les arguments des m�thodes quand on �labore une interface de programmation API avec le langage Java.

Pour consulter le tutoriel : https://fxrobin.developpez.com/tutor...-methodes-api/

N'h�sitez pas � laisser des commentaires � la suite.

Mickael BARON pour l'�quipe Java de Developpez.com

Retrouver les meilleurs cours et tutoriels pour apprendre la programmation en Java

[professeur shadoko]

au del� des aspects purement techniques il me semble qu'il faut beaucoup insister aupr�s des d�veloppeurs sur l'impact des pr�conditions.
Un d�faut peut-�tre "mortel" (no way: je veux pas continuer, le code va planter) ou constituer une incitation � confirmation (� re-traiter par le code appelant).
J'ai en effet des tonnes d'exemples de refus d'ex�cution parce que les limites du test sont certes inqui�tantes mais pas mortelles: �a arrive souvent quand on a des formulaires avec des listes: �tat � l'int�rieur d'un pays (typique des formulaires am�ricains), code postal ne prenant que des chiffres (impossible dans certains pays), limite d'age (oui �a m'est arriv�: j'�tais employ� dans une bo�te ou les d�veloppeurs ne pouvaient imaginer qu'un salari� puisse �tre n� avant 1950!), pays (que faire si vous �tes "apatride n� dans la bande de Gaza sous administration �gyptienne"?), espace dans le pr�nom ou autre caract�re "bizarre" (�a m'est aussi arriv� avec un loueur de voiture. Bref si vous vous appelez 'Gaston Adh�mar de T�te en Pointe' vous �tes foutu !), etc.

[jowo]

Le troll du vendredi

ou n� le 0.0.1964 si votre date r�elle de naissance n'est pas connue et que l'administration suisse vous a attribu� cette date de naissance sur vos documents administratifs (carte d'identit�, passeport et autre...)

SVP ne pas tirer sur le

[Mickael Baron]

Bonjour,

Je vais demander � Fran�ois-Xavier, l'auteur de l'article, de venir r�pondre � vos remarques.

Mickael

[fxrobin]

Je vais demander � Jean-Fran�ois, l'auteur de l'article, de venir r�pondre � vos remarques.Mickael

Mickael, tu ne devais pas �tre fort au Mastermind : tu en as un seul et de mal plac� !


Pour r�pondre � professeur shadoko et jowo,

je suis assez d'accord avec vous, car il m'arrive encore d'�tre g�n� quand il s'agit de remplir mon pr�nom dans certains formulaires quand un "d�veloppeur" a estim� que 10 caract�res suffiraient.
C'est d'ailleurs l� le probl�me � mon avis : ce n'est pas au d�veloppeur d'estimer cela, c'est une "pr�condition" m�tier, sp�cifi�e par le m�tier !

Enfin, c'est quand m�me un tout petit peu hors sujet : mon article traite des pr�conditions d'API.
C'est � dire "backend" m�me si on pourrait l'�tendre � certains "frontends".

Il s'agit en priorit� de contr�ler les arguments qui "arrivent" dans une m�thode, pour �viter des valeurs nulles alors qu'elles sont n�cessaires ou encore des listes vides (ou nulles) alors qu'elles sont sens�es ne pas l'�tre.

Il faut absolument alors tester que les arguments soient "acceptables" avant de commencer tout traitement qui n�cessiteraient au mieux un rollback, au pire une complexit� cyclomatique (multi-imbrications de if / else) �lev�e pour g�rer les cas d'erreurs.

Ne pas tester les arguments, revient potentiellement au code (et au bug) qui a eu pour cons�quence le crash d'Ariane 5

A titre personnel, je ne teste pas partout tous les arguments, mais essentiellement sur ce que "j'offre" � l'ext�rieur. (D'ailleurs, c'est stipul� dans l'article).
Il ne s'agit pas de contraindre trop fortement ce qui "arrive", mais de contr�ler quand m�me un semblant d'information correcte.

Quant � la date du 00/00/1964 en Suisse (que je ne connaissais pas) ... comment dire ... encore un syst�me o� le "m�tier" n'a pas su dire (ou �tre entendu) sur le fait qu'une date pouvait aussi �tre "ind�termin�e".

Merci de vos r�actions !

Fran�ois-Xavier.

[Mickael Baron]

Mickael, tu ne devais pas �tre fort au Mastermind : tu en as un seul et de mal plac� !

Sinc�rement d�sol�, il �tait tard et je suis perdu avec toutes les personnes avec des noms compos�s. Encore d�sol�.

Merci beaucoup pour ta r�ponse

Mickael

[fxrobin]

Sinc�rement d�sol�, il �tait tard et je suis perdu avec toutes les personnes avec des noms compos�s. Encore d�sol�.

Non mais, je te rassure, j'ai plus rigol� qu'autre chose ! Ne t'inqui�te pas !