KER-241 : Java API - Improve the javadoc

KER-241 : Java API - Improve the javadoc