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