Configurazione di Swagger con Play/Java-framework-2.5

Question

Sto provando a configurare Swagger con il mio progetto Play-2.5.

Ho seguito questo tutorial e ha funzionato, ma solo per la versione precedente di Play e non funziona con Play-2.5. Poiché il progetto è migrato in Play-2.5, abbiamo dovuto rimuovere la configurazione swagger.

In primo luogo, il problema sembrava essere il controller statico rispetto al controller non statico in Play-2.5, ma alla fine mi sono dimostrato sbagliato. Sto affrontando questo errore

 type ApiHelpController is not a member of package controllers 
     GET   /api-docs    controllers.ApiHelpController.getResources 

Se qualcuno sa link per la configurazione Swagger con Play-2.5 per Java , si prega di guida.

PS: ci sono tutorial disponibili per Scala non per java.

Answer 1

Ho utilizzato solo lo Play-Swagger project from Zalando. C'è molta documentazione e il repository è aggiornato.

Se si desidera un avvio rapido è possibile dare un'occhiata al loro Activator Template - basta eseguirlo e si otterrà la documentazione generata Swagger (l'interfaccia utente Swagger è già inclusa). Da lì puoi iniziare a modificarlo (cerca il file conf/echo.yaml).

Answer 2

Il problema è che com.wordnik swagger-play2 (Quello che il tuo tutorial sta usando come libreria) si interrompe con Play 2.4 e versioni successive. Puoi provare this che usa uno diverso (io.swagger). Ho usato questo e funziona bene con 2.4. Ma si spezza anche con 2.5.

Answer 3

Prova questa repo:

https://github.com/CreditCardsCom/swagger-play

Ho creato questo come una soluzione temporanea finché non avremo il supporto for Gioca 2.5 nel repository ufficiale di spavalderia-play.