com.bumptech.glide.load.data
Class MediaStoreThumbFetcher

java.lang.Object
  extended by com.bumptech.glide.load.data.MediaStoreThumbFetcher
All Implemented Interfaces:
DataFetcher<InputStream>

public class MediaStoreThumbFetcher
extends Object
implements DataFetcher<InputStream>

A DataFetcher that retrieves an InputStream for a local Uri that may or may not be for a resource in the media store. If the local Uri is for a resource in the media store and the size requested is less than or equal to the media store thumbnail size, preferentially attempts to fetch data for the pre-generated media store thumbs using MediaStore.Images.Thumbnails and MediaStore.Video.Thumbnails.


Constructor Summary
MediaStoreThumbFetcher(Context context, Uri mediaStoreUri, DataFetcher<InputStream> defaultFetcher, int width, int height)
           
 
Method Summary
 void cancel()
          A method that will be called when a load is no longer relevant and has been cancelled.
 void cleanup()
          Cleanup or recycle any resources used by this data fetcher.
 String getId()
          Returns a string uniquely identifying the data that this fetcher will fetch including the specific size.
 InputStream loadData(Priority priority)
          Asynchronously fetch data from which a resource can be decoded.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

MediaStoreThumbFetcher

public MediaStoreThumbFetcher(Context context,
                              Uri mediaStoreUri,
                              DataFetcher<InputStream> defaultFetcher,
                              int width,
                              int height)
Method Detail

loadData

public InputStream loadData(Priority priority)
                     throws Exception
Description copied from interface: DataFetcher
Asynchronously fetch data from which a resource can be decoded. This will always be called on background thread so it is safe to perform long running tasks here. Any third party libraries called must be thread safe since this method will be called from a thread in a ExecutorService that may have more than one background thread. This method will only be called when the corresponding resource is not in the cache.

Note - this method will be run on a background thread so blocking I/O is safe.

Specified by:
loadData in interface DataFetcher<InputStream>
Parameters:
priority - The priority with which the request should be completed.
Throws:
Exception
See Also:
where the data retuned will be cleaned up

cleanup

public void cleanup()
Description copied from interface: DataFetcher
Cleanup or recycle any resources used by this data fetcher. This method will be called in a finally block after the data returned by DataFetcher.loadData(Priority) has been decoded by the ResourceDecoder.

Note - this method will be run on a background thread so blocking I/O is safe.

Specified by:
cleanup in interface DataFetcher<InputStream>

getId

public String getId()
Description copied from interface: DataFetcher
Returns a string uniquely identifying the data that this fetcher will fetch including the specific size.

A hash of the bytes of the data that will be fetched is the ideal id but since that is in many cases impractical, urls, file paths, and uris are normally sufficient.

Note - this method will be run on the main thread so it should not perform blocking operations and should finish quickly.

Specified by:
getId in interface DataFetcher<InputStream>

cancel

public void cancel()
Description copied from interface: DataFetcher
A method that will be called when a load is no longer relevant and has been cancelled. This method does not need to guarantee that any in process loads do not finish. It also may be called before a load starts or after it finishes.

The best way to use this method is to cancel any loads that have not yet started, but allow those that are in process to finish since its we typically will want to display the same resource in a different view in the near future.

Note - this method will be run on the main thread so it should not perform blocking operations and should finish quickly.

Specified by:
cancel in interface DataFetcher<InputStream>