Added javadoc

Hopefully that's a good start... 
Sure - makes sense.  Just ftr my understanding would be that if hasNext returns true, then next should not throw NoSuchElementException, but could still throw CacheAccessException.  Does that make sense?