Generating xml schema documentation elements from JAXB annotated classes
When you're in the business of creating Java Web Services today, be it JAX-WS or JAX-RS, one of the difficult things to get right is actually documenting the entities from a API developer point of view, especially in the scenario where your model is the code. The main problem comes to the fact that a JAXB annotated model doesn't map anything to the generated schema contracts (be it WSDL or WADL+XSD) and classes. This is understandable as Javadocs don't exist at runtime and there is no specific JAXB annotation that maps to the xs:annotation, xs:documentation and xs:appinfo schema elements. Various tools like enunciate and all provide some support to to compile time generation but from my point of view the generated wadl + schema (my main scenario) is not the same quality as is the runtime generated ones. Can this be improved? Some guys at the The Distributed Systems Group (DSG) of the Information Systems Institute at the Technical University of Vienna certainly thought...