com.apollographql.apollo

Class ApolloClient

java.lang.Object

com.apollographql.apollo.ApolloClient

All Implemented Interfaces:

ApolloMutationCall.Factory, ApolloPrefetch.Factory, ApolloQueryCall.Factory, ApolloSubscriptionCall.Factory

public final class ApolloClient
extends java.lang.Object
implements ApolloQueryCall.Factory, ApolloMutationCall.Factory, ApolloPrefetch.Factory, ApolloSubscriptionCall.Factory

ApolloClient class represents the abstraction for the graphQL client that will be used to execute queries and read the responses back.

ApolloClient should be shared

Since each ApolloClient holds its own connection pool and thread pool, it is recommended to only create a single ApolloClient and use that for execution of all the queries, as this would reduce latency and would also save memory. Conversely, creating a client for each query execution would result in resource wastage on idle pools.

See the ApolloClient.Builder class for configuring the ApolloClient.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ApolloClient.Builder

Method Summary

Modifier and Type	Method and Description
int	activeCallsCount() Returns the count of ApolloCall & ApolloPrefetch objects which are currently in progress.
void	addOnSubscriptionManagerStateChangeListener(OnSubscriptionManagerStateChangeListener onStateChangeListener) Adds new listener for subscription manager state changes.
ApolloStore	apolloStore()
static ApolloClient.Builder	builder()
void	clearHttpCache() Clear all entries from the HttpCache, if present.
boolean	clearNormalizedCache() Clear all entries from the normalized cache.
void	clearNormalizedCache(ApolloStoreOperation.Callback<java.lang.Boolean> callback) Clear all entries from the normalized cache.
CacheHeaders	defaultCacheHeaders()
void	disableSubscriptions() Call stop on the subscriptionManager.
void	enableSubscriptions() Call start on the subscriptionManager.
SubscriptionManager	getSubscriptionManager()
SubscriptionManagerState	getSubscriptionManagerState() Returns the current state of subscription manager.
void	idleCallback(IdleResourceCallback idleResourceCallback) Sets the idleResourceCallback which will be called when this ApolloClient is idle.
<D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloMutationCall<T>	mutate(com.apollographql.apollo.api.Mutation<D,T,V> mutation) Creates and prepares a new ApolloMutationCall call.
<D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloMutationCall<T>	mutate(com.apollographql.apollo.api.Mutation<D,T,V> mutation, D withOptimisticUpdates) Creates and prepares a new ApolloMutationCall call with optimistic updates.
<D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloPrefetch	prefetch(com.apollographql.apollo.api.Operation<D,T,V> operation) Creates the ApolloPrefetch by wrapping the operation object inside.
<D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloQueryCall<T>	query(com.apollographql.apollo.api.Query<D,T,V> query) Creates and prepares a new ApolloQueryCall call.
void	removeOnSubscriptionManagerStateChangeListener(OnSubscriptionManagerStateChangeListener onStateChangeListener) Removes listener for subscription manager state changes.
<D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloSubscriptionCall<T>	subscribe(com.apollographql.apollo.api.Subscription<D,T,V> subscription) Creates and prepares a new ApolloSubscriptionCall call.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static ApolloClient.Builder builder()

mutate

public <D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloMutationCall<T> mutate(@NotNull
                                                                                                                                                         com.apollographql.apollo.api.Mutation<D,T,V> mutation)

Description copied from interface: ApolloMutationCall.Factory

Creates and prepares a new ApolloMutationCall call.

Specified by:

mutate in interface ApolloMutationCall.Factory

Parameters:

mutation - the Mutation which needs to be performed

Returns:

prepared ApolloMutationCall call to be executed at some point in the future

mutate

public <D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloMutationCall<T> mutate(@NotNull
                                                                                                                                                         com.apollographql.apollo.api.Mutation<D,T,V> mutation,
                                                                                                                                                         @NotNull
                                                                                                                                                         D withOptimisticUpdates)

Description copied from interface: ApolloMutationCall.Factory

Creates and prepares a new ApolloMutationCall call with optimistic updates.

Provided optimistic updates will be stored in ApolloStore immediately before mutation execution. Any ApolloQueryWatcher dependent on the changed cache records will be re-fetched.

Specified by:

mutate in interface ApolloMutationCall.Factory

Parameters:

mutation - the Mutation which needs to be performed

withOptimisticUpdates - optimistic updates for this mutation

Returns:

prepared ApolloMutationCall call to be executed at some point in the future

query

public <D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloQueryCall<T> query(@NotNull
                                                                                                                                                     com.apollographql.apollo.api.Query<D,T,V> query)

Description copied from interface: ApolloQueryCall.Factory

Creates and prepares a new ApolloQueryCall call.

Specified by:

query in interface ApolloQueryCall.Factory

Parameters:

query - the operation which needs to be performed

Returns:

prepared ApolloQueryCall call to be executed at some point in the future

prefetch

public <D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloPrefetch prefetch(@NotNull
                                                                                                                                                    com.apollographql.apollo.api.Operation<D,T,V> operation)

Description copied from interface: ApolloPrefetch.Factory

Creates the ApolloPrefetch by wrapping the operation object inside.

Specified by:

prefetch in interface ApolloPrefetch.Factory

Parameters:

operation - the operation which needs to be performed

Returns:

The ApolloPrefetch object with the wrapped operation object

subscribe

public <D extends com.apollographql.apollo.api.Operation.Data,T,V extends com.apollographql.apollo.api.Operation.Variables> ApolloSubscriptionCall<T> subscribe(@NotNull
                                                                                                                                                                com.apollographql.apollo.api.Subscription<D,T,V> subscription)

Description copied from interface: ApolloSubscriptionCall.Factory

Creates and prepares a new ApolloSubscriptionCall call.

Specified by:

subscribe in interface ApolloSubscriptionCall.Factory

Parameters:

subscription - to be sent to the subscription server to start listening pushed updates

Returns:

prepared ApolloSubscriptionCall call to be executed

addOnSubscriptionManagerStateChangeListener

public void addOnSubscriptionManagerStateChangeListener(@NotNull
                                                        OnSubscriptionManagerStateChangeListener onStateChangeListener)

Adds new listener for subscription manager state changes.

Parameters:

onStateChangeListener - to be called when state changed

removeOnSubscriptionManagerStateChangeListener

public void removeOnSubscriptionManagerStateChangeListener(@NotNull
                                                           OnSubscriptionManagerStateChangeListener onStateChangeListener)

Removes listener for subscription manager state changes.

Parameters:

onStateChangeListener - to remove

getSubscriptionManagerState

public SubscriptionManagerState getSubscriptionManagerState()

Returns the current state of subscription manager.

Returns:

current state

getSubscriptionManager

public SubscriptionManager getSubscriptionManager()

enableSubscriptions

public void enableSubscriptions()

Call start on the subscriptionManager. Which will put the subscriptionManager in a connectible state if its current state is STOPPED. This is a noop if the current state is anything other than STOPPED.

When subscriptions are re-enabled after having been disabled, the underlying transport isn't reconnected immediately, but will be on the first new subscription created.

disableSubscriptions

public void disableSubscriptions()

Call stop on the subscriptionManager. Which will unsubscribe from all active subscriptions, disconnect the underlying transport (eg websocket), and put the subscriptionManager in the STOPPED state.

New subscriptions will fail until enableSubscriptions() is called.

defaultCacheHeaders

public CacheHeaders defaultCacheHeaders()

Returns:

The default CacheHeaders which this instance of ApolloClient was configured.

clearHttpCache

public void clearHttpCache()

Clear all entries from the HttpCache, if present.

clearNormalizedCache

public void clearNormalizedCache(@NotNull
                                 ApolloStoreOperation.Callback<java.lang.Boolean> callback)

Clear all entries from the normalized cache. This is asynchronous operation and will be scheduled on the dispatcher

Parameters:

callback - to be notified when operation is completed

clearNormalizedCache

public boolean clearNormalizedCache()

Clear all entries from the normalized cache. This is synchronous operation and will be executed int the current thread

Returns:

true if operation succeed, false otherwise

apolloStore

public ApolloStore apolloStore()

Returns:

The ApolloStore managing access to the normalized cache created by ApolloClient.Builder.normalizedCache(NormalizedCacheFactory, CacheKeyResolver) }

idleCallback

public void idleCallback(IdleResourceCallback idleResourceCallback)

Sets the idleResourceCallback which will be called when this ApolloClient is idle.

activeCallsCount

public int activeCallsCount()

Returns the count of ApolloCall & ApolloPrefetch objects which are currently in progress.