ResponseHeader is not working as expected

[dilipkrish]

@dilipkrish An update:

I had to replace all dataType = ... with dataTypeClass = ... even for primitive types (so dataType = "double" had to be changed to dataTypeClass = Double.class.

The only issue I can now see is that the description attribute of @ResponseHeader annotation is not being picked up (it was before). So, if I have:

@ResponseHeader(name = HEADER_PAGE_SIZE, response = Integer.class, description = "Number of results per page")

The description no longer appears in the UI. There is no value attribute for this annotation so not sure how to resolve this other than implementing a custom extension. Any idea why this is no longer being picked up?

The real test will be deploying the specification doc to the Google Cloud Endpoint Service - its validation is quite strict.

Originally posted by @andrew-property-xyz in #3360 (comment)

[dilipkrish]

Fixed via #2684