search

sdaschner / jaxrs-analyzer

Creates REST documentation for JAX-RS projects
Apache License 2.0
319 stars 101 forks source link

Support an explicit type hint in method responses #121

Open abstratt opened 6 years ago

abstratt commented 6 years ago

Allow JAX-RS interfaces or classes to explicitly declare the type of the response object.

Today, jaxrs-analyze either requries the actual JAXB type to be returned, or if a Response object is returned, requires the JAX-RS class to be concrete (as it tries to guess the type of result produced via bytecode analysis), which breaks with interfaces or abstract classes.

Suggest jaxrs-analyzer allows the user to specify the return type explicitly, as Enunciate allows via the TypeHint annotation.