Questions marquées «api-design»

288
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 devrait...

239
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...

93
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...