@DELETE
@Path("/{id}")
@Produces({MediaType.APPLICATION_JSON, "text/uri-list"})
@ApiOperation(
value = "Deletes a particular Feature resource.",
notes =
"Deletes a Feature of a given ID. The method is idempondent, that is, it can be used more than once without "
+ "triggering an exception/error. If the Feature does not exist, the method will return without errors. "
+ "Authentication and authorization requirements apply, so clients that are not authenticated with a "
+ "valid token or do not have sufficient priviledges will not be able to delete a Feature using this method.")
@ApiResponses(
value = {
@ApiResponse(code = 200, message = "Feature entry was deleted successfully."),
@ApiResponse(code = 401, message = "You are not authorized to delete this resource"),
@ApiResponse(
code = 403,
message = "This request is forbidden (e.g., no authentication token is provided)"),
@ApiResponse(code = 500, message = "Internal server error - this request cannot be served.")
})
public Response deleteFeature(
@ApiParam("Clients need to authenticate in order to create resources on the server")
@HeaderParam("subjectid")
String subjectId,
@ApiParam(value = "ID of the Model.", required = true) @PathParam("id") String id) {
featureHandler.remove(new Feature(id));
return Response.ok().build();
}
