GraphQL support

[glutengo]

Overview of the issue

Picking up from jhipster/generator-jhipster#4251 (comment)

I have decided to work on a GraphQL integration for nhipster in my master's thesis. I will start to work on this soon and I would like to hear the opinion of the developer team regarding the best approach on how to integrate my work in the jhipster ecosystem.

My initial idea was to create an own blueprint. This new blueprint would have generator-jhipster-nodejs as a dependency and add the new graphQL functionality where needed (using inheritance where possible). Would this be the right way to go? What other options are worth looking at? A PR in this project? A module rather than a blueprint?

Looking forward to hearing your thoughts!

Related issues

jhipster/generator-jhipster#4251

• Checking this box is mandatory (this is just to show you read everything)

Hi @glutengo , it's wonderful!
My opinion is to fork this blueprint and integrate the GraphQL support (merging with a PR).
The reason is that we already prompt a question for the database type, and you can add your graphql option.
Besides, NHipster uses TypeORM that easy could add graphQL support and is very similar to Hibernate (used in standard JHipster generator).
Last, but not the least, typeORM is already integrated in NestJS, that is the core nodejs backend framework of NHipster, so for nodejs backend implementation is advisable to use this blueprint, while for the client part you can use different templates to add in jhipster standard generator, or in NHipster blueprint (NHipster inherits the jhipster client templates and uses its own nodejs backend that works with its).

Here the configuration and the entity TypeORM main files of generated example app:

• https://github.com/jhipster/jhipster-sample-app-nodejs/blob/main/server/src/orm.config.ts
• https://github.com/jhipster/jhipster-sample-app-nodejs/blob/main/server/src/domain/user.entity.ts

Here the blueprint prompt point of database choice:

• https://github.com/jhipster/generator-jhipster-nodejs/blob/0f03a0f809ff339f81839cf1f86c44ce000346ed/generators/server/prompts.js

However, I advice to wait the next NHipster 2.0.0 release (a beta will be published in the next days after #211 validation) and fork that main branch.

For any questions feel free to contact me, I'm the full NHipster contributor (the main founder and stream lead), so there will be wonderful to collaborate together!

[glutengo]

Hi @amanganiello90 thank you so much for your quick reply and thank you for all the pointers!

I have worked with NestJS and TypeORM in the past and the docs have their own graphQL section: https://docs.nestjs.com/graphql/quick-start

As far as I understand, using GraphQL would not be an alternative to using a certain database (type) like mysql or mongodb but it would rather be an alternative/addition to using REST, right?
So there should rather be an additional prompt which asks if the user wants to use graphQL instead of/in addition to REST. I was also thinking about a custom annotation on the concerned entity in JDL which is evaluated when code is generated based on the JDL schema.

Also thank you for offering your support, I will definitely get in touch again.

Yes, the link section of NestJS that I have added in my comment is the same yours :)

However, when you customize the entity model template, you can define your service called by the controller REST api, so in my opinion when the user chooces the graphQL database automatically He will use your custom services and models (and you could add new questions after graphQL choice if there are other customization for the user).

For the JDL, if you need to specify an annotation to generate entity and services customization for GraphQL, you could use the jhipster standard databaseType. For example in NHipster I defined the sqlite value in devDatabaseType: https://github.com/jhipster/generator-jhipster-nodejs/blob/main/test-integration/samples/microservice-oauth2-jdl/.yo-rc.json

You could perform the same thing in JDL, and evaluate in the blueprint the different generation according the variable value.

Finally, you could give a look to the graphQL official jhipster module.

@glutengo yes you are right, maybe it's more correct to add another question to chooce graphQL support in server subgenerator prompt because it enables api that you can use with all database types (sqlite, sql and so on).

However you will have customized templates for entity model, service and controller according your choice. These templates will be in entity-server subgenerator, called automatically by import-jdl command or entity command.

[glutengo]

@amanganiello90 I agree and thanks for pointing out the existing jhipster module, that seems to be brand new and I had not seen that yet!

I was already typing and trying to make my case for not using the databaseType field but your latest comment shows we are on the same page now :)

@glutengo you rock !!! 💯 ;)