public class

RequestLoggingListener

extends Object
implements RequestListener
java.lang.Object
   ↳ com.facebook.imagepipeline.listener.RequestLoggingListener

Class Overview

Logging for ImageRequests.

Summary

Public Constructors
RequestLoggingListener()
Public Methods
synchronized void onProducerEvent(String requestId, String producerName, String producerEventName)
Called whenever an important producer-specific event occurs.
synchronized void onProducerFinishWithCancellation(String requestId, String producerName, Map<String, String> extraMap)
Called once when producer finishes due to cancellation.
synchronized void onProducerFinishWithFailure(String requestId, String producerName, Throwable throwable, Map<String, String> extraMap)
Called when producer finishes processing current unit of work due to an error.
synchronized void onProducerFinishWithSuccess(String requestId, String producerName, Map<String, String> extraMap)
Called when a producer successfully finishes processing current unit of work.
synchronized void onProducerStart(String requestId, String producerName)
Called whenever a producer starts processing unit of work.
synchronized void onRequestCancellation(String requestId)
Called after the request is cancelled.
synchronized void onRequestFailure(ImageRequest request, String requestId, Throwable throwable, boolean isPrefetch)
Called after failure to complete the request (some producer failed).
synchronized void onRequestStart(ImageRequest request, Object callerContextObject, String requestId, boolean isPrefetch)
Called when request is about to be submitted to the Orchestrator's executor queue.
synchronized void onRequestSuccess(ImageRequest request, String requestId, boolean isPrefetch)
Called after successful completion of the request (all producers completed successfully).
synchronized void onUltimateProducerReached(String requestId, String producerName, boolean successful)
Called when the producer which can create the final result for a given request has completed.
boolean requiresExtraMap(String id)
[Expand]
Inherited Methods
From class java.lang.Object
From interface com.facebook.imagepipeline.listener.RequestListener
From interface com.facebook.imagepipeline.producers.ProducerListener

Public Constructors

public RequestLoggingListener ()

Public Methods

public synchronized void onProducerEvent (String requestId, String producerName, String producerEventName)

Called whenever an important producer-specific event occurs. This may only be called if onProducerStart has been called, but corresponding onProducerFinishWith* method has not been called yet.

public synchronized void onProducerFinishWithCancellation (String requestId, String producerName, Map<String, String> extraMap)

Called once when producer finishes due to cancellation.

Parameters
extraMap Additional parameters about the producer. This map is immutable and will throw an exception if attempts are made to modify it.

public synchronized void onProducerFinishWithFailure (String requestId, String producerName, Throwable throwable, Map<String, String> extraMap)

Called when producer finishes processing current unit of work due to an error.

Parameters
extraMap Additional parameters about the producer. This map is immutable and will throw an exception if attempts are made to modify it.

public synchronized void onProducerFinishWithSuccess (String requestId, String producerName, Map<String, String> extraMap)

Called when a producer successfully finishes processing current unit of work.

Parameters
extraMap Additional parameters about the producer. This map is immutable and will throw an exception if attempts are made to modify it.

public synchronized void onProducerStart (String requestId, String producerName)

Called whenever a producer starts processing unit of work. This method might be called multiple times, but between any two consecutive calls to onProducerStart onProducerFinishWithSuccess will be called exactly once.

public synchronized void onRequestCancellation (String requestId)

Called after the request is cancelled.

Parameters
requestId unique id generated automatically for each request submission

public synchronized void onRequestFailure (ImageRequest request, String requestId, Throwable throwable, boolean isPrefetch)

Called after failure to complete the request (some producer failed).

Parameters
request which triggered the event
requestId unique id generated automatically for each request submission
throwable cause of failure
isPrefetch whether the request is a prefetch or not

public synchronized void onRequestStart (ImageRequest request, Object callerContextObject, String requestId, boolean isPrefetch)

Called when request is about to be submitted to the Orchestrator's executor queue.

Parameters
request which triggered the event
callerContextObject context of the caller of the request
requestId unique id generated automatically for each request submission
isPrefetch whether the request is a prefetch or not

public synchronized void onRequestSuccess (ImageRequest request, String requestId, boolean isPrefetch)

Called after successful completion of the request (all producers completed successfully).

Parameters
request which triggered the event
requestId unique id generated automatically for each request submission
isPrefetch whether the request is a prefetch or not

public synchronized void onUltimateProducerReached (String requestId, String producerName, boolean successful)

Called when the producer which can create the final result for a given request has completed.

This can be used to determine which producer was best able to satisfy the request.

public boolean requiresExtraMap (String id)