KER-241 : Java API - Improve the javadoc