com.apollographql.apollo.cache.normalized

Class NormalizedCache

java.lang.Object

com.apollographql.apollo.cache.normalized.NormalizedCache

Direct Known Subclasses:

LruNormalizedCache, OptimisticNormalizedCache

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()

Method Summary

Modifier and Type	Method and Description
NormalizedCache	chain(NormalizedCache cache)
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).
java.util.Set<java.lang.String>	merge(Record record, CacheHeaders cacheHeaders)
com.apollographql.apollo.api.internal.Optional<NormalizedCache>	nextCache()
protected abstract java.util.Set<java.lang.String>	performMerge(Record apolloRecord, CacheHeaders cacheHeaders)
abstract boolean	remove(CacheKey cacheKey) Remove cached record by the key

Methods inherited from class java.lang.Object

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

Constructor Detail

NormalizedCache

public NormalizedCache()

Method Detail

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 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).

performMerge

@Nonnull
protected abstract java.util.Set<java.lang.String> performMerge(@Nonnull
                                                                         Record apolloRecord,
                                                                         @Nonnull
                                                                         CacheHeaders cacheHeaders)

clearAll

public abstract void clearAll()

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

remove

public abstract boolean remove(@Nonnull
                               CacheKey cacheKey)

Remove cached record by the key

Parameters:

cacheKey - of record to be removed

Returns:

true if record with such key was successfully removed, false otherwise

chain

public final NormalizedCache chain(@Nonnull
                                   NormalizedCache cache)

nextCache

public final com.apollographql.apollo.api.internal.Optional<NormalizedCache> nextCache()