I would like to draw you attention to vertx[1] its an eclipse project with well thought out API's and documentation and no magic.

[1]https://vertx.io/