stoicflame / enunciate

Build-time enhancement tool for Java-based Web services projects
http://enunciate.webcohesion.com/
Other
480 stars 200 forks source link

feat: enables 'summary' tag with the help of '@ApiOperation' annotation #1170

Closed volkanto closed 1 year ago

volkanto commented 1 year ago

The below code shows how the summary tag is generated

[#if method.summary?? && method.summary?length > 0]
"summary" : "${method.summary}",
[/#if]

as by default, MethodImpl is returning null for the summary, we can not override this with anything. As per suggestion here, we have to use swagger's ApiOperation annotation, but by default, it is not supported as well, so this PR is going to fix the issue and we are going to add summary tag into generated swagger.json file.