Convertitori schema JSON Schema in GraphQL

Question

Esistono adattatori che convertono schemi JSON Schema (ad esempio da Swagger) in schemi GraphQL? C'è persino un articolo ufficiale su come avvolgere REST http://graphql.org/blog/rest-api-graphql-wrapper/, ma in genere REST già descritto e Swagger è il formato più popolare per questo. Non vorrei scriverlo da solo se esiste già un'implementazione.

Answer 1

Inoltre ho scritto una libreria, che consente di avvolgere l'API REST esistente se si utilizza Swagger.

https://github.com/yarax/swagger-to-graphql

Lo fa praticamente Swagger mappatura dello schema ai tipi GraphQL.

E c'è un articolo su questo approccio e la biblioteca https://medium.com/@raxwunter/moving-existing-api-from-rest-to-graphql-205bab22c184

Answer 2

In realtà ho messo un po 'di tempo per provarlo un paio di mesi fa. Puoi leggere il mio post in dettaglio i risultati qui: https://medium.com/apollo-stack/will-graphql-replace-rest-documentation-f1a55092ef9d#.m50im46o0

Dopo aver esaminato molti degli schemi Swagger disponibili online, penso che Swagger o linguaggi di descrizione API simili possano essere un buon punto di partenza per la definizione di uno schema GraphQL, ma spesso non contengono informazioni sufficienti per generare uno schema per conto proprio. Nello specifico, di solito non ci sono abbastanza dati sulle relazioni tra gli oggetti.

Se si desidera iniziare da una descrizione dello schema con formattazione JSON, è sufficiente scrivere un codice che scorre su tipi di dati diversi in Swagger e generare oggetti GraphQLObjectType. È possibile visualizzare un approccio semplice a questo nel repository di esempio per il post del blog I linkato sopra: https://github.com/apollostack/swapi-rest-graphql/blob/951e50ec29732c93e7aa0bc6880210fdd1816a2f/schema.js#L28

In pratica, si sta convertendo un formato di dati in un altro e quindi è necessario aggiungere alcune relazioni tra i dati (chiavi esterne, ID e così via) e aggiungere alcune query di root per creare un punto di ingresso. Nel caso di un'API REST, spesso ha senso che i singoli endpoint delle risorse fungano da campi di query radice.