JCR-2150 : Java API - Improve the javadoc

JCR-2150 : Java API - Improve the javadoc