Package com.google.api.client.util.store
Interface DataStore<V extends Serializable>
-
- Type Parameters:
V
- serializable type of the mapped value
- All Known Implementing Classes:
AbstractDataStore
public interface DataStore<V extends Serializable>
Stores and manages serializable data of a specific type, where the key is a string and the value is aSerializable
object.null
keys or values are not allowed. Implementation should be thread-safe.- Since:
- 1.16
- Author:
- Yaniv Inbar
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description DataStore<V>
clear()
Deletes all of the stored keys and values.boolean
containsKey(String key)
Returns whether the store contains the given key.boolean
containsValue(V value)
Returns whether the store contains the given value.DataStore<V>
delete(String key)
Deletes the stored key and value based on the given key, or ignored if the key doesn't already exist.V
get(String key)
Returns the stored value for the given key ornull
if not found.DataStoreFactory
getDataStoreFactory()
Returns the data store factory.String
getId()
Returns the data store ID.boolean
isEmpty()
Returns whether there are any stored keys.Set<String>
keySet()
Returns the unmodifiable set of all stored keys.DataStore<V>
set(String key, V value)
Stores the given value for the given key (replacing any existing value).int
size()
Returns the number of stored keys.Collection<V>
values()
Returns the unmodifiable collection of all stored values.
-
-
-
Method Detail
-
getDataStoreFactory
DataStoreFactory getDataStoreFactory()
Returns the data store factory.
-
getId
String getId()
Returns the data store ID.
-
size
int size() throws IOException
Returns the number of stored keys.- Throws:
IOException
-
isEmpty
boolean isEmpty() throws IOException
Returns whether there are any stored keys.- Throws:
IOException
-
containsKey
boolean containsKey(String key) throws IOException
Returns whether the store contains the given key.- Throws:
IOException
-
containsValue
boolean containsValue(V value) throws IOException
Returns whether the store contains the given value.- Throws:
IOException
-
keySet
Set<String> keySet() throws IOException
Returns the unmodifiable set of all stored keys.Order of the keys is not specified.
- Throws:
IOException
-
values
Collection<V> values() throws IOException
Returns the unmodifiable collection of all stored values.- Throws:
IOException
-
get
V get(String key) throws IOException
Returns the stored value for the given key ornull
if not found.- Parameters:
key
- key ornull
fornull
result- Throws:
IOException
-
set
DataStore<V> set(String key, V value) throws IOException
Stores the given value for the given key (replacing any existing value).- Parameters:
key
- keyvalue
- value object- Throws:
IOException
-
clear
DataStore<V> clear() throws IOException
Deletes all of the stored keys and values.- Throws:
IOException
-
delete
DataStore<V> delete(String key) throws IOException
Deletes the stored key and value based on the given key, or ignored if the key doesn't already exist.- Parameters:
key
- key ornull
to ignore- Throws:
IOException
-
-