[Roadmap] Server generator

[joelwurtz]

Add a server generator which should generate

• An interface / abstract class extendable for each endpoint
• A bridge for each endpoint implementing PSR15 handler interface https://www.php-fig.org/psr/psr-15/ which transform request to object / parameters needed for the endpoint, and object returned by the endpoint into a ResponseInterface
• A router implementing PSR15 middleware which redirect to the correct endpoint bridge

[joelwurtz]

Optionally it may generate an async version using https://github.com/amphp/aerys

[MichaelKubovic]

Hey, I'd like to contribute to this feature. I could start with the controller interfaces. Although I like the flexibility of separate interface for each endpoint, I would like to be able to optionally group them by resource. Ideally I'd like to have UserControllerInterface, CarControllerInterface, etc. Tags could be used for this purpose, what do you think?

[fbourigault]

In my company, we started a new project which is OpenAPI first. We first wrote the schema which defines the contract and now, we are building the server. We currently use jane-openapi to build models and normalizer for the server.

Sadly, jane-openapi also generate the client and the endpoints.

Then for server generation, I would like to use some ADR generator with actions which use Symfony HttpFoundation Request/Response and would use Symfony messenger to send messages into the application and implement CQRS pattern.

Someone would probably use PSR7 instead of HttpFoundation and juste generate some XML routes which map paths to hand written controllers.

As a first step in the direction of a server generator, I would like to allow generators to be configured.

This would solve the generate only the models and the normalizers from an openapi file but neither the client nor the endpoints.
This would also allow to generate a Symfony HTTP Client instead of the PSR-7 one.
This would allow server generation or just a routing configuration or some test data from samples.

This configuration could also allow the use of custom generators to allow users to generate anything they have in mind.

What do you think?

[Korbeil]

First of all, glad you take jane to power up your project 🚀

In case server feature comes, there will be a client mode with what we have today, and a server mode which won't generate stuff you don't want but only server-side related stuff 😉

I totally agree with Request/Response based on Symfony HttpFoundation they're both powerfull and fit to what we do need.
About Symfony Messenger I'll prefer that we have adapters that does connect to whatever you want: Messenger indeed, events or event Controller. Idea is to let the user choose what he prefer, for example: I never used Messenger and I would prefer a Controller adapter approach.

About Symfony HTTP Client or PSR-7, I'll prefer PSR-7 approach since HTTP Client does support PSR-7 and I prefer to be compatible with most of possible implementations instead of just one.