Class ResourceUriLoader<DataT>

  • Type Parameters:
    DataT - The type of data produced, e.g. InputStream or AssetFileDescriptor.
    All Implemented Interfaces:
    ModelLoader<android.net.Uri,​DataT>

    public final class ResourceUriLoader<DataT>
    extends java.lang.Object
    implements ModelLoader<android.net.Uri,​DataT>
    Converts Resource Uris to resource ids if the resource Uri points to a resource in this package.

    This class works by parsing Uris into resource ids, then delegating the resource ID load to other ModelLoaders, typically DirectResourceLoader.

    This class really shouldn't need to exist. If you need to load resources, just pass in the integer resource id directly using RequestManager.load(Integer) instead. It'll be more correct in terms of caching and more efficient to load. The only reason we're supporting this case is for backwards compatibility.

    Because this class explicitly only handles resource Uris that are from the application's package, resource uris from other packages are handled by UriLoader. UriLoader is even less preferred because it can only handle certain resources from raw resources and it will not apply appropriate theming, RTL or night mode attributes.

    • Method Detail

      • newStreamFactory

        public static ModelLoaderFactory<android.net.Uri,​java.io.InputStream> newStreamFactory​(android.content.Context context)
      • newAssetFileDescriptorFactory

        public static ModelLoaderFactory<android.net.Uri,​android.content.res.AssetFileDescriptor> newAssetFileDescriptorFactory​(android.content.Context context)
      • buildLoadData

        @Nullable
        public ModelLoader.LoadData<DataT> buildLoadData​(@NonNull
                                                         android.net.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<android.net.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
                               android.net.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<android.net.Uri,​DataT>