Implémentation élégante de l'architecture API Golang REST
Jun 17, 2020 pm 05:48 PMIl y a un dicton selon lequel l'API écrite en Golang ne peut pas être aussi simple et universelle que d'autres langages. Mais en réalité, j'ai rencontré beaucoup de code API REST avec beaucoup d'abstractions, rendant la base de code confuse et complexe, nuisant finalement à la lisibilité et à la maintenabilité.
Dans cette série, nous verrons comment créer une liste TODO d'API REST au niveau du produit, une architecture d'extension durable, en commen?ant par les interfaces de routage et de code, puis en ajoutant une base de données mongo et une couche de données Badger, et puis est la couche de protocole d'autorisation (OAuth 2.0)
Dans cette série, nous utiliserons le routage chi.
Pourquoi choisir d'utiliser Chi au lieu de la bibliothèque standard ou de Gin ou router-x pour le routage??
Eh bien, en fait, peu importe ce que vous choisissez d'utiliser. Peu importe ce que vous utilisez pour le routage, les concepts abordés dans cette série vous seront utiles. Mais il y a les avantages suivants qui me font penser que Chi-router est supérieur à la plupart des alternatives?:
et
net/http
100?% compatible avec la bibliothèque standard --- disponible dans l'écosystème Go Utilisez n'importe quel paquet http ou middleware compatible net/http ??>- Aucune dépendance externe --- Purely Go 1.7+ stdlib + net / http
- Puissant - -- De nombreuses entreprises l'utilisent, par exemple?: Pressly, CloudFlare, Heroku, 99Designs
- Léger --- cloqué en ~ 1000 LOC pour le routeur chi
- C'est rapide
- Ce que j'aime le plus, c'est que les anciens gestionnaires http et middleware que vous avez écrits pour d'autres routeurs compatibles net/http fonctionneront toujours très bien. Commen?ons
Le code ci-dessus est au centre de certaines bonnes pratiques
Utiliser un package séparé Pour implémentez la logique de routage, regroupez-les, puis montez-les?:
- Vérifiez l'API afin que vous puissiez mettre à jour l'API sans casser les anciens clients?:
- Utiliser le middleware comme extension. Le code qui utilise beaucoup de routage est très lourd, en fait, il peut être transformé en middleware de liens, comme : l'autorisation, la configuration des en-têtes de réponse, la compression, les journaux de requêtes, la limitation de débit, etc.
- Le routage du Chi a une méthode appelée marche. Paramètres re?us par cette méthode :
- Un rappel.
- Chaque rappel Tous Les itinéraires définis seront rappelés et recevront 4 paramètres?:
- Cha?ne de l'itinéraire réel
- Processeur (fonction), gère les requêtes pour une route donnée
- Une liste de middleware définis dans une route donnée (le middleware est une fonction relativement simple, qui sera appelée avant le gestionnaire est appelé, ils seront donc utilisés avant le traitement de la demande, l'autorisation, etc.)
- Dans mon cas, je vais simplement interroger les routes et imprimer toutes les routes définies. Cela me donne un aper?u de tous les itinéraires disponibles. Ensuite, nous construisons un package de taches, qui enregistre en fait notre logique de taches.
Notes
routes.go,
afin qu'il soit facile à retrouver dans le package- .
Le gestionnaire a une signature de fonction , ce qui signifie que le gestionnaire n'est pas différent de la fa?on dont vous écrivez net/http en utilisant la bibliothèque standard.
Utilisez render.JSON, un wrapper d'encodage/json, qui échappera automatiquement tout le code HTML dans votre réponse JSON et définira le type de contenu sur application/json
func (w http.ResponseWriter,r *http.Request)?
- êtes-vous intimidé par la facilité avec laquelle c'est?? Vous pouvez voir ce projet sur GitHub https://github.com/tonyalaribe/todoapi/tre....
Dans notre prochain article de cette série, nous continuerons à prendre en charge la configuration et l'état partagé. La plupart des projets nécessitent généralement une configuration supplémentaire, telle que des connexions à une base de données, etc. Nous en discuterons dans le prochain article.
Tutoriel recommandé?: "Go Tutorial"
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Outils d'IA chauds

Undress AI Tool
Images de déshabillage gratuites

Undresser.AI Undress
Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover
Outil d'IA en ligne pour supprimer les vêtements des photos.

Clothoff.io
Dissolvant de vêtements AI

Video Face Swap
échangez les visages dans n'importe quelle vidéo sans effort grace à notre outil d'échange de visage AI entièrement gratuit?!

Article chaud

Outils chauds

Bloc-notes++7.3.1
éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise
Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1
Puissant environnement de développement intégré PHP

Dreamweaver CS6
Outils de développement Web visuel

SublimeText3 version Mac
Logiciel d'édition de code au niveau de Dieu (SublimeText3)

La réponse est: les applications GO n'ont pas de disposition de projet obligatoire, mais la communauté adopte généralement une structure standard pour améliorer la maintenabilité et l'évolutivité. 1.CMD / Stocke l'entrée du programme, chaque sous-répertoire correspond à un fichier exécutable, tel que cmd / myapp / main.go; 2. Le code privé à l'intérieur / stocke ne peut pas être importé par des modules externes et est utilisé pour encapsuler la logique et les services commerciaux; 3.PKG / Stores Bibliothèques réutilisables publiquement pour importer d'autres projets; 4.API / stocke éventuellement OpenAPI, Protobuf et autres fichiers de définition d'API; 5.Config /, Scripts / et Web / Store Files de configuration, scripts et ressources Web respectivement; 6. Le répertoire racine contient Go.mod et Go.sum

L'utilisation de Bufio.Scanner est la méthode la plus courante et la plus efficace de lecture de fichiers en ligne par ligne, et convient pour gérer des scénarios tels que les fichiers gros, l'analyse du journal ou les fichiers de configuration. 1. Ouvrez le fichier à l'aide d'os.open et assurez-vous de fermer le fichier via Deferfile.close (). 2. Créez une instance de scanner via bufio.newscanner. 3. Appelez Scanner.Scan () dans la boucle FOR à lire la ligne par ligne jusqu'à ce que FAUS soit renvoyé pour indiquer que la fin du fichier est atteinte ou une erreur se produit. 4. Utilisez Scanner.Text () pour obtenir le contenu de ligne actuel (à l'exclusion des caractères Newline). 5. Vérifier le scanner.err () Une fois la boucle terminée pour attraper d'éventuelles erreurs de lecture. Cette méthode a un effet de mémoire

Le routage dans les applications GO dépend de la complexité du projet. 1. La bibliothèque standard NET / HTTPSERVEMUX convient aux applications simples, sans dépendances externes et est légère, mais ne prend pas en charge les paramètres d'URL et la correspondance avancée; 2. Les routeurs tiers tels que le CHI fournissent des middleware, des paramètres de chemin et un routage imbriqué, qui convient à la conception modulaire; 3. Gin a d'excellentes performances, un traitement JSON intégré et des fonctions riches, ce qui convient aux API et aux microservices. Il doit être sélectionné selon que la flexibilité, les performances ou l'intégration fonctionnelle sont nécessaires. Les petits projets utilisent des bibliothèques standard, les projets moyens et grands recommandent du chi ou du gin et finissent par obtenir une expansion fluide de simple à complexe.

Le package Flag de Go peut facilement analyser les paramètres de ligne de commande. 1. Utilisez Flag.Type () pour définir des drapeaux de type tels que les cha?nes, les entiers et les booléens; 2. Vous pouvez analyser les drapeaux aux variables via Flag.Typevar () pour éviter les opérations de pointeur; 3. Après avoir appelé Flag.Parse (), utilisez Flag.Args () pour obtenir des paramètres de position ultérieurs; 4. Implémentation de l'interface Flag.Value peut prendre en charge les types personnalisés pour répondre à la plupart des exigences CLI simples. Les scénarios complexes peuvent être remplacés par la bibliothèque SPF13 / COBRA.

L'instruction IF-ELSE dans GO ne nécessite pas de supports mais doit utiliser des accolades bouclées. Il prend en charge l'initialisation des variables dans si pour limiter la portée. Les conditions peuvent être jugées via la cha?ne ELLEIF, qui est souvent utilisée pour la vérification des erreurs. La combinaison de la déclaration et des conditions variables peut améliorer la simplicité et la sécurité du code.

Dans GO, les constantes sont déclarées en utilisant le mot-clé const, et la valeur ne peut pas être modifiée et ne peut être pas de type ni de type; 1. Une seule déclaration constante telle que constpi = 3,14159; 2. Plusieurs déclarations constantes dans le bloc sont telles que const (pi = 3,14159; linguisse = "go"; isCool = true); 3. Constantes de type explicite telles que ConstseConDSInMinuteInt = 60; 4. Utilisez Iota pour générer des valeurs d'énumération, telles que const (dimanche = iota; lundi; mardi) attribuera des valeurs 0, 1 et 2 en séquence, et Iota peut être utilisé pour des expressions telles que les opérations binaires; Les constantes doivent déterminer la valeur au moment de la compilation,

Gorun est une commande pour compiler et exécuter rapidement les programmes GO. 1. Il termine la compilation et l'exécution en une seule étape, génère des fichiers exécutables temporaires et les supprime une fois le programme terminé; 2. Il convient aux programmes indépendants contenant des fonctions principales, qui sont faciles à développer et à tester; 3. Il prend en charge l'opération multi-fichiers et peut être exécutée via Gorun * .go ou répertorie tous les fichiers; 4. Il traite automatiquement les dépendances et utilise le système de modules pour analyser les packages externes; 5. Il ne convient pas aux bibliothèques ou aux packages et ne génère pas de fichiers binaires persistants. Par conséquent, il convient aux tests rapides pendant les scripts, l'apprentissage et les modifications fréquentes. C'est une fa?on efficace et concise de courir.

Pour vous connecter aux bases de données SQL dans GO, vous devez utiliser le package de base de données / SQL et un pilote de base de données spécifique. 1. Importez des packages et des pilotes de base de données (tels que github.com/go-sql-driver/mysql), notez que les soulignements avant que les pilotes indiquent qu'ils ne sont utilisés que pour l'initialisation; 2. Utilisez sql.open ("mysql", "utilisateur: mot de passe @ tcp (localhost: 3306) / dbname") pour créer une poignée de base de données et appeler db.ping () pour vérifier la connexion; 3. Utilisez db.query () pour exécuter des requêtes, et db.exec () pour exécuter
