added additional method for same usecase (keep legacy interface) using method overload
fixed javadocs