Enriched the Java Docs in the src/java files.

Review: https://reviews.apache.org/r/21080