Je génère le swagger service.json et autre resource.jsons pendant le cycle de construction via le Carma swagger-jaxrs-doclet. Ensuite, je déploie les artefacts, ainsi que swagger-ui sur un serveur Web, et je peux consulter la documentation générée. Cela signifie que Je ne déploie pas un haricot fanfaron avec ma candidature!
Swagger étant principalement déployé le long de votre APIJe me demandais quelle approche swagger-ui adoptait pour rendre les documents exécutables. Est-ce qu'il redirige depuis la documentation swagger-ui vers la mise en œuvre réelle ou créer une maquette, basée sur le service.json? J'ai lu qu'il est possible de créer un backend dans node.js, basé sur le service.json, mais je n'arrive pas à comprendre comment le faire dans la page Web. Je ne le fais même pas maintenant si c'est possible à partir de la page Web?
Réponses:
1 pour la réponse № 1Swagger-ui lit les spécifications de swagger vousexpose et expose une application HTML qui vous permet d'exécuter l'API documentée. Il ne crée pas de back-end, il utilise le projet swagger-js pour lire dynamiquement la spécification et exécuter les appels.
Donc, pour les applications basées sur JavaScript, vous avez swagger-js, mais sinon, si vous voulez générer des clients, vous pouvez utiliser swagger-codegen - https://github.com/wordnik/swagger-codegen - qui lit vos fichiers de spécification et vous permet d’effectuer diverses tâches telles que la création de clients, de serveurs, de documents statiques, etc.