Description

This adds the JSON API atomic operations to the OpenAPI document.

This also fixes issues with the generation of OpenAPI 3.1 documents and other issues.

• The specVersion and openapi values on OpenAPI are now appropriately set when configured to use OpenAPI 3.1
• The /info/version is a required property and is now set to an empty string if null.
• The /info/version is now not overridden if the annotation does not set the version.
• OpenAPI documents with a version other than the default will now generate a correct reference to its schema if the model is not versioned.

Motivation and Context

This makes the atomic operations feature more visible and easier to use.

There are 8 different operations that can be performed in atomic operations

• Creating Resources
• Updating Resources
• Deleting Resources
• Updating To-One Relationships
• Deleting To-One Relationships
• Creating To-Many Relationships
• Updating To-Many Relationships
• Deleting To-Many Relationships

The specific request bodies needed for each of the operations can be difficult to remember without examples so the examples and descriptions were added to make it easier.

How Has This Been Tested?

Added / changed the appropriate unit / integration tests.

Also tested that the generate OpenAPI document can be successfully processed by the openapi-generator-cli.

Screenshots (if appropriate):

License

I confirm that this contribution is made under an Apache 2.0 license and that I have the authority necessary to make this contribution on behalf of its copyright owner.