Half-sync half-async:
- README: example
- java doc and code clean-up