2016-03-22 12 views
5

Używam implementacji Swagger Springfox. Chciałbym zmodyfikować plik swagger-ui.html, aby pobrać niestandardową wartość nagłówka. Jak mogę zmodyfikować ten plik? Albo powiesz Lisowi wiosna, żeby użył alternatywnego pliku?Jak zmodyfikować plik swagger-ui.html dla springfox?

+0

Mogłem acheive to postępując zgodnie z instrukcjami tutaj: https://github.com/springfox/springfox/issues/1176 Zasadniczo można ciągnąć w dół źródła i stworzyć cokolwiek modyfikacjami musi zrobić. Nie musisz tworzyć słoika WWW. po prostu skopiuj go do swoich zasobów i poproś aplikację o obsługę za pomocą procedur obsługi zasobów –

Odpowiedz

2

Jeśli zamierzasz spersonalizować swagger-ui, po prostu polecam dodanie prywatnej kopii swagger-ui do zasobów twojej aplikacji internetowej i zmodyfikowanie interfejsu użytkownika w zależności od twoich potrzeb.

Swagger-ui w pakiecie z springfox to opcjonalnie.

+0

, jak rozumieć "całkiem sporo"? co ze zmianą logotypu, hasło do zalogowania się, aby wyświetlić i zobaczyć inną treść na podstawie innego loginu? – actan

+1

To całkiem sporo :) –

0

Tak, pociągnij ui Swagger do projektu i wykonaj czynności opisane tutaj: https://github.com/springfox/springfox/issues/1176

Następnie edytować i zmieniać index.html gdzie wskazuje na petstore do swojej końcowego. (tj. "http://localhost:8080/MyProjectName/v2/api-docs");

$(function() { 
    var url = window.location.search.match(/url=([^&]+)/); 
    if (url && url.length > 1) { 
    url = decodeURIComponent(url[1]); 
    } else { 
    url = "http://petstore.swagger.io/v2/swagger.json"; 
1
  1. Pull Swagger UI z github.

    https://github.com/swagger-api/swagger-ui

  2. Kopiowanie & pasta dist katalog Swagger ui do zasobów katalogów

  3. Zastąp kod z poniższej Swagger config

    zastąpić

    registry.addResourceHandler("swagger-ui.html").addResourceLocations("classpath:/META-INF/resources/"); 
    

    z

    registry.addResourceHandler("**").addResourceLocations("classpath:/dist/"); 
    
  4. zmienić ścieżkę Dokumentacja API w index.html do ścieżki

    Wymień

    http://petstore.swagger.io/v2/swagger.json 
    

    Z

    http://localhost:8080/your_app/v2/api-docs 
    
  5. Użyj poniższego wzoru do url zobacz stronę ui

    http://localhost:8080/your_app/index.html

Powiązane problemy