Generate Swagger using springdoc-openapi OAS 3.0

Link to ADR(Architecture Decision Record) : Swagger using springdoc-openapi

OpenAPI 3.0 related changes

• upgraded to latest springdoc openapi latest version 1.6.14
• used @OpenAPIDefinition annotation to populate OpenAPI Object fields [info, tags, servers, security]
• Documented DatasetDmsApi, DatasetRegistryApi, & Info API with OpenAPI 3.0 Annotations
• Added the standard HTTP Response(4xx, 5x****x) for API Responses
• Custom Path for
  • Swagger UI: https://host/context-path/swagger (will redirect to https://host/context-path/swagger-ui/index.html)
  • api-docs (JSON) : https://host/context-path/api-docs
  • api-docs (YAML) : https://host/context-path/api-docs.yaml

Other Changes

• Configurable descriptions managed in swagger.properties
• added Integration Test cases for Swagger-UI, api-docs endpoints
• Deprecated API operations in documentation and Associated Issue : #46 (closed)
  1. /getStorageInstructions
  2. /getRetrievalInstructions GET
  3. /getRetrievalInstructions POST
• Deleted HomeController

References

• https://springdoc.org/faq.html#_can_i_use_spring_property_with_swagger_annotations
• https://springdoc.org/migrating-from-springfox.html