OpenAPI Definition Files for REST API

[lorthirk]

This PR add the OpenAPI definition files to Kapua.

Related Issue
No related issues

Description of the solution adopted
With this PR Swagger definition files will no longer automatically generated at runtime by inspecting JAX-RS annotations; standard OpenAPI 3.0 definitions have been written instead, that matches the current interface of the REST API.

Any side note on the changes made
As a result, Swagger annotations have also been removed from the code base. Again, the swagger.json file will no longer be automatically generated at runtime. The internal Swagger UI now points to the new file.

[codecov]

Codecov Report

Merging #2795 into develop will decrease coverage by 0.01%.
The diff coverage is n/a.

@@              Coverage Diff              @@
##             develop    #2795      +/-   ##
=============================================
- Coverage      57.46%   57.44%   -0.02%     
+ Complexity      3395     3069     -326     
=============================================
  Files           1074     1074              
  Lines          30505    30505              
  Branches        2436     2436              
=============================================
- Hits           17531    17525       -6     
- Misses         11804    11809       +5     
- Partials        1170     1171       +1

Impacted Files	Coverage Δ	Complexity Δ
.../notification/ManagementOperationNotification.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...kapua/service/authorization/access/AccessRole.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...pua/service/device/registry/event/DeviceEvent.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...apua/service/certificate/info/CertificateInfo.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...n/java/org/eclipse/kapua/message/KapuaPayload.java	100% <ø> (ø)	0 <0> (ø)	⬇️
.../eclipse/kapua/service/device/registry/Device.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...apua/service/authentication/token/AccessToken.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...kapua/service/authorization/access/AccessInfo.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...e/device/registry/connection/DeviceConnection.java	0% <ø> (ø)	0 <0> (ø)	⬇️
...service/authorization/access/AccessPermission.java	0% <ø> (ø)	0 <0> (ø)	⬇️
... and 7 more

---

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 344daa0...9653ac4. Read the comment docs.