Model
- The type of Model that we can retrieve data for, e.g. String
.Data
- The type of data that can be opened, e.g. InputStream
.public final class DataUrlLoader<Model,Data> extends java.lang.Object implements ModelLoader<Model,Data>
Data URIs use the "data" scheme.
See http://www.ietf.org/rfc/rfc2397.txt for a complete description of the 'data' URL scheme.
Briefly, a 'data' URL has the form:
data:[mediatype][;base64],some_data
Modifier and Type | Class and Description |
---|---|
static interface |
DataUrlLoader.DataDecoder<Data>
Allows decoding a specific type of data from a Data URL String.
|
static class |
DataUrlLoader.StreamFactory<Model>
Factory for loading
InputStream s from data uris. |
ModelLoader.LoadData<Data>
Constructor and Description |
---|
DataUrlLoader(DataUrlLoader.DataDecoder<Data> dataDecoder) |
Modifier and Type | Method and Description |
---|---|
ModelLoader.LoadData<Data> |
buildLoadData(Model model,
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(Model model)
Returns true if the given model is a of a recognized type that this loader can probably load.
|
public DataUrlLoader(DataUrlLoader.DataDecoder<Data> dataDecoder)
public ModelLoader.LoadData<Data> buildLoadData(@NonNull Model model, int width, int height, @NonNull Options options)
ModelLoader
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.
buildLoadData
in interface ModelLoader<Model,Data>
model
- 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.public boolean handles(@NonNull Model model)
ModelLoader
For example, you may want multiple Uri -> 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)
handles
in interface ModelLoader<Model,Data>