[SPARK-2840] [mllib] DecisionTree doc update (Java, Python examples)

Updated DecisionTree documentation, with examples for Java, Python.
Added same Java example to code as well.
CC: @mengxr  @manishamde @atalwalkar
One could also highlight that high cardinality of split candidates per feature (unique values) could slow down training without significant advantage in accuracy.