Constructor Detail

• PriorityNetworkFetcher

  PriorityNetworkFetcher(NetworkFetcher<FETCH_STATE> delegate, boolean isHiPriFifo, int maxOutstandingHiPri, int maxOutstandingLowPri, boolean inflightFetchesCanBeCancelled, int maxNumberOfRequeue, boolean doNotCancelRequests, int immediateRequeueCount, int requeueDelayTimeInMillis, boolean multipleDequeue, boolean nonRecoverableExceptionPreventsRequeue, int maxConnectAttemptCount, int maxAttemptCount, boolean retryLowPriAll, boolean retryLowPriUnknownHostException, boolean retryLowPriConnectionException)

  Parameters:

  isHiPriFifo - if true, hi-pri requests are dequeued in the order they were enqueued.Otherwise, they're dequeued in reverse order.

  inflightFetchesCanBeCancelled - if false, the fetcher waits for the completion of requeststhat have been delegated to 'delegate' even if they were cancelled by Fresco.

  maxNumberOfRequeue - requests that fail are re-queued up to maxNumberOfRequeue times,potentially retrying immediately.

  doNotCancelRequests - if true, requests will not be removed from the queue on cancellation

  immediateRequeueCount - number of immediate requeue attempts, when a request is re-queuedmore then this number, it will get re-queued again after at most requeueDelayTimeInMillis.NO_DELAYED_REQUESTS(-1) means no delay, no matter how many times the request is re-queued.

  requeueDelayTimeInMillis - the amount of time in ms a request needs to wait until gettingre-queued again after it gets re-queued more than immediateRequeueCount times.

• PriorityNetworkFetcher

  PriorityNetworkFetcher(NetworkFetcher<FETCH_STATE> delegate, boolean isHiPriFifo, int maxOutstandingHiPri, int maxOutstandingLowPri, boolean inflightFetchesCanBeCancelled, int maxNumberOfRequeue, boolean doNotCancelRequests, int immediateRequeueCount, int requeueDelayTimeInMillis, boolean multipleDequeue, boolean nonRecoverableExceptionPreventsRequeue, int maxConnectAttemptCount, int maxAttemptCount, boolean retryLowPriAll, boolean retryLowPriUnknownHostException, boolean retryLowPriConnectionException, MonotonicClock clock)

Method Detail

• pause

   void pause()

  Stop dequeuing requests until resume is called.

• resume

   void resume()

  Resume dequeuing requests.

  Note: a request is immediately dequeued and the delegate's fetch() method is called usingthe current thread.

• fetch

   void fetch(PriorityNetworkFetcher.PriorityFetchState<FETCH_STATE> fetchState, NetworkFetcher.Callback callback)

  Initiates the network fetch and informs the producer when a response is received via theprovided callback.

  Parameters:

  fetchState - the fetch-specific state

  callback - the callback used to inform the network fetch producer

• onFetchCompletion

   void onFetchCompletion(PriorityNetworkFetcher.PriorityFetchState<FETCH_STATE> fetchState, int byteSize)

  Called after the fetch completes.

  Implementing this method is optional and is useful for instrumentation purposes.

  Parameters:

  fetchState - the fetch-specific state

  byteSize - size of the data in bytes

• createFetchState

   PriorityNetworkFetcher.PriorityFetchState<FETCH_STATE> createFetchState(Consumer<EncodedImage> consumer, ProducerContext producerContext)

  Creates a new instance of the FetchState-derived object used to store state.

  Parameters:

  consumer - the consumer

  producerContext - the producer's context

• shouldPropagate

   boolean shouldPropagate(PriorityNetworkFetcher.PriorityFetchState<FETCH_STATE> fetchState)

  Gets whether the intermediate results should be propagated.

  In addition to the requirements of this method, intermediate results are throttled sothat a maximum of one every 100 ms is propagated. This is to conserve CPU and other resources.

  Not applicable if progressive rendering is disabled or not supported for this image.

  Parameters:

  fetchState - the fetch-specific state

• getExtraMap

  @Nullable() Map<String, String> getExtraMap(PriorityNetworkFetcher.PriorityFetchState<FETCH_STATE> fetchState, int byteSize)

  Gets a map containing extra parameters to pass to the listeners.

  Returning map is optional and is useful for instrumentation purposes.

  This map won't be modified by the caller.

  Parameters:

  fetchState - the fetch-specific state

  byteSize - size of the data in bytes

• shouldRetry

   static boolean shouldRetry(Throwable e, int attemptNumber, int maxConnectAttemptCount, int maxAttemptCount, boolean retryLowPriAll, boolean retryLowPriUnknownHostException, boolean retryLowPriConnectionException, Priority priority)