tests and javadoc for reference service