KER-242 : Java API - Improve the javadoc