Java controller methods need to return Promise<Result> not Promise<SimpleResult>

Updated docs and added test to verify behaviour.
Merge pull request #1798 from richdougherty/promise-result

Bad return type in Java async example