Questions marquées «api-design»

7
Quelles sont les meilleures pratiques pour les ressources imbriquées REST?
Autant que je sache, chaque ressource individuelle ne devrait avoir qu'un seul chemin canonique . Dans l'exemple suivant, quels seraient les bons modèles d'URL? Prenons par exemple une représentation représentative des entreprises. Dans cet exemple hypothétique, chaque entreprise possède 0 ou plusieurs départements et chaque département possède 0 ou plusieurs …
301 rest  api-design 
11
Meilleures pratiques de pagination API
J'adorerais avoir de l'aide pour gérer un cas de bord étrange avec une API paginée que je construis. Comme de nombreuses API, celle-ci affiche de grands résultats. Si vous interrogez / foos, vous obtiendrez 100 résultats (c'est-à-dire foo # 1-100), et un lien vers / foos? Page = 2 qui …
5
Pourquoi les flux Java sont-ils uniques?
Contrairement à C # IEnumerable, où un pipeline d'exécution peut être exécuté autant de fois que nous le voulons, en Java, un flux ne peut être "itéré" qu'une seule fois. Tout appel à une opération de terminal ferme le flux, le rendant inutilisable. Cette «fonctionnalité» enlève beaucoup de puissance. J'imagine …
7
Quand dois-je utiliser les paramètres de chemin par rapport aux paramètres de requête dans une API RESTful?
Je veux rendre mon API RESTful très prévisible. Quelle est la meilleure pratique pour décider quand effectuer une segmentation des données en utilisant l'URI plutôt qu'en utilisant des paramètres de requête. Il est logique pour moi que les paramètres système qui prennent en charge la pagination, le tri et le …
4
Pourquoi String.valueOf (null) lève-t-il une NullPointerException?
selon la documentation, la méthode String.valueOf(Object obj)retourne: si l'argument est null, alors une chaîne égale à "null"; sinon, la valeur de obj.toString()est renvoyée. Mais comment se fait-il que j'essaye de faire ceci: System.out.println("String.valueOf(null) = " + String.valueOf(null)); il jette NPE à la place? (essayez-le vous-même si vous ne croyez pas!) …
28
Anglais GB ou anglais américain?
Si vous avez une API et que vous êtes un développeur basé au Royaume-Uni avec une audience très internationale, votre API devrait-elle être setColour() ou setColor() (Pour prendre un mot comme exemple simple.) Les ingénieurs basés au Royaume-Uni sont souvent assez défensifs quant à leur orthographe «correcte», mais on pourrait …
En utilisant notre site, vous reconnaissez avoir lu et compris notre politique liée aux cookies et notre politique de confidentialité.
Licensed under cc by-sa 3.0 with attribution required.