oracle.ide.appstate
Interface ApplicationStateProvider

public interface ApplicationStateProvider

An ApplicationStateProvider knows how to save and restore state in the running application.

Thread Safety: Implementations of this interface should not assume they are invoked on any particular thread, and must take steps to ensure thread safety. However, serialization in ApplicationStateManager ensures that the saveState(HashStructure) and restoreState(HashStructure) methods will always be serialized.

Method Summary

void	restoreState(HashStructure data) Requests that the provider restore state from data in the data hash structure.
void	saveState(HashStructure data) Requests that the provider save state in the data hash structure.

Method Detail

saveState

void saveState(HashStructure data)

Requests that the provider save state in the data hash structure.

Changes made to the data hash structure after this method call returns will not have any effect on the saved state.

Parameters:

data - the hash structure in which to store state. This will never be null.

restoreState

void restoreState(HashStructure data)

Requests that the provider restore state from data in the data hash structure.

The data hash structure should be considered immutable. Writing to the structure will result in an UnsupportedOperationException.

Parameters:

data - the hash structure from which to read state. This will never be null.