Added javadoc

Hopefully that's a good start... 
Isn't this a lie?  Don't we reserve the right to throw CacheAcessException on the next call?