As explained in the Primer for back-end development the RAML Module Builder (RMB) framework can be utilised to ease development. One of its abilities is to generate Java classes from the RAML and Schema.
The RMB README section entitled Design the RAML files provides some RMB-specific guidance, as well as general assistance.
The mod-graphql Autogeneration of GraphQL schemas and resolvers document explains the RAML and Schema files.
The RMB README has an example and commentary.
As explained there, use the shared git submodule at
ramls/raml-util and follow the ideal directory structure.
When using RMB, it is important to further emphasise some items. Pay attention to the “$ref” used to reference and link JSON Schema, and to the declaration in the RAML files of all schema that are used. At this stage RAML files must have at least two endpoints.
Use raml-cop to assess RAML, schema, and examples. A script is provided, to find files and run it. It can also be integrated with editors.
Reference API documentation is automatically generated by the continuous integration, for modules that are managed with the FOLIO CI.