Deleted unwanted methods, added Javadoc to the ones we keep

May want to check the javadoc there... It's probably less than ideal. Maybe we should pull in the docs team on that?
Also, review the comments on the `Cache` interface... am unsure about some methods there
Do we want to keep this? Rename this? I guess there needs to be a way to clear a cache...