Questions marquées «api-design»

La conception de l'API (Application Programming Interface) décrit les meilleures pratiques pour la création de bibliothèques destinées à un usage général ou public.

5
Fonction renvoyant vrai / faux vs vide en cas de réussite et levée d'une exception en cas d'échec
Je construis une API, une fonction qui télécharge un fichier. Cette fonction ne retournera rien / annulera si le fichier a été téléchargé correctement et lève une exception en cas de problème. Pourquoi une exception et pas seulement une fausse? Parce qu'à l'intérieur d'une exception je peux spécifier la raison …
4
Abstraction de la base de données - est-elle exagérée?
Après avoir été exposée à de nombreuses couches d'abstraction de bases de données, je commence à me demander à quoi sert chaque bibliothèque inventant son propre paradigme pour accéder aux données. Reprendre un nouveau DAL, c'est comme recommencer une nouvelle langue, alors que d'habitude, je veux simplement convaincre la couche …
18 database  sql  api-design  dsl 
4
Pourquoi Java String n'a-t-il pas de méthodes de manipulation de chaînes statiques?
Pourquoi les concepteurs Java n'ont-ils pas créé des versions statiques des méthodes de manipulation de chaînes dans la java.lang.Stringclasse? Je fais référence aux méthodes suivantes, mais la question peut également être étendue à d'autres méthodes non statiques de la classe. concat(String) substring(int, int) replace(char, char) toLowerCase() replace(CharSequence, CharSequence) toLowerCase(Locale) replaceAll(String, …
17 java  api-design  null 
3
Détection des «machines d'état» IEnumerable
Je viens de lire un article intéressant intitulé Trop mignon avec le rendement c # Cela m'a fait me demander quelle est la meilleure façon de détecter si un IEnumerable est une collection énumérable réelle, ou s'il s'agit d'une machine d'état générée avec le mot-clé yield. Par exemple, vous pouvez …
17 c#  api-design 
3
Quand dois-je utiliser string_view dans une interface?
J'utilise une bibliothèque interne qui a été conçue pour imiter une bibliothèque C ++ proposée , et au cours des dernières années, je vois son interface passer de l'utilisation std::stringàstring_view . Je change donc consciencieusement mon code, pour me conformer à la nouvelle interface. Malheureusement, ce que je dois transmettre …
2
Quand utiliser les ressources imbriquées dans une API RESTful
J'ai deux ressources: les utilisateurs et les liens. Les utilisateurs peuvent avoir plusieurs liens associés. J'ai conçu mon API RESTful pour que vous puissiez accéder aux liens associés à un utilisateur à l'URI suivant: /users/:id/links Cependant, j'ai toujours besoin d'un URI pour les liens uniquement - parfois, je peux vouloir …
16 api  rest  api-design 
1
API RESTful et i18n: comment concevoir la réponse?
Nous concevons une API RESTful qui est principalement destinée à répondre aux besoins d'un seul client. En raison de sa situation très particulière, ce client doit faire le moins de demandes possible. L'API gère i18n via un en-tête Accept-Language dans les demandes. Cela fonctionne pour tout ce que le client …
15 rest  api  api-design  http 
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.