consistent use of refreshRequired(), added javadoc.