Merged
requested to merge github/fork/matthesrieke/hotfix/unescaped-requestbody-description into master
Created by: matthesrieke
PR checklist
-
Read the contribution guidelines. -
Ran the shell script under ./bin/to update Petstore sample so that CIs can verify the change. (For instance, only need to run./bin/{LANG}-petstore.shand./bin/security/{LANG}-petstore.shif updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates). Windows batch files can be found in.\bin\windows\. -
Filed the PR against the correct branch: master,3.3.x,4.0.x. Default:master. -
Copied the technical committee to review the pull request if your PR is targeting a particular programming language.
Description of the PR
This is a very small fix and re-uses existing functionality. It solves a glitch in OpenAPI 3 generation where the description of a requestBody of a POST operation was not escaped and caused code generators to have line breaks where no line breaks are allowed. Example:
post:
description: |
Creates a new Job in the
repository
operationId: createJob
requestBody:
description: |
Job to add to the
repository
was resulting in (lines 9-11):
@ApiOperation(value = "", nickname = "createJob", notes = "Creates a new Job in the repository ", response = Job.class, tags={ })
@ApiResponses(value = {
@ApiResponse(code = 201, message = "job response ", response = Job.class),
@ApiResponse(code = 500, message = "unexpected error ", response = Error.class) })
@RequestMapping(value = "/jobs",
produces = { "application/json" },
consumes = { "application/json" },
method = RequestMethod.POST)
default ResponseEntity<Job> createJob(@ApiParam(value = "Job to add to the
repository
",required=true) @Valid @RequestBody Job job
) {
The fix is to re-use the existing escapeText method in DefaultCodegen.