CDS add Swagger annotations for Model Type API

Issue-ID: CCSDK-3014
Change-Id: I469151beef8ebf63b3a24ca4ce9a047c0b80850a
Signed-off-by: Piotr Stanior <piotr.stanior@t-mobile.pl>

2 files changed, 391 insertions, 0 deletions

diff --git a/docs/api-reference/media/bp-processor.postman_collection.json b/docs/api-reference/media/bp-processor.postman_collection.json
index 2aabe1393..b87415db9 100644
--- a/docs/api-reference/media/bp-processor.postman_collection.json
+++ b/docs/api-reference/media/bp-processor.postman_collection.json
@@ -3659,6 +3659,239 @@
 			"protocolProfileBehavior": {}
 		},
 		{
+			"name": "Model Type Catalog",
+			"item": [
+				{
+					"name": "Save a model type",
+					"request": {
+						"auth": {
+							"type": "basic",
+							"basic": [
+								{
+									"key": "username",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "password",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "showPassword",
+									"value": false,
+									"type": "boolean"
+								}
+							]
+						},
+						"method": "POST",
+						"header": [],
+						"body": {
+							"mode": "raw",
+							"raw": "{\r\n  \"modelName\": \"test\",\r\n  \"derivedFrom\": \"test\",\r\n  \"definitionType\": \"data_type\",\r\n  \"definition\": {},\r\n  \"description\": \"Some test\",\r\n  \"version\": \"1.0\",\r\n  \"tags\": \"test\",\r\n  \"updatedBy\": \"test\"\r\n}",
+							"options": {
+								"raw": {
+									"language": "json"
+								}
+							}
+						},
+						"url": {
+							"raw": "http://{{host}}:{{port}}/api/v1/model-type/",
+							"protocol": "http",
+							"host": [
+								"{{host}}"
+							],
+							"port": "{{port}}",
+							"path": [
+								"api",
+								"v1",
+								"model-type",
+								""
+							]
+						},
+						"description": "Save a model type by model type definition provided."
+					},
+					"response": []
+				},
+				{
+					"name": "Retrieve a list of model types",
+					"request": {
+						"auth": {
+							"type": "basic",
+							"basic": [
+								{
+									"key": "username",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "password",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "showPassword",
+									"value": false,
+									"type": "boolean"
+								}
+							]
+						},
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "http://{{host}}:{{port}}/api/v1/model-type/by-definition/data_type",
+							"protocol": "http",
+							"host": [
+								"{{host}}"
+							],
+							"port": "{{port}}",
+							"path": [
+								"api",
+								"v1",
+								"model-type",
+								"by-definition",
+								"data_type"
+							]
+						},
+						"description": "Retrieve a list of model types by definition type provided."
+					},
+					"response": []
+				},
+				{
+					"name": "Retrieve a list of model types",
+					"request": {
+						"auth": {
+							"type": "basic",
+							"basic": [
+								{
+									"key": "username",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "password",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "showPassword",
+									"value": false,
+									"type": "boolean"
+								}
+							]
+						},
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "http://{{host}}:{{port}}/api/v1/model-type/search/test",
+							"protocol": "http",
+							"host": [
+								"{{host}}"
+							],
+							"port": "{{port}}",
+							"path": [
+								"api",
+								"v1",
+								"model-type",
+								"search",
+								"test"
+							]
+						},
+						"description": "Retrieve a list of model types by tags provided."
+					},
+					"response": []
+				},
+				{
+					"name": "Retrieve a model type",
+					"request": {
+						"auth": {
+							"type": "basic",
+							"basic": [
+								{
+									"key": "username",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "password",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "showPassword",
+									"value": false,
+									"type": "boolean"
+								}
+							]
+						},
+						"method": "GET",
+						"header": [],
+						"url": {
+							"raw": "http://{{host}}:{{port}}/api/v1/model-type/test",
+							"protocol": "http",
+							"host": [
+								"{{host}}"
+							],
+							"port": "{{port}}",
+							"path": [
+								"api",
+								"v1",
+								"model-type",
+								"test"
+							]
+						},
+						"description": "Retrieve a model type by name provided."
+					},
+					"response": []
+				},
+				{
+					"name": "Remove a model type",
+					"request": {
+						"auth": {
+							"type": "basic",
+							"basic": [
+								{
+									"key": "username",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "password",
+									"value": "ccsdkapps",
+									"type": "string"
+								},
+								{
+									"key": "showPassword",
+									"value": false,
+									"type": "boolean"
+								}
+							]
+						},
+						"method": "DELETE",
+						"header": [],
+						"url": {
+							"raw": "http://{{host}}:{{port}}/api/v1/model-type/test",
+							"protocol": "http",
+							"host": [
+								"{{host}}"
+							],
+							"port": "{{port}}",
+							"path": [
+								"api",
+								"v1",
+								"model-type",
+								"test"
+							]
+						},
+						"description": "Remove a model type by name provided."
+					},
+					"response": []
+				}
+			],
+			"description": "Manages data types in CDS",
+			"protocolProfileBehavior": {}
+		},
+		{
 			"name": "List all endpoints",
 			"request": {
 				"auth": {
diff --git a/docs/api-reference/media/cds-bp-processor-api-swagger.json b/docs/api-reference/media/cds-bp-processor-api-swagger.json
index c7f24262e..9053672e5 100644
--- a/docs/api-reference/media/cds-bp-processor-api-swagger.json
+++ b/docs/api-reference/media/cds-bp-processor-api-swagger.json
@@ -20,6 +20,9 @@
     "name" : "Blueprint Model Catalog",

     "description" : "Manages all blueprint models which are available in CDS"

   }, {

+    "name" : "Model Type Catalog",

+    "description" : "Manages data types in CDS"

+  }, {

     "name" : "Resource configuration",

     "description" : "Interaction with stored configurations"

   }, {

@@ -962,6 +965,127 @@
         }

       }

     },

+    "/api/v1/model-type/" : {

+      "post" : {

+        "tags" : [ "Model Type Catalog" ],

+        "summary" : "Save a model type",

+        "description" : "Save a model type by model type definition provided.",

+        "operationId" : "ModelTypeController_saveModelType_POST.org.onap.ccsdk.cds.blueprintsprocessor.designer.api",

+        "consumes" : [ "application/json" ],

+        "produces" : [ "application/json" ],

+        "parameters" : [ {

+          "in" : "body",

+          "name" : "body",

+          "required" : false,

+          "schema" : {

+            "$ref" : "#/definitions/ModelType"

+          }

+        } ],

+        "responses" : {

+          "200" : {

+            "description" : "successful operation",

+            "schema" : {

+              "$ref" : "#/definitions/ModelType"

+            }

+          }

+        }

+      }

+    },

+    "/api/v1/model-type/by-definition/{definitionType}" : {

+      "get" : {

+        "tags" : [ "Model Type Catalog" ],

+        "summary" : "Retrieve a list of model types",

+        "description" : "Retrieve a list of model types by definition type provided.",

+        "operationId" : "ModelTypeController_getModelTypeByDefinitionType_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api",

+        "produces" : [ "application/json" ],

+        "parameters" : [ {

+          "name" : "definitionType",

+          "in" : "path",

+          "required" : true,

+          "type" : "string"

+        } ],

+        "responses" : {

+          "200" : {

+            "description" : "successful operation",

+            "schema" : {

+              "type" : "array",

+              "items" : {

+                "$ref" : "#/definitions/ModelType"

+              }

+            }

+          }

+        }

+      }

+    },

+    "/api/v1/model-type/search/{tags}" : {

+      "get" : {

+        "tags" : [ "Model Type Catalog" ],

+        "summary" : "Retrieve a list of model types",

+        "description" : "Retrieve a list of model types by tags provided.",

+        "operationId" : "ModelTypeController_searchModelTypes_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api",

+        "produces" : [ "application/json" ],

+        "parameters" : [ {

+          "name" : "tags",

+          "in" : "path",

+          "required" : true,

+          "type" : "string"

+        } ],

+        "responses" : {

+          "200" : {

+            "description" : "successful operation",

+            "schema" : {

+              "type" : "array",

+              "items" : {

+                "$ref" : "#/definitions/ModelType"

+              }

+            }

+          }

+        }

+      }

+    },

+    "/api/v1/model-type/{name}" : {

+      "get" : {

+        "tags" : [ "Model Type Catalog" ],

+        "summary" : "Retrieve a model type",

+        "description" : "Retrieve a model type by name provided.",

+        "operationId" : "ModelTypeController_getModelTypeByName_GET.org.onap.ccsdk.cds.blueprintsprocessor.designer.api",

+        "produces" : [ "application/json" ],

+        "parameters" : [ {

+          "name" : "name",

+          "in" : "path",

+          "required" : true,

+          "type" : "string"

+        } ],

+        "responses" : {

+          "200" : {

+            "description" : "successful operation",

+            "schema" : {

+              "$ref" : "#/definitions/ModelType"

+            }

+          }

+        }

+      },

+      "delete" : {

+        "tags" : [ "Model Type Catalog" ],

+        "summary" : "Remove a model type",

+        "description" : "Remove a model type by name provided.",

+        "operationId" : "ModelTypeController_deleteModelTypeByName_DELETE.org.onap.ccsdk.cds.blueprintsprocessor.designer.api",

+        "parameters" : [ {

+          "name" : "name",

+          "in" : "path",

+          "required" : true,

+          "type" : "string"

+        } ],

+        "responses" : {

+          "200" : {

+            "description" : "successful operation",

+            "schema" : {

+              "$ref" : "#/definitions/ModelType"

+            }

+          }

+        }

+      }

+    },

     "/api/v1/resources" : {

       "get" : {

         "tags" : [ "Resources" ],

@@ -1532,6 +1656,40 @@
         }

       }

     },

+    "ModelType" : {

+      "type" : "object",

+      "required" : [ "definition", "definitionType", "derivedFrom", "description", "modelName", "tags", "updatedBy", "version" ],

+      "properties" : {

+        "modelName" : {

+          "type" : "string"

+        },

+        "derivedFrom" : {

+          "type" : "string"

+        },

+        "definitionType" : {

+          "type" : "string"

+        },

+        "definition" : {

+          "$ref" : "#/definitions/JsonNode"

+        },

+        "description" : {

+          "type" : "string"

+        },

+        "version" : {

+          "type" : "string"

+        },

+        "tags" : {

+          "type" : "string"

+        },

+        "creationDate" : {

+          "type" : "string",

+          "format" : "date-time"

+        },

+        "updatedBy" : {

+          "type" : "string"

+        }

+      }

+    },

     "NodeFilterDefinition" : {

       "type" : "object",

       "properties" : {