improved comments on BeanHandler class methods