spr41522 - improvements to java tutorial

Changes to make statements clearer, and other changes. There
are more suggestions in the spr which will be implemented later.

Change-Id: I891585903803b8208091540d80819265fbc08449
Reviewed-on: https://gerrit.franz.com:9080/4111
Reviewed-by: Ahmon Dancy <dancy@franz.com>
Reviewed-by: John O'Rourke <jor@franz.com>
Tested-by: Kevin Layer <layer@franz.com>