Minor cleanup in client

Mostly:
- removed some unused classes
- added javadoc
- some layout improvements
- addition of @Override
- improved exception message (try to resolve IBM JDK build problem)