Hello,
I have a general question on javadoc and jaxb / xjc: I have generated classes using xjc. Unfortunately not all classes fulfill the javadoc coding standards. In the class ObjectFactory there is for example the following generated method:
/**
* Create an instance of MyObject
*
* @throws JAXBException if an error occurs
*/
public com.test.MyObject createMyObject()
throws javax.xml.bind.JAXBException
{
return new com.test.impl.MyObjectImpl();
}
to be valid concerning javadoc I would rather expect the following (@return Element and Exception qualified in the @throws Element):
/**
* Create an instance of MyObject
*
* @return possible object is
* {_at_link com.test.MyObject}
* @throws javax.xml.bind.JAXBException if an error occurs
*/
public com.test.MyObject createMyObject()
throws javax.xml.bind.JAXBException
{
return new com.test.impl.MyObjectImpl();
}
Do you have any suggestions for me?
Best regards,
Matthias