com.google.api.client.extensions.appengine.datastore

Class AppEngineDataStoreFactory

java.lang.Object

com.google.api.client.util.store.AbstractDataStoreFactory

com.google.api.client.extensions.appengine.datastore.AppEngineDataStoreFactory

All Implemented Interfaces:

DataStoreFactory

public class AppEngineDataStoreFactory
extends AbstractDataStoreFactory

Thread-safe Google App Engine implementation of a data store factory that directly uses the App Engine Data Store API.

For convenience, a default global instance is provided in getDefaultInstance().

By default, it uses the Memcache API as an in-memory data cache. To disable it, call AppEngineDataStoreFactory.Builder.setDisableMemcache(boolean). The Memcache is only read to check if a key already has a value inside DataStore.get(String). The values in the Memcache are updated in the DataStore.get(String), DataStore.set(String, Serializable), DataStore.delete(String), DataStore.values(), and DataStore.clear() methods.

Since:

1.16

Author:

Yaniv Inbar

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AppEngineDataStoreFactory.Builder App Engine data store factory builder.

Constructor Summary

Constructors

Constructor and Description
AppEngineDataStoreFactory()
AppEngineDataStoreFactory(AppEngineDataStoreFactory.Builder builder)

Method Summary

Modifier and Type	Method and Description
protected <V extends Serializable> DataStore<V>	createDataStore(String id) Returns a new instance of a type-specific data store based on the given unique ID.
static AppEngineDataStoreFactory	getDefaultInstance() Returns a global thread-safe instance based on the default constructor AppEngineDataStoreFactory().
boolean	getDisableMemcache() Returns whether to disable the memcache (which is enabled by default).

Methods inherited from class com.google.api.client.util.store.AbstractDataStoreFactory

getDataStore

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AppEngineDataStoreFactory

public AppEngineDataStoreFactory()

AppEngineDataStoreFactory

public AppEngineDataStoreFactory(AppEngineDataStoreFactory.Builder builder)

Parameters:

builder - builder

Method Detail

createDataStore

protected <V extends Serializable> DataStore<V> createDataStore(String id)
                                                         throws IOException

Description copied from class: AbstractDataStoreFactory

Returns a new instance of a type-specific data store based on the given unique ID.

The DataStore.getId() must match the id parameter from this method.

Specified by:

createDataStore in class AbstractDataStoreFactory

Type Parameters:

V - serializable type of the mapped value

Parameters:

id - unique ID to refer to typed data store

Throws:

IOException

getDisableMemcache

public boolean getDisableMemcache()

Returns whether to disable the memcache (which is enabled by default).

getDefaultInstance

public static AppEngineDataStoreFactory getDefaultInstance()

Returns a global thread-safe instance based on the default constructor AppEngineDataStoreFactory().