Added javadoc

Hopefully that's a good start... 
It certainly feels weird that it would throw a cache "access" exception.