Génie logiciel api-design

4

MVC est assez simple. Il y a un modèle, un contrôleur et une vue. Lorsque nous créons un site Web, tout se rassemble lorsque le client envoie une demande de mot clé REST au serveur -> le serveur correspond à l'URL demandée pour l'action du contrôleur -> qui appelle ensuite …

12 design-patterns mvc rest api api-design

3

Comment concevoir une API REST pour gérer les opérations non CRUD?

J'essaie de convertir un ensemble de services basés sur SOAP en une API RESTful. J'ai commencé par identifier les ressources en analysant les noms des opérations et j'ai obtenu la ressource Subscription. Lorsque j'ai besoin de mettre à jour l'état de l'abonnement, je ne peux pas simplement envoyer une POSTdemande …

11 rest web-services api-design web-api

3

Raisons derrière l'implémentation C # String.Split () non intuitive

En C # si je veux diviser un stringpar un autre, stringje dois faire quelque chose comme ça: testString.Split(new string[] { "anotherString" }, StringSplitOptions.None); De la String.Splitdocumentation MSDN surchargée, nous pouvons voir la mise en œuvre et pourquoi un tel appel doit être effectué. Venant de Python , il m'est …

10 c# performance api-design

2

Architecture du système d'alerte

Je voudrais créer un système qui gère les messages d'alerte de divers programmes et peut traiter ces alertes par e-mail auprès des consommateurs en aval. Tout cela serait contenu sur un seul réseau interne. Je pense que je veux que l'architecture de base ressemble à ceci: La principale préoccupation que …

10 design design-patterns architecture api api-design

1

Pourquoi les opérateurs Null-Safe (par exemple «opérateur Elvis») ont-ils été rejetés dans le cadre du «Project Coin» de Java 7?

L'une des fonctionnalités proposées pour le "Project Coin" de Java 7 était "l'opérateur Elvis". Un rapport d'une présentation JavaOne 2009 sur Project Coin le décrit comme tel: L'une des «petites fonctionnalités» abordées dans cette présentation est ce que l'on appelle «l'opérateur Elvis», une version plus concise de l'opérateur ternaire. Je …

10 java api-design

4

Inclure un lien vers la documentation pertinente dans le message d'erreur?

Nous créons une bibliothèque commerciale et des exemples de code qui sont utilisés par des développeurs externes. Nous avons une documentation (fermée, disponible pour les utilisateurs enregistrés) qui explique en détail comment utiliser la bibliothèque. Beaucoup de développeurs sont de nouveaux utilisateurs, donc beaucoup d'erreurs rudimentaires sont rencontrées. Est-il approprié …

10 documentation api-design error-handling error-messages

2

Pourquoi les exceptions vérifiées et non contrôlées sont-elles appelées «la controverse» dans le didacticiel Oracle Java?

Je suis nouveau sur Java et lisais sa documentation sur les exceptions. , et en particulier la page Exceptions non vérifiées - La controverse . Le résultat net dit: Si l'on peut raisonnablement s'attendre à ce qu'un client se remette d'une exception, faites-en une exception vérifiée. Si un client ne …

10 java api-design exceptions

2

La «loi de Demeter» est-elle applicable aux signatures de méthodes publiques / API?

Étant donné que les modifications apportées à la signature API / méthode publique devraient être minimes pour éviter de casser les codes clients qui utilisent ces méthodes, je me demandais si la loi de Demeter est moins applicable à ceux-ci. Un exemple simple: class Account() { double balance; public void …

10 design api-design

5

Pièges de conception d'API en C [fermé]

Fermé . Cette question est basée sur l'opinion . Il n'accepte pas actuellement les réponses. Voulez-vous améliorer cette question? Mettez à jour la question afin d'y répondre avec des faits et des citations en modifiant ce message . Fermé il y a 4 ans . Quelles sont les failles qui …

10 c api-design pitfalls

2

Qu'est-ce qu'un bon code d'état de réponse à POST lorsque la ressource parent n'est pas trouvée?

J'ai le point de terminaison suivant: a/{id}/b et souhaitez créer une demande d' benvoi POST. Si aavec donné {id}n'est pas trouvé, dois-je répondre avec 404 NOT_FOUNDou peut-être avec 409 CONFLICT? Il s'agit de gérer simplement a/{id}, l'astuce est qu'ici une sous-ressource est utilisée.

10 rest api api-design http-request

2

Comment éviter l'utilisation non autorisée d'une API?

Je dois concevoir un "widget", un script que les partenaires intégreront dans leurs sites Web pour afficher une interface utilisateur et passer des appels à notre API. Fondamentalement, il affichera nos données sur ces sites en fonction de certains identifiants qu'ils fournissent dans nos appels API. Ce que nous aimerions …

10 security api-design web-api

3

Comment concevoir une méthode TryParse qui fournit des informations détaillées en cas d'erreur d'analyse?

Lors de l'analyse des entrées utilisateur, il est généralement recommandé de ne pas lever et intercepter les exceptions mais plutôt d'utiliser des méthodes de validation. Dans le .NET BCL, ce serait la différence entre, par exemple, int.Parse(lève une exception sur les données non valides) et int.TryParse(renvoie falsesur les données non …

9 c# .net api-design

3

Est-ce une mauvaise pratique qu'une définition d'objet API contienne des ID de référence tiers en tant que propriétés?

Comme ça: Campaign: type: object properties: id: type: string description: "A GUID identifier" referenceId: type: string description: "A consumers identifier they have used to map their own systems logic to this object." name: type: string description: "'Great Campaign 2017' as an example" Je suis préoccupé par le referenceId . Le …

9 rest api domain-driven-design api-design single-responsibility

2

Ajout à un ensemble fini d'options; un changement de rupture API?

Prenez un point de terminaison API HTTP qui crache le modèle de réponse suivant: { "type": "Dog", "name": "Jessi", ... } Le typechamp a été décrit dans la documentation comme étant l'un des Dog, Catou Fish. L'ajout d'une nouvelle option, par exemple Rat, serait-il considéré comme une rupture de l'API? …

9 rest api api-design json

3

Dans le langage REST, quelle est la différence entre une ressource et une représentation?

Ma compréhension de REST qui permet de modéliser les opérations de service comme représentation de l'état et transition d'un état à un autre en utilisant HTTP. J'ai toujours compris les ressources comme des représentations de l'état du service jusqu'à récemment lorsque j'ai lu cet article de Jimmy Bogard que je …

9 rest api api-design

Questions marquées «api-design»