added methods and java docs