providing test coverage and javadoc