Client library generation

[dbalabka]

In the context of large systems, it is beneficial to have clients libraries to communicate between services. Such clients libraries should provide possible entities models which might be returned by the service. Unfortunately, sometimes it solved by reimplementing already existing entities which add additional maintenance overhead. It is possible to generate such clients with models for different programming languages because almost always we are facing with polyglot systems. To make this working API definition should be declared and shared using language-independent format like JSON. Open API (Swagger) is a JSON (or YAML) based schema definition format and has a support of Swagger Codegen tool for client generation libraries.

We can define a goal to create a library that can generate an Open API schema definition using existing JMS Serialization metadata to produce a fully working client. It might be integrated into a bundle or be a completely separate tool.