Increase in-code documentation

[AlistairDoswald]

The in-code documentation is currently lacking. All classes should have a javadoc explaining what the class does, and what the method does. As keycloak code isn't well commented (to say the least), this module's javadoc should go a bit further than necessary to also somewhat explain the underlying keycloak classes being used.