GraphQL Schema

[jparise]

I think we should supporting GraphQL’s schema representation in Plank. Four big reasons:

1. GraphQL provides richer type support (enums, unions, interfaces).
2. GraphQL supports documentation elements that could be included in the generated code.
3. GraphQL directives provide a mechanism for marking fields as @deprecated, etc.
4. It allows for an easy transition from static schema files to “live” introspected schema queries.

[rahul-malik]

This has been planned as the path forward for a while and will require developing a proposal detailing how we map our existing JSON Schema type system to GraphQL equivalents. For most types this will be a simple conversion but things like Int or String enums may require a bit more work.

[rahul-malik]

I'll start working on a draft after Java support has been merged