* BAEL-5326 - Documenting Enum in swagger using swagger maven plugin * BAEL-5326 - Documenting Enum in swagger using swagger maven plugin Changes: HireControllerTest -> HireControllerUnitTest hireEmployee_RoleEngineer_ReturnsRoleString -> givenRoleEngineer_whenHireEmployee_thenReturnsRoleInString * Moved to module: spring-boot-swagger
57 lines
1.4 KiB
JSON
57 lines
1.4 KiB
JSON
{
|
|
"swagger" : "2.0",
|
|
"info" : {
|
|
"description" : "This is a Baeldung Document Enum Sample Code",
|
|
"version" : "v1",
|
|
"title" : "Baeldung - Document Enum",
|
|
"contact" : {
|
|
"name" : "Parikshit Murria",
|
|
"email" : "pmurria@baeldung.com"
|
|
},
|
|
"license" : {
|
|
"name" : "Apache 2.0",
|
|
"url" : "https://www.apache.org/licenses/LICENSE-2.0.html"
|
|
}
|
|
},
|
|
"host" : "baeldung.com",
|
|
"basePath" : "/api",
|
|
"schemes" : [ "http", "https" ],
|
|
"paths" : {
|
|
"/hire" : {
|
|
"post" : {
|
|
"summary" : "This method is used to hire employee with a specific role",
|
|
"description" : "",
|
|
"operationId" : "hireEmployee",
|
|
"produces" : [ "application/json" ],
|
|
"parameters" : [ {
|
|
"in" : "body",
|
|
"name" : "body",
|
|
"description" : "role",
|
|
"required" : true,
|
|
"schema" : {
|
|
"$ref" : "#/definitions/Employee"
|
|
}
|
|
} ],
|
|
"responses" : {
|
|
"200" : {
|
|
"description" : "successful operation",
|
|
"schema" : {
|
|
"type" : "string"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"definitions" : {
|
|
"Employee" : {
|
|
"type" : "object",
|
|
"properties" : {
|
|
"role" : {
|
|
"type" : "string",
|
|
"enum" : [ "Engineer", "Clerk", "Driver", "Janitor" ]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} |