(TK-117) Add javadoc strings

Add javadoc strings to each of the user-facing Java classes, and
reference those javadoc strings in the documentation on the
Java client.