public interface ApplicationStateProvider
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.
Modifier and Type | Method and Description |
---|---|
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. |
void saveState(HashStructure data)
data
hash structure.
Changes made to the data
hash structure after this method call
returns will not have any effect on the saved state.
data
- the hash structure in which to store state. This will never be
null
.void restoreState(HashStructure data)
data
hash structure.
The data
hash structure should be considered immutable. Writing
to the structure will result in an UnsupportedOperationException
.
data
- the hash structure from which to read state. This will never
be null
.