Generuję chwiejność service.json i inne resource.jsons podczas cykl budowy maven przez Carma swagger-jaxrs-doclet. Następnie rozmieszczam artefakty wraz z swagger-ui na serwerze internetowym i mogę zapoznać się z wygenerowaną dokumentacją. To znaczy że Nie wdrażam fasoli typu "sztylet" z moją aplikacją!
Od kiedy swagger jest najczęściej wdrażany wzdłuż twojego APIWdrożenie, zastanawiałem się, jakie podejście chce zrobić, aby dokumenty były wykonywalne. Czy przekierowuje z dokumentacji swagger-ui do rzeczywistej implementacji, czy też to robi stworzyć back-back, oparty na service.json? Czytałem, że możliwe jest tworzenie backendu w node.js, na podstawie service.json, ale nie mogę wymyślić, jak to zrobić na stronie internetowej. Jeśli jest to możliwe z poziomu strony internetowej?
Odpowiedzi:
1 dla odpowiedzi № 1Swagger-ui czyta ci specyfikację oszustaudostępnia i udostępnia aplikację HTML, która umożliwia wykonanie interfejsu API, który jest udokumentowany. Nie tworzy backendu, wykorzystuje projekt swagger-js do dynamicznego odczytywania specyfikacji i wykonywania wywołań.
Tak więc dla aplikacji opartych na javascriptach masz swagger-js, ale poza tym jeśli chcesz generować klientów, możesz użyć programu swagger-codegen - https://github.com/wordnik/swagger-codegen - który odczytuje posiadane pliki specyfikacji i pozwala wykonywać różne zadania, takie jak tworzenie klientów, serwerów, dokumentów statycznych i tak dalej.