Improve Java Json documentation
Merge pull request #3143 from gmethvin/java-json-docs

Improve Java Json documentation