add a some javadoc to the buildUrl method