I got it down to :
my question can be simplified to "how do I set a timeout on a controller method that returns a Promise", yet another place where the Java documentation seems inferior to the Scala docs.. The Scala docs show how to do it, but the Java ones don't. How do I do Future.firstCompletedOf in Java? And why, oh why does the java docs suck so much?
It's a real pain to read the java docs, then, much later realise there is considerably more info in the scala ones, and no way to tell how to do the scala difference in java. I find this happening over and over..
I've tried poking around in the Future api, and can see the scala class with it (scala.concurrent.Future), but I'm very new to scala, and don't know how (if at all), I can call this method from Java?