MalformedParametersException should receive a @since tag.

Additionally, the javadoc doesn't describe what it means for a parameter to
be malformed. The answer doesn't need to be exhaustive, but I think some
examples would help developers if they catch one and need to dig into class
files. Or if there's a reference point to the JLS, that would be good too.

Here's a good sample from Eric:
http://mail.openjdk.java.net/pipermail/enhanced-metadata-spec-discuss/2013-August/000242.html

PS: I think the consistent exception hierarchy for reflective operations
should remain in tact. Although it's annoying checked exceptions exist, my
preference would be to extend from ReflectiveOperationException rather than
RuntimeException.

-- 
Cheers,
Paul

Reply via email to