More properties to DTO fields

[yeefan]

It seems that as of version 1.2.5, DTO_FIELD_INFO only has "description" and "pattern". Is it possible to support additional properties for DTO fields such as the following?

• Example
• Required
• Default value

Thanks!

[lganzzzo]

Hey @yeefan ,

• To add examples for an endpoint - see the description in this PR - https://github.com/oatpp/oatpp-swagger/pull/36
• Default values - are auto documented based on the default values set in the DTO

  class MyDto {
   ...
   DTO_FIELD(String, myField) = "default value"; // <---the default value will be documented
  };

The Required property is a good point. We should think about how to add it

[ghost]

Not to increase scope too much, but adding a minimum/maximum (with inclusive/exclusive boundary) for numerical values would also be useful. Some other properties at https://swagger.io/docs/specification/data-models/data-types/#range) may be good to consider.

[Inujel]

Adding the possibility to document minimum and maximum values would be really interesting.

The range is currently included in the OpenAPI json and is displayed by some tools. The default value does not look great:

[almejara]

Adding the possibility to document minimum and maximum values would be really interesting.

The range is currently included in the OpenAPI json and is displayed by some tools. The default value does not look great:

Hello. Finally it was done? If yes can I have an example.