Created by: cowclaw
When using composed schemas, null is generated as a default value, even if no default value is given. This bug is resides in AbstractJavaCodegen and is thus present in many generators extending the AbstractJavaCodegen.
Samples showing the buggy behavior already exist in bin/configs/java-native-openapi3.yaml and bin/configs/java-jersey2-8.yaml using modules/openapi-generator/src/test/resources/3_0/java/petstore-with-fake-endpoints-models-for-testing-with-http-signature.yaml. Below is an excerpt of this yaml, showing the definition of the composed schemas.
Drawing:
type: object
properties:
mainShape:
# A property whose value is a 'oneOf' type, and the type is referenced instead
# of being defined inline. The value cannot be null.
$ref: '#/components/schemas/Shape'
shapeOrNull:
# A property whose value is a 'oneOf' type, and the type is referenced instead
# of being defined inline. The value may be null because ShapeOrNull has 'null'
# type as a child schema of 'oneOf'.
$ref: '#/components/schemas/ShapeOrNull'
nullableShape:
# A property whose value is a 'oneOf' type, and the type is referenced instead
# of being defined inline. The value may be null because NullableShape has the
# 'nullable: true' attribute. For this specific scenario this is exactly the
# same thing as 'shapeOrNull'.
$ref: '#/components/schemas/NullableShape'
shapes:
type: array
items:
$ref: '#/components/schemas/Shape'
additionalProperties:
# Here the additional properties are specified using a referenced schema.
# This is just to validate the generated code works when using $ref
# under 'additionalProperties'.
$ref: '#/components/schemas/fruit'
Shape:
oneOf:
- $ref: '#/components/schemas/Triangle'
- $ref: '#/components/schemas/Quadrilateral'
discriminator:
propertyName: shapeType
ShapeOrNull:
description: The value may be a shape or the 'null' value.
This is introduced in OAS schema >= 3.1.
oneOf:
- type: 'null'
- $ref: '#/components/schemas/Triangle'
- $ref: '#/components/schemas/Quadrilateral'
discriminator:
propertyName: shapeType
NullableShape:
description: The value may be a shape or the 'null' value.
The 'nullable' attribute was introduced in OAS schema >= 3.0
and has been deprecated in OAS schema >= 3.1.
oneOf:
- $ref: '#/components/schemas/Triangle'
- $ref: '#/components/schemas/Quadrilateral'
discriminator:
propertyName: shapeType
nullable: true
As the commit shows, after re-creating the samples, the default null values are gone.
cc: @wing328 @bbdouglas @sreeshas @jfiala @lukoyanov @cbornet @jeff9finger @karismann @Zomzog @lwlee2608 @nmuesch
Thanks in advance!
PR checklist
-
Read the contribution guidelines. -
Pull Request title clearly describes the work in the pull request and Pull Request description provides details about how to validate the work. Missing information here may result in delayed response from the community. -
Run the following to build the project and update samples: Commit all changed files. This is important, as CI jobs will verify all generator outputs of your HEAD commit as it would merge with master. These must match the expectations made by your contribution. You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example./mvnw clean package ./bin/generate-samples.sh ./bin/utils/export_docs_generators.sh./bin/generate-samples.sh bin/configs/java*. For Windows users, please run the script in Git BASH. -
File the PR against the correct branch: master,5.1.x,6.0.x -
If your PR is targeting a particular programming language, @mention the technical committee members, so they are more likely to review the pull request.