com.apollographql.apollo.cache.normalized

Class NormalizedCache

java.lang.Object

com.apollographql.apollo.cache.normalized.NormalizedCache

Direct Known Subclasses:

LruNormalizedCache

public abstract class NormalizedCache
extends java.lang.Object

A provider of Record for reading requests from cache. To serialize a Record to a standardized form use recordAdapter() which handles call custom scalar types registered on the ApolloClient. If a NormalizedCache cannot return all the records needed to read a response, it will be considered a cache miss. A NormalizedCache is recommended to implement support for CacheHeaders specified in ApolloCacheHeaders. A NormalizedCache can choose to store records in any manner. See LruNormalizedCache for a in memory cache.

Constructor Summary

Constructors

Constructor and Description
NormalizedCache(RecordFieldAdapter recordFieldAdapter)

Method Summary

Modifier and Type	Method and Description
abstract void	clearAll() Clears all records from the cache.
abstract Record	loadRecord(java.lang.String key, CacheHeaders cacheHeaders)
java.util.Collection<Record>	loadRecords(java.util.Collection<java.lang.String> keys, CacheHeaders cacheHeaders) Calls through to loadRecord(String, CacheHeaders).
java.util.Set<java.lang.String>	merge(java.util.Collection<Record> recordSet, CacheHeaders cacheHeaders) Calls through to merge(Record, CacheHeaders).
abstract java.util.Set<java.lang.String>	merge(Record record, CacheHeaders cacheHeaders)
protected RecordFieldAdapter	recordAdapter()

Methods inherited from class java.lang.Object

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

Constructor Detail

NormalizedCache

public NormalizedCache(RecordFieldAdapter recordFieldAdapter)

Parameters:

recordFieldAdapter - An adapter which can deserialize and deserialize Record

Method Detail

recordAdapter

protected RecordFieldAdapter recordAdapter()

loadRecord

@Nullable
public abstract Record loadRecord(@Nonnull
                                            java.lang.String key,
                                            @Nonnull
                                            CacheHeaders cacheHeaders)

Parameters:

key - The key of the record to read.

cacheHeaders - The cache headers associated with the request which generated this record.

Returns:

The Record for key. If not present return null.

loadRecords

@Nonnull
public java.util.Collection<Record> loadRecords(@Nonnull
                                                         java.util.Collection<java.lang.String> keys,
                                                         @Nonnull
                                                         CacheHeaders cacheHeaders)

Calls through to loadRecord(String, CacheHeaders). Implementations should override this method if the underlying storage technology can offer an optimized manner to read multiple records.

Parameters:

keys - The set of Record keys to read.

cacheHeaders - The cache headers associated with the request which generated this record.

merge

@Nonnull
public abstract java.util.Set<java.lang.String> merge(@Nonnull
                                                               Record record,
                                                               @Nonnull
                                                               CacheHeaders cacheHeaders)

Parameters:

record - The Record to merge.

cacheHeaders - The CacheHeaders associated with the request which generated this record.

Returns:

A set of record field keys that have changed. This set is returned by Record.mergeWith(Record).

merge

@Nonnull
public java.util.Set<java.lang.String> merge(@Nonnull
                                                      java.util.Collection<Record> recordSet,
                                                      @Nonnull
                                                      CacheHeaders cacheHeaders)

Calls through to merge(Record, CacheHeaders). Implementations should override this method if the underlying storage technology can offer an optimized manner to store multiple records.

Parameters:

recordSet - The set of Records to merge.

cacheHeaders - The CacheHeaders associated with the request which generated this record.

Returns:

A set of record field keys that have changed. This set is returned by Record.mergeWith(Record).

clearAll

public abstract void clearAll()

Clears all records from the cache. Clients should call ApolloClient.clearNormalizedCache() for a thread-safe access to this method.