[CAMEL-8900] Javadoc parser in API Component Framework misses first method with void return type in JDK7

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.14.3, 2.15.2
• Fix Version/s: 2.15.3, 2.14.4
• Component/s: camel-core
• Estimated Complexity: Unknown
• Assignee: Dhiraj Sureshkumar Bokde
• Reporter: Dhiraj Sureshkumar Bokde
• Created: 24/Jun/15 23:15
• Updated: 25/Jun/15 03:48
• Resolved: 25/Jun/15 03:48

Description

When using JDK 7 to generate Javadoc, the Javadoc parser based on javax.swing.text.html.parser.Parser fails to extract the first method if it has a void return type. For some reason the combination of the Javadoc generated by JDK7 and its Parser class gets the elements in the wrong order, causing the parser to go into the wrong state missing the first method. The next method element puts the parser back in the right state.
The fix is to not let the parser come out of the METHOD_SUMMARY if it has not seen any methods at that point.