When using light-codegen with OpenAPI 3.0 specification to generate light-rest-4j project,
you can add examples into the specification definition so that the generated project will
have handlers to return corresponding examples in response.
This is very useful for developers who are working on the service to verify that the service
is working right off the generator.
Also, it is beneficial for client side developers as they can get a running service right
off the specification to start their client side application development. Later on, they
can switch to the real implementation to do the integration test.
This kind of support ensures that client side development and server side development can
be running in parallel to speed up the overall delivery process. It is particularly useful
with microservices architecture as each team only focus on their service but use
other teams mock services to start the development.
To leverage this feature in OpenAPI 3.0 specification, you need to define an example in
each endpoint or operation. There are two different formats to support single example or