Fetches the entire state for this cache from secondary storage (disk, database) and writes it to a provided ObjectOutputStream. State written to the provided ObjectOutputStream parameter is used for initialization of a new CacheImpl instance. When the state gets transferred to the new cache instance its cacheloader calls {@link #storeEntireState(ObjectInputStream)}
Implementations of this method should not catch any exception or close the given ObjectOutputStream parameter. In order to ensure cacheloader interoperability contents of the cache are written to the ObjectOutputStream as a sequence of NodeData objects.
Default implementation is provided by {@link AbstractCacheLoader} and ensures cacheloaderinteroperability. Implementors are encouraged to consider extending AbstractCacheLoader prior to implementing completely custom cacheloader.
@param os ObjectOutputStream to write state
@see AbstractCacheLoader#loadEntireState(ObjectOutputStream)
@see org.jboss.cache.marshall.NodeData