Package com.bumptech.glide.load.model.stream

Class QMediaStoreUriLoader<DataT>

java.lang.Object

com.bumptech.glide.load.model.stream.QMediaStoreUriLoader<DataT>

Type Parameters:

DataT - The type of data this loader will load (InputStream, ParcelFileDescriptor).

All Implemented Interfaces:

ModelLoader<Uri,DataT>

@RequiresApi(29)
public final class QMediaStoreUriLoader<DataT>
extends Object
implements ModelLoader<Uri,DataT>

Best effort attempt to work around various Q storage states and bugs.

In particular, HEIC images on Q cannot be decoded if they've gone through Android's exif redaction, due to a bug in the implementation that corrupts the file. To avoid the issue, we need to get at the un-redacted File. There are two ways we can do so:

• MediaStore.setRequireOriginal
• Querying for and opening the file via the underlying file path, rather than via ContentResolver

MediaStore.setRequireOriginal will only work for applications that target Q and request and currently have Manifest.permission.ACCESS_MEDIA_LOCATION. It's the simplest change to make, but it covers the fewest applications.

Querying for the file path and opening the file directly works for applications that do not target Q and for applications that do target Q but that opt in to legacy storage mode. Other options are theoretically available for applications that do not target Q, but due to other bugs, the only consistent way to get unredacted files is via the file system.

This class does not fix applications that target Q, do not opt in to legacy storage and that don't have Manifest.permission.ACCESS_MEDIA_LOCATION.

Avoid using this class directly, it may be removed in any future version of Glide.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	QMediaStoreUriLoader.FileDescriptorFactory	Factory for ParcelFileDescriptor.
static final class	QMediaStoreUriLoader.InputStreamFactory	Factory for InputStream.

Nested classes/interfaces inherited from interface com.bumptech.glide.load.model.ModelLoader

ModelLoader.LoadData<Data>

Method Summary

Modifier and Type	Method	Description
ModelLoader.LoadData<DataT>	buildLoadData(Uri uri, int width, int height, Options options)	Returns a ModelLoader.LoadData containing a DataFetcher required to decode the resource represented by this model, as well as a set of Keys that identify the data loaded by the DataFetcher as well as an optional list of alternate keys from which equivalent data can be loaded.
boolean	handles(Uri uri)	Returns true if the given model is a of a recognized type that this loader can probably load.

Methods inherited from class java.lang.Object

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

Method Details

buildLoadData

public ModelLoader.LoadData<DataT> buildLoadData(@NonNull
 Uri uri,
 int width,
 int height,
 @NonNull
 Options options)

Description copied from interface: ModelLoader

Returns a ModelLoader.LoadData containing a DataFetcher required to decode the resource represented by this model, as well as a set of Keys that identify the data loaded by the DataFetcher as well as an optional list of alternate keys from which equivalent data can be loaded. The DataFetcher will not be used if the resource is already cached.

Note - If no valid data fetcher can be returned (for example if a model has a null URL), then it is acceptable to return a null data fetcher from this method.

Specified by:

buildLoadData in interface ModelLoader<Uri,DataT>

Parameters:

uri - The model representing the resource.

width - The width in pixels of the view or target the resource will be loaded into, or Target.SIZE_ORIGINAL to indicate that the resource should be loaded at its original width.

height - The height in pixels of the view or target the resource will be loaded into, or Target.SIZE_ORIGINAL to indicate that the resource should be loaded at its original height.

handles

public boolean handles(@NonNull
 Uri uri)

Description copied from interface: ModelLoader

Returns true if the given model is a of a recognized type that this loader can probably load.

For example, you may want multiple Uri to InputStream loaders. One might handle media store Uris, another might handle asset Uris, and a third might handle file Uris etc.

This method is generally expected to do no I/O and complete quickly, so best effort results are acceptable. ModelLoaders that return true from this method may return null from ModelLoader.buildLoadData(Object, int, int, Options)

Specified by:

handles in interface ModelLoader<Uri,DataT>