Added javadoc

Hopefully that's a good start... 
"any further upon" -> "any further until" ?
what about the CacheAccessException ? we could explain why it would be thrown, such as : 
"@CacheAccessException if the store couldn't be closed, i.e. the local transient memory couldn't be released."