Add SpringDoc

[Bolo89]

Hello,

• Add spring doc : fix Spring Boot Web: add swagger with springdoc #219

Example :

{
  "folder": "/home/bolo/Projects/my-project-test",
  "generator-jhipster": {
    "projectName": "Beer Project",
    "baseName": "beer",
    "prettierDefaultIndent": 2,
    "packageName": "tech.jhipster.beer"
    "apiTitle": "My API",
    "apiDescription": "My API description",
    "apiLicenseName": "Custom 5.0",
    "apiLicenseUrl": "http://license-url.fr",
    "apiExternalDocDescription": "External API doc description",
    "apiExternalDocUrl": "http://external-api-doc.fr"
  }
}

[CLAassistant]

All committers have signed the CLA.

[pascalgrimaud]

Huge work @Bolo89 !
Thanks so much, as I'll need this very soon.
I'll do my best to review it today or tomorrow :-)

[codecov]

Codecov Report

Merging #538 (a62b125) into main (9c5b3bc) will not change coverage.
The diff coverage is 100.00%.

@@             Coverage Diff             @@
##                main      #538   +/-   ##
===========================================
  Coverage     100.00%   100.00%           
- Complexity       846       863   +17     
===========================================
  Files            155       160    +5     
  Lines           2582      2643   +61     
  Branches          57        57           
===========================================
+ Hits            2582      2643   +61     

Impacted Files	Coverage Δ
...ngdoc/application/SpringDocApplicationService.java	100.00% <100.00%> (ø)
...ver/springboot/mvc/springdoc/domain/SpringDoc.java	100.00% <100.00%> (ø)
...t/mvc/springdoc/domain/SpringDocDomainService.java	100.00% <100.00%> (ø)
...rastructure/config/SpringDocBeanConfiguration.java	100.00% <100.00%> (ø)
...infrastructure/primary/rest/SpringDocResource.java	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 9c5b3bc...a62b125. Read the comment docs.

[pascalgrimaud]

Not related to this PR, but we have 2 possible uses cases about Security

1st use case:

• add springdoc
• add Security JWT (or OAuth2 later)
• should do something to springdoc code <---

2nd use case:

• add Security
• add springdoc, we could generate immediatly the security part

Let's do this in another PR, I have some ideas, using Spring Events

Related to this answer https://stackoverflow.com/questions/59357205/springdoc-openapi-apply-default-global-securityscheme-possible , the security part to add could be something like:

.components(
        new Components()
          .addSecuritySchemes(
            "bearer-jwt",
            new SecurityScheme()
              .type(SecurityScheme.Type.HTTP)
              .scheme("Bearer")
              .bearerFormat("JWT")
              .in(SecurityScheme.In.HEADER)
              .name("bearerAuth")
          )
      )
      .addSecurityItem(new SecurityRequirement().addList("bearer-jwt", Arrays.asList("read", "write")))

[Bolo89]

Hello,
Bounty claimed at https://opencollective.com/generator-jhipster/expenses/61784

[pascalgrimaud]

@Bolo89 : approved! Thanks so much for your 1st contribution